Limitazione dell'utilizzo delle API

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

Potresti voler limitare l'utilizzo fatturabile impostando dei limiti. Ad esempio, per evitare che ti venga fatturato l'utilizzo oltre i limiti di utilizzo a titolo gratuito, puoi per le richieste al giorno.

Importante: i limiti di quota non sono sempre del tutto precisi, perché esiste un certo ritardo 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. Per alcune API viene impostato un limite basso fino a quando non abiliti la fatturazione nel 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 delle schede, significa che l'API selezionata non ha quote definite.
5. Per trovare la quota a cui vuoi applicare un limite, inserisci le proprietà appropriate e valori nel 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 ti interessa. da 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 fatturabili giornalieri solo per le API fatturabili e in alcuni solo se la fatturazione è abilitata nel tuo progetto. Se il tuo progetto non utilizza non è possibile 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 abbia già un piano Google Maps Premium cliente, non modificare queste sezioni.

Limitare le richieste per utente

Per impedire a 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 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 ciascun utente seguendo la procedura descritta 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 un'applicazione lato server (dove il codice chiamante è ospitato su un server che invia richieste per conto degli utenti, le tue richieste all'API che per il quale stai limitando l'utilizzo deve 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 riguarda l'applicazione forzata della quota a breve termine, quindi non devi usare ID. 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 limitare le richieste per utente in base al 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 l'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 di una voce per ciascun tipo di quota disponibile in ciascun servizio.
3. Fai clic su Filtra tabella per la quota in base a una proprietà specifica.
4. Seleziona la casella accanto alle quote che vuoi 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 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.
   • Gli attuali limiti di quota sono precompilati nelle caselle di immissione.
   • Un servizio con un'icona di avviso () all'invio presenta errori di input.
   • 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.