Limitazione dell'utilizzo delle API

A seconda dell'API, puoi limitare esplicitamente le richieste impostando un limite per le richieste al giorno, richieste al minuto o le richieste al minuto per utente.

Questi sono limiti di utilizzo specifici per l'API. Ad esempio, per evitare addebiti per il superamento dell'utilizzo senza costi, puoi impostare limiti per le richieste al giorno.

Questi limiti sono pensati per un controllo granulare dei volumi di servizi specifici e non sono progettati per fungere da limite di spesa a livello di progetto. Se vuoi evitare costi imprevisti per il tuo intero progetto o account di fatturazione, consulta Creare, modificare o eliminare budget e avvisi di budget.

Importante: i limiti di quota non sono sempre del tutto precisi, perché si verifica una certa 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, prevedi un margine di sicurezza.

Visualizzare e modificare i limiti del 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 i limiti impostati sono estremamente bassi fino a che non abiliti la fatturazione nel progetto.

Per visualizzare o modificare i limiti per l'API:

1. Nella Google Cloud console, 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 nella barra di navigazione, 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 Filtra. Ad esempio, per trovare la quota Subnet, inserisci Quota:Subnet.
6. Fai clic sulla casella di controllo accanto alla quota che vuoi limitare, quindi fai clic 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ù elevato inviando un modulo. Alcune API ti consentono di specificare una quota più elevata solo se la fatturazione è abilitata nel progetto.

Nota: puoi impostare limiti fatturabili giornalieri solo per le API fatturabili e, in alcuni casi, solo se la fatturazione è abilitata 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 Premium di Google Maps, che non è più offerto. A meno che tu non sia un cliente attuale del piano Premium di Google Maps, non modificare queste sezioni.

Limitare le richieste per utente

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

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

I singoli utenti vengono identificati da una stringa univoca. Se stai creando un'applicazione lato server (in cui il codice chiamante è ospitato su un server di tua proprietà) che effettua 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 relativa ai 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 medi sostenuti. Se qualcuno tenta di utilizzare un'API in eccesso rispetto a queste impostazioni, le richieste genereranno un errore di superamento del limite.

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

Il parametro quotaUser viene utilizzato solo per limitare le richieste per utente al minuto. Se non invii il parametro quotaUser, tutte le chiamate vengono attribuite alle macchine server, nel qual caso le chiamate non possono essere limitate per utente.

Se l'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 quelle relative alla divulgazione di informazioni personali che invii con ogni richiesta. La best practice consiste nell'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 della Google Cloud console.

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

1. Nella Google Cloud console, 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 che vuoi modificare. Per fare clic su alcune caselle di controllo, la fatturazione deve essere abilitata nel progetto.
   Se preferisci modificare tutte le quote per una singola API, fai clic sul nome del servizio per accedere alla pagina Quote per quell'API.
5. Fai clic su MODIFICA QUOTE.
6. Nel riquadro Modifiche alla quota visualizzato, espandi la visualizzazione del servizio, quindi modifica le quote nel servizio in base alle esigenze e fai clic su FINE.
7. Ripeti la procedura per modificare le quote in ognuno dei servizi selezionati.
   • I limiti di quota attuali vengono precompilati nelle caselle di input.
   • Un servizio con un'icona di avviso () al momento dell'invio presenta errori di input.
   • Puoi aggiungere altre quote da modificare selezionandole come descritto in precedenza.
   • Puoi rimuovere un servizio dal riquadro Modifiche alla quota passando il mouse sopra la visualizzazione del servizio non espansa e facendo clic sull'icona Elimina ().
8. Al termine della modifica delle quote, fai clic su AVANTI.
9. Se la tua richiesta di modifica della quota richiede una revisione, viene visualizzato il modulo Dettagli di contatto. Compila il modulo con i tuoi dati di contatto.
10. Fai clic su INVIA RICHIESTA.