Limitazione dell'utilizzo delle API

A seconda dell'API, puoi impostare un limite esplicito per le richieste limitando le richieste al giorno, le richieste al minuto o le richieste al minuto per utente.

Potresti voler limitare l'utilizzo fatturabile impostando dei limiti. Ad esempio, per evitare che ti venga fatturato l'utilizzo al di sopra dei limiti gratuiti, puoi impostare limitazioni sulle richieste al giorno.

Importante: i limiti di quota non sono sempre del tutto precisi, perché esiste un po' di latenza tra il momento in cui una quota viene superata e l'inizio dell'applicazione. Quando utilizzi la quota come strumento per limitare la fatturazione, lascia un po' di spazio di manovra.

Visualizzare e modificare i limiti per il numero di richieste

Puoi impostare limiti per tutte le richieste a qualsiasi API fatturabile. La maggior parte delle API imposta limiti predefiniti, ma puoi modificarli fino a un massimo specificato da Google. Per alcune API viene impostato un limite basso fino a quando non abiliti la fatturazione nel progetto.

Per visualizzare o modificare i limiti per la tua API, procedi nel seguente modo:

1. Nella console Google Cloud, vai alla pagina Dashboard API e servizi.

   Vai alla dashboard API e servizi

2. Seleziona un progetto dall'elenco o creane uno nuovo.
3. Fai clic sul nome dell'API che ti interessa.
4. Fai clic su Quote. Se la scheda Quote non è presente nel riquadro di navigazione delle schede, significa che l'API selezionata non ha quote definite.
5. Per trovare la quota che vuoi limitare, inserisci le proprietà e i valori appropriati nel campo Filtro. Ad esempio, per trovare la quota Subnetworks, inserisci Quota:Subnetworks.
6. Fai clic sulla casella di controllo accanto alla quota che vuoi limitare e poi su MODIFICA QUOTE.
7. Compila il modulo di modifica della quota, incluso il nuovo limite che vuoi impostare.
8. Fai clic su INVIA RICHIESTA.

Alcune API ti consentono di richiedere un limite più alto inviando un modulo. Alcune API ti consentono di specificare una quota più alta solo se la fatturazione è attivata nel progetto.

Nota: puoi impostare limiti giornalieri fatturabili solo per le API fatturabili e, in alcuni casi, solo se la fatturazione è attivata nel progetto. Se il tuo progetto non utilizza API fatturabili, non puoi impostare limiti giornalieri. Scopri di più sugli account di fatturazione.

Le sezioni relative alle quote del piano Premium si riferiscono al piano Google Maps Premium, che non è più disponibile. A meno che tu non sia un cliente con un piano Google Maps Premium attivo, non modificare queste sezioni.

Limitare le richieste per utente

Per impedire ai singoli utenti di utilizzare la quota dell'API, alcune API includono un limite predefinito per utente e per minuto.

Per verificare se la tua API include un limite predefinito per utente al minuto, cercalo nelle quote dell'API come descritto nelle istruzioni per visualizzare e modificare i limiti sul numero di richieste. Se esiste un limite predefinito per l'API, puoi modificarlo per limitare la quota disponibile per ogni utente seguendo i passaggi descritti in queste istruzioni. Se la tua API non include questo limite predefinito nelle quote, l'aggiunta o la modifica non è supportata.

I singoli utenti sono identificati da una stringa univoca. Se stai creando un'applicazione lato server (in cui il codice di chiamata è ospitato su un server di tua proprietà) che invia richieste per conto degli utenti, le richieste all'API per cui stai limitando l'utilizzo devono includere il parametro quotaUser. Questo parametro è definito nella documentazione dei parametri di sistema.

Nota: anche se i limiti per utente sono specificati in query al minuto, consentiamo picchi di utilizzo a breve termine. Pertanto, devi impostare i limiti in base ai livelli di traffico medio sostenuti. Se qualcuno tenta di utilizzare un'API in eccesso rispetto a queste impostazioni, le richieste attiveranno un errore di superamento del limite.

Per identificare un utente, utilizza il parametro di query dell'URL quotaUser=userID. Questo valore è solo per l'applicazione della quota a breve termine, quindi non è necessario utilizzare un ID utente reale. Puoi scegliere una stringa arbitraria di massimo 40 caratteri che identifichi in modo univoco un utente.

Il parametro quotaUser viene utilizzato solo per il limite di richieste per utente per minuto. Se non invii il parametro quotaUser, tutte le chiamate vengono attribuite alle tue macchine server, nel qual caso non è possibile impostare un limite per utente.

Se la tua API non include un limite predefinito per utente al minuto, i valori quotaUser vengono ignorati.

Importante: quando invii un identificatore utente, assicurati di rispettare le leggi locali, incluse le leggi relative alla divulgazione di informazioni personali che invii con ogni richiesta. È buona norma includere il minor numero possibile di informazioni personali.

Visualizzare e modificare tutte le quote per le API in un progetto

Puoi esaminare, modificare e richiedere limiti di quota più elevati per tutte le API fatturabili in un determinato progetto visualizzando la pagina Quote nella sezione IAM e amministrazione di Google Cloud Console.

Per visualizzare e modificare le quote per tutte le API fatturabili nel tuo progetto:

1. Nella console Google Cloud, vai alla pagina Quote.

   Vai a Quote

2. Seleziona un progetto dall'elenco o creane uno nuovo. Viene visualizzata la pagina Quote per il progetto selezionato, con un elenco contenente una voce per ogni tipo di quota disponibile in ciascun servizio.
3. Fai clic su Filtra tabella per eseguire una query sulla tua quota in base a una proprietà specifica.
4. Seleziona la casella accanto alle quote da modificare. Per poter selezionare alcune delle caselle di controllo, è necessario che la fatturazione sul progetto sia attivata.
   Se preferisci modificare tutte le quote per una singola API, fai clic sul nome del servizio per accedere alla pagina Quote per l'API in questione.
5. Fai clic su MODIFICA QUOTE.
6. Nel riquadro Modifiche alle quote visualizzato, espandere la visualizzazione del servizio, quindi modifica le quote nel servizio in base alle esigenze, quindi fai clic su FINE.
7. Ripeti la procedura per modificare le quote in ognuno dei servizi selezionati.
   • I limiti di quota attuali sono precompilati nelle caselle di immissione.
   • Un servizio con un'icona di avviso () al momento dell'invio presenta errori di immissione.
   • Puoi aggiungere altre quote da modificare selezionandole come descritto in precedenza.
   • Puoi rimuovere un servizio dal riquadro Modifiche alle quote passando il mouse sopra la visualizzazione del servizio non espansa e facendo clic sull'icona di eliminazione ().
8. Al termine della modifica delle quote, fai clic su AVANTI.
9. Se la richiesta di modifica della quota deve essere esaminata, viene visualizzato il modulo Dettagli di contatto. Compila il modulo con i tuoi dati di contatto.
10. Fai clic su INVIA RICHIESTA.