Limiti di utilizzo e quote

I limiti e le quote proteggono l'infrastruttura di Google da un processo automatizzato che utilizza l'API Admin Settings in modo inappropriato. Un numero eccessivo di richieste da un'API potrebbe essere il risultato di un errore di battitura innocuo o di un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, il blocco del traffico da una fonte specifica una volta raggiunto un determinato livello è necessario per la salute generale del sistema Google Workspace. Garantisce che le azioni di uno sviluppatore non possano influire negativamente sulla community più ampia.

Nell'improbabile eventualità che la richiesta API non vada a buon fine, riceverai un codice di stato HTTP. Un codice di stato 403 contiene informazioni sull'errore relativo all'input errato, mentre un codice di stato HTTP 503 contiene informazioni sull'errore che indicano quali quote API sono state superate. Queste risposte consentono alla tua applicazione personalizzata di rilevare questi errori e intraprendere l'azione appropriata.

Se le tue richieste devono essere completate in un periodo di tempo fisso, inviale in parallelo o utilizza più thread nella tua applicazione Java o C#. Ad esempio, suddividi le richieste per mese o per un altro periodo di tempo. Nel caso dei thread, prova a iniziare con 10 thread, uno per richiesta. Tieni presente che il suggerimento relativo ai thread presenta dei compromessi e non è utile per tutte le situazioni API. Se il numero di richieste diventa troppo elevato, si verificano errori di quota.

Per tutti gli errori basati sul tempo (massimo N elementi per X secondi per thread), in particolare gli errori del codice di stato 503, ti consigliamo di fare in modo che il codice rilevi l'eccezione e, utilizzando un algoritmo di exponential backoff, attenda un breve ritardo prima di riprovare la chiamata non riuscita. Un esempio di API Email Settings per un thread consiste nell'attendere 5 secondi e riprovare la chiamata non riuscita. Se la richiesta ha esito positivo, ripeti questo pattern per gli altri thread. Se la seconda richiesta non va a buon fine, l'applicazione deve ridurre la frequenza della richiesta finché una chiamata non va a buon fine. Ad esempio, aumenta il ritardo iniziale di 5 secondi a 10 secondi e riprova a effettuare la chiamata non riuscita. Inoltre, decidi un limite di tentativi. Ad esempio, riprova a effettuare una richiesta 5-7 volte con tempi di ritardo diversi prima che l'applicazione restituisca un errore all'utente.

Categorie di quote API Quote
Token di autenticazione ClientLogin Valido per 24 ore. L'errore è "401 token scaduto".
Generazione delle chiavi pubblica e privata

Con il tuo provider di identità, genera una coppia di chiavi pubblica e privata utilizzando gli algoritmi DSA o RSA. La chiave pubblica si trova nel certificato in formato X.509. Per ulteriori informazioni sulle chiavi di firma Single Sign-On basate su SAML, vedi Generare chiavi e certificati per il servizio Single Sign-On di Google Workspace.
Logo

Il file immagine del logo di un account può essere in formato JPEG, PNG o GIF. Le dimensioni consigliate sono 143 x 59 pixel e il file deve essere inferiore a 20 kB. Quando utilizzi loghi personalizzati, ricorda di rispettare i Termini di servizio di Google. Inoltre, evita di utilizzare il logo Google, il logo di Gmail o qualsiasi altro logo di Google. Per saperne di più, consulta le norme relative a logo e pagina di destinazione.
ssoWhitelist

Un ssoWhitelist è un indirizzo IP maschera di rete in formato Classless Inter-Domain Routing (CIDR).
Altri tipi di limiti Limitazioni e linee guida
Stato della verifica del record MX

Lo stato di verifica predefinito del record MX è "false", il che significa che il sistema Google non ha controllato di recente la configurazione del record MX oppure i record MX non sono stati configurati in modo da puntare ai sistemi Google. Se hai aggiornato i tuoi record e lo stato di verifica rimane false, significa che gli aggiornamenti dei record MX non sono stati propagati o che è presente un errore di battitura nel record. Per la propagazione, ti consigliamo di attendere il periodo di tempo definito dal valore di durata (TTL) del record MX e riprovare.
Codici paese

Se il nome dell'organizzazione non è stato personalizzato, il valore predefinito è il nome del dominio principale. Per informazioni sui caratteri del nome dell'organizzazione, consulta Utilizzo dei caratteri.
Proprietà creationTime, rappresentazione numerica di date e ore

Consulta la rappresentazione numerica di date e ore in formato ISO 8601.
Tag di codifica della lingua

Consulta i tag di lingua RFC 3066 accettati da Google Mail.
Nome organizzazione

Se il nome dell'organizzazione non è stato personalizzato, il valore predefinito è il nome del dominio principale. Per informazioni sui caratteri del nome dell'organizzazione, consulta Utilizzo dei caratteri.

Richiedi un aumento della quota per progetto

A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aggiustamento della quota. Le chiamate API di un service account sono considerate come se utilizzassero un singolo account. La richiesta di una quota modificata non ne garantisce l'approvazione. L'approvazione delle richieste di aggiustamento della quota che aumenterebbero in modo significativo il valore della quota può richiedere più tempo.

Non tutti i progetti hanno le stesse quote. Man mano che utilizzi sempre più Google Cloud nel tempo, i valori delle quote potrebbero dover aumentare. Se prevedi un aumento imminente e consistente dell'utilizzo, puoi richiedere un aggiustamento della quota in modo proattivo nella pagina Quote della console Google Cloud.

Per saperne di più, consulta le seguenti risorse: