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 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, 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 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 menu di navigazione della scheda, 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 Le API ti consentono di specificare una quota più alta solo se la fatturazione sia abilitata per il 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 abbia già un piano Google Maps Premium cliente, 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 per il 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 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 è definita nella documentazione relativa ai 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 livelli di traffico medi 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 riguarda l'applicazione forzata della quota a breve termine, quindi non devi usare ID. Puoi scegliere una stringa arbitraria di massimo 40 caratteri che identifichi in modo univoco 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 non è possibile impostare un limite per 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. È buona norma includere il minor numero possibile di informazioni personali.

Visualizza e modifica tutte le quote per le API in un progetto

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

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 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.
   • Gli attuali limiti di quota 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 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. Fai clic su INVIA RICHIESTA.