I limiti e le quote proteggono l'infrastruttura Google da un processo automatizzato che utilizza l'API Admin Settings in modo inappropriato. Le richieste eccessive provenienti da un'API potrebbero derivare da un errore di battitura innocuo o da un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, è necessario bloccare il traffico proveniente da una sorgente specifica quando raggiunge un determinato livello per lo stato complessivo di Google Workspace. Questo garantisce che le azioni di uno sviluppatore non possano incidere negativamente sulla community più ampia.
Nell'improbabile caso che la tua richiesta API non vada a buon fine, riceverai una risposta di codice di stato HTTP. Un codice di stato 403 contiene informazioni sugli errori relativi a un input errato, mentre un codice di stato HTTP 503 contiene informazioni sugli errori che indicano quali quote API sono state superate. Queste risposte consentono alla tua applicazione personalizzata di rilevare questi errori e intraprendere le azioni appropriate.
Se le richieste devono essere completate in un periodo di tempo fisso, inviale in parallelo o utilizza più thread nell'applicazione Java o C#. Ad esempio, puoi suddividere le richieste in base al mese o a un altro periodo di tempo. Nel caso dei thread, prova a iniziare con 10 thread, uno per richiesta. Tieni presente che il consiglio dei thread presenta compromessi e non è utile per tutte le situazioni API. Se il numero di richieste diventa troppo elevato, si verificheranno errori di quota.
Per tutti gli errori basati sul tempo (massimo N per un numero di secondi per thread), in particolare per gli errori relativi al codice di stato 503, consigliamo di assegnare l'eccezione al codice e, utilizzando un algoritmo di backoff esponenziale, attendi un leggero ritardo prima di riprovare la chiamata non riuscita. Un esempio di API Email Settings per un thread è l'attesa di 5 secondi e riprovare la chiamata non riuscita. Se la richiesta ha esito positivo, ripeti questo pattern per gli altri thread. In caso contrario, l'applicazione deve ridurre la frequenza della richiesta fino a quando la chiamata non riesce. Ad esempio, aumenta il ritardo iniziale di 5 secondi a 10 secondi e riprova a eseguire la chiamata non riuscita. Stabilisci anche un limite per i nuovi tentativi. Ad esempio, riprova a eseguire la richiesta da 5 a 7 volte con tempi di ritardo diversi prima che l'applicazione restituisca un errore all'utente.
| Categorie quote API | Quote |
|---|---|
| Token di autenticazione ClientLogin | Valida per 24 ore. L'errore è "401 token scaduto". |
| Generazione di chiavi pubbliche e private | Con il tuo provider di identità, genera un insieme di chiavi pubbliche e private utilizzando gli algoritmi DSA o RSA. La chiave pubblica è in certificato in formato X.509. Per saperne di più sulle chiavi di firma Single Sign-On basate su SAML, vedi Generazione di 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 i loghi personalizzati, ricordati di rispettare i Termini di servizio di Google. Non utilizzare il logo Google, il logo Gmail o qualsiasi altro logo Google. Per ulteriori informazioni, consulta le norme relative al logo e alla pagina di destinazione. |
| ssoWhitelist | Un ssoWhitelist è un indirizzo IP di maschera di rete in formato Classless Inter-Domain Routing (CIDR). |
| Altri tipi di limiti | Limitazioni e linee guida |
|---|---|
| Stato di verifica del record MX | Lo stato predefinito della verifica del record MX è "false", il che significa che il sistema di Google non ha controllato di recente la configurazione dei record MX oppure i tuoi record MX non sono stati configurati per puntare ai sistemi Google. Se hai aggiornato i record e lo stato della verifica rimane falso, è possibile che gli aggiornamenti dei record MX non siano stati propagati o vi sia un errore ortografico nel record. Ai fini della propagazione, consigliamo di attendere per il tempo definito dal valore Time To Live (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 dei nomi delle organizzazioni, vedi Utilizzo dei caratteri. |
creationTime, rappresentazione numerica delle date e dell'ora |
Consulta la ISO 8601, Rappresentazione numerica delle date e dell'ora. |
| Tag di codifica delle lingue | Consulta i tag della lingua RFC 3066 accettati da Google Mail. |
| Nome dell'organizzazione | Se il nome dell'organizzazione non è stato personalizzato, il valore predefinito è il nome del dominio principale. Per informazioni sui caratteri dei nomi delle organizzazioni, vedi Utilizzo dei caratteri. |