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.

Ti consigliamo di 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, in quanto e la latenza minima tra il superamento di una quota e l'inizio dell'applicazione. Quando usando la quota come strumento per limitare la fatturazione e consentire un certo buffering.

Visualizzare e modificare i limiti relativi al numero di richieste

Puoi impostare limiti per tutte le richieste a qualsiasi API fatturabile. La maggior parte delle API viene impostata come predefinita limiti, ma puoi modificarlo fino a un valore massimo specificato da Google. Alcune API impostano un limite basso finché abilitare la fatturazione sul tuo progetto.

Per visualizzare o modificare i limiti per l'API:

1. Nella console Google Cloud, vai al menu API e Dashboard dei servizi .

   Vai ad API e Dashboard dei 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 menu di navigazione della scheda, 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 Subnet, inserisci Quota:subnet.
6. Fai clic sulla casella di controllo accanto alla quota a cui vuoi applicare 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 superiore 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 non è possibile impostare limiti giornalieri. Scopri di più sugli account di fatturazione.

Le sezioni della quota del Piano Premium riguardano la 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 API, come descritto nelle istruzioni per Visualizzare e modificare i limiti relativi al 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 l'API non include questo limite predefinito nelle quote, aggiungi 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: sebbene i limiti per utente siano 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 un utente prova a utilizzare un'API in eccesso rispetto a 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 è solo per l'applicazione 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 includa in modo univoco. identifica 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 le chiamate non possono essere limitate dall'utente.

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

Importante: quando invii un qualsiasi identificatore utente, tieni presente assicurarsi di rispettare tutte le leggi locali, incluse le leggi relative ai divulgazione di eventuali informazioni personali inviate con ciascuna richiesta. Migliore è quella di includere il minor numero possibile di informazioni personali.

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 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 che vuoi modificare. Per fare clic su alcune delle opzioni di fatturazione del progetto è necessario che la fatturazione caselle di controllo.
   Se preferisci modificare tutte le quote per una singola API, fai clic nome del servizio per accedere alla pagina Quote per quell'API.
5. Clic MODIFICA QUOTE.
6. Nel riquadro Modifiche delle quote visualizzato, espandi la vista del servizio, quindi modifica le quote del servizio in base alle tue 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.
   • Per rimuovere un servizio dal riquadro Modifiche delle quote, passa il mouse la visualizzazione non espansa del servizio, quindi fai clic elimina ().
8. Quando hai terminato di modificare le quote, fai clic su AVANTI.
9. Se la tua richiesta di modifica della quota deve essere esaminata, usa il modulo Dati di contatto vengono visualizzati i video. Compila il modulo con i tuoi dati di contatto.
10. Clic INVIA RICHIESTA.