Limiti e quote proteggono l'infrastruttura Google da un processo automatizzato che utilizza l'API Groups Settings in modo inappropriato. Un numero eccessivo di richieste da un'API può derivare da un errore di ortografia innocuo o un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, il blocco del traffico proveniente da una sorgente specifica una volta raggiunto un determinato livello necessarie per l'integrità complessiva del sistema Google Workspace.
Errori relativi alle richieste API
Nell'improbabile caso in cui la richiesta API non vada a buon fine, l'applicazione riceve un codice di stato HTTP
la risposta corretta. Un codice di stato HTTP 403 contiene informazioni sull'errore che indicano quali quote API
sono state superate. La risposta consente all'applicazione personalizzata di rilevare gli errori e di adottare
un'azione.
Richieste urgenti
Se le tue richieste devono essere completate in un periodo di tempo fisso, inviale in parallelo o utilizzare più thread nella tua applicazione Java o C#. Ad esempio, interrompi le richieste per mese in un altro periodo di tempo. Nel caso di thread, prova a iniziare con 10 thread, uno per richiesta. Il suggerimento sui thread presenta dei compromessi e non è utile per tutte le situazioni relative alle API. Se il numero le richieste diventano troppo alte, si verificano errori di quota.
Errori temporali
Per tutti gli errori basati sul tempo (massimo N elementi per X secondi per thread), in particolare
503 errori del codice di stato, è consigliabile che il codice rilevi l'eccezione e utilizzi
un
backoff esponenziale
, attendi un po' di ritardo prima di riprovare a effettuare la chiamata non riuscita. Un esempio dell'API Groups Settings per
un thread è attendere 5 secondi e riprovare la chiamata non riuscita. Se la richiesta ha esito positivo, ripeti questo passaggio
per gli altri thread. Se la seconda richiesta non ha esito positivo,
ridurre la frequenza della richiesta fino a quando la chiamata non va a buon fine. Ad esempio, aumenta il
con un ritardo iniziale di 5 secondi su 10 secondi e riprova a effettuare la chiamata non riuscita. Puoi anche scegliere di riprovare
limite. Ad esempio, riprova una richiesta da 5 a 7 volte con tempi di ritardo diversi prima dell'applicazione
restituisce un errore all'utente.
Quote
| Categorie delle quote API | Quote |
|---|---|
| Query al giorno | Puoi effettuare fino a 100.000 query al giorno. Se hai bisogno di capacità oltre questo limite, puoi inviare una richiesta Pagina Quote nella console Google Cloud |
| Descrizione del gruppo, dimensione massima | Puoi inserire una descrizione del gruppo fino a 4096 caratteri. |
| Nome gruppo, dimensione massima | Il nome di un gruppo può contenere fino a 60 caratteri. |
defaultMessageDenyNotificationText |
Il testo della notifica può contenere fino a 10.000 caratteri. Per saperne di più sulle
defaultMessageDenyNotificationText, consulta la
Riferimento API.
|
maxMessageBytes |
La dimensione massima predefinita dei messaggi è 1 MB. Per scoprire di più sul maxMessageBytes
consulta il riferimento API.
|
Limiti
| Tipi di limiti | Limitazioni e linee guida |
|---|---|
| Formato dei dati (predefinito) |
Il formato dei dati predefinito è JSON. L'API supporta anche il formato Atom. Sia JSON che Atom i formati dati supportano funzionalità di lettura/scrittura complete. Per ulteriori informazioni, vedi Formati di dati JSON e Atom. |
| API Groups Settings, abilitazione | Devi attivare l'API Directory prima di effettuare chiamate all'API Groups Settings. Per ulteriori informazioni informazioni, vedi Abilitare le API Google Workspace. |