Limitazione dell'utilizzo delle API

A seconda dell'API, puoi limitare esplicitamente 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 i limiti. Ad esempio, per evitare che ti venga fatturato l'utilizzo oltre i limiti di utilizzo gratuito di cortesia, puoi impostare limiti giornalieri per le richieste.

Importante: i limiti di quota non sono sempre del tutto precisi, perché esiste una certa latenza tra il momento in cui viene superata una quota e il momento in cui inizia l'applicazione forzata. Quando utilizzi la quota come strumento per limitare la fatturazione, consenti un buffer.

Visualizza e modifica 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 modificarlo fino a un valore massimo specificato da Google. Per alcune API viene impostato un limite basso finché non abiliti la fatturazione nel progetto.

Per visualizzare o modificare i limiti dell'API:

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 nella navigazione delle schede, significa che per l'API selezionata non sono state definite quote.
5. Per trovare la quota che vuoi limitare, inserisci le proprietà e i valori appropriati nel campo Filtro. Ad esempio, per trovare la quota di Subnet, inserisci Quota:Subnet.
6. Fai clic sulla casella di controllo accanto alla quota di cui vuoi impostare un limite, 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 consentono di specificare una quota più alta solo se la fatturazione è abilitata per il progetto.

Nota: puoi impostare limiti giornalieri fatturabili 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 alla quota del piano premium riguardano il piano premium di Google Maps, che non è più disponibile. Se non sei un cliente attuale di un piano Google Maps Premium, non modificare queste sezioni.

Limitazione delle richieste per utente

Per impedire ai singoli utenti di esaurire 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 dell'API, come descritto nelle istruzioni per visualizzare e modificare i limiti al numero di richieste. Se esiste un limite predefinito per l'API in questione, puoi modificare il valore per limitare la quota disponibile per ogni utente seguendo la procedura descritta in queste istruzioni. Se l'API non include questo limite predefinito nelle quote, l'aggiunta o la modifica dell'API 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 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 Parametri di sistema.

Nota: sebbene i limiti per utente siano specificati in query al minuto, sono ammessi picchi di utilizzo a breve termine. Pertanto, imposta i limiti in base ai livelli di traffico medi sostenuti. Se qualcuno tenta di utilizzare un'API che supera queste impostazioni, le richieste attiveranno un errore di limite superato.

Per identificare un utente, utilizza il parametro di query dell'URL quotaUser=userID. Questo valore riguarda solo l'applicazione forzata della quota a breve termine, quindi non è necessario utilizzare un ID utente reale. Puoi scegliere qualsiasi stringa arbitraria di lunghezza inferiore a 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 ai computer server e in questo caso le chiamate non possono essere limitate dall'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 tutte le leggi locali, incluse quelle relative alla divulgazione delle informazioni personali inviate con ogni richiesta. La best practice è includere la minore quantità di informazioni personali possibile.

Visualizza e modifica 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 console Google Cloud.

Per visualizzare e modificare le quote per tutte le API fatturabili nel 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 di una voce per ogni tipo di quota disponibile in ciascun servizio.
3. Fai clic su Filtra tabella per eseguire una query sulla quota in base a una proprietà specifica.
4. Seleziona la casella accanto alle quote da modificare. Per fare clic su alcune caselle di controllo, è necessario che la fatturazione sia attivata 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 alle quote che viene visualizzato, espandi la visualizzazione del servizio, 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 sono precompilati nelle caselle di immissione.
   • Un servizio con un'icona di avviso () al momento dell'invio presenta errori di input.
   • Puoi aggiungere altre quote da modificare selezionandole come descritto prima.
   • Per rimuovere un servizio dal riquadro Modifiche alle quote, passa il mouse sopra la visualizzazione del servizio non espanso e fai clic sull'icona Elimina ().
8. Quando hai finito di modificare le quote, fai clic su AVANTI.
9. Se la richiesta di modifica della quota deve essere esaminata, viene visualizzato il modulo Informazioni di contatto. Compila il modulo con i tuoi dati di contatto.
10. Fai clic su INVIA RICHIESTA.