Limiti e quote proteggono l'infrastruttura di Google da un processo automatizzato che utilizza l'API Directory in modo inappropriato. Le richieste eccessive da parte di un'API potrebbero essere il risultato di un errore di battitura innocuo o potrebbero essere il risultato di un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, bloccare il traffico da una sorgente specifica una volta raggiunto un determinato livello è necessario per l'integrità complessiva del sistema Google Workspace. Assicura che le azioni di uno sviluppatore non possano influire negativamente sulla community più ampia.
Nell'improbabile caso che la tua richiesta API non vada a buon fine, l'API restituisce un codice di stato HTTP e il motivo dell'errore. Inoltre, il corpo della risposta contiene una descrizione dettagliata di ciò che ha causato l'errore.
Il seguente elenco mostra i possibili codici di errore, i motivi, le descrizioni corrispondenti e l'azione consigliata per gli errori causati dal raggiungimento dei limiti di quota.
| Codice | Motivo | Descrizione | Azione consigliata |
|---|---|---|---|
| 403 | userRateLimitExceeded | Indica che il limite di frequenza utenti è stato superato. Il valore predefinito impostato nella console Google Cloud è di 2400 query al minuto per utente per progetto Google Cloud. | Aumenta i limiti per utente dalla pagina Quote dell'API Admin SDK del tuo progetto Google Cloud o rallenta la frequenza con cui invii le richieste utilizzando il backoff esponenziale. |
| 403 | quota superata | Indica che è stato raggiunto il limite di richieste in parallelo per una determinata operazione. | Riprova utilizzando il backoff esponenziale. Devi rallentare la frequenza di invio delle richieste. |
| 429 | rateLimite superato | Indica che è stato raggiunto il limite di richieste in parallelo per una determinata operazione. | Riprova utilizzando il backoff esponenziale. Devi rallentare la frequenza di invio delle richieste. Il limite si applica all'account Google Workspace, non al client API o all'utente. Questo limite non può essere aumentato. |
Implementazione del backoff esponenziale
Il backoff esponenziale è il processo con cui un client riprova periodicamente una richiesta non riuscita in un periodo di tempo crescente. È una strategia standard di gestione degli errori per le applicazioni di rete. L'utilizzo del backoff esponenziale aumenta l'efficienza dell'utilizzo della larghezza di banda, riduce il numero di richieste necessarie per ottenere una risposta di successo e massimizza la velocità effettiva delle richieste in ambienti simultanei.
Il flusso per l'implementazione di un backoff esponenziale semplice è il seguente.
- Inviare una richiesta all'API
- Ricevere una risposta di errore con un codice di errore riprovabile
- Attendi 1 s +
random_number_millisecondssecondi - Riprova richiesta
- Ricevere una risposta di errore con un codice di errore riprovabile
- Attendi 2 s +
random_number_millisecondssecondi - Riprova richiesta
- Ricevere una risposta di errore con un codice di errore riprovabile
- Attendi 4 s +
random_number_millisecondssecondi - Riprova richiesta
- Ricevere una risposta di errore con un codice di errore riprovabile
- Attendi 8 s +
random_number_millisecondssecondi - Riprova richiesta
- Ricevere una risposta di errore con un codice di errore riprovabile
- Attendi 16 s +
random_number_millisecondssecondi - Riprova richiesta
- Se continui a visualizzare un errore, fermati e registralo.
Nel flusso precedente, random_number_milliseconds è un numero casuale
di millisecondi inferiore o uguale a 1000. Questa operazione è necessaria per evitare alcuni errori di blocco in alcune implementazioni simultanee.
random_number_milliseconds deve essere ridefinito dopo ogni attesa.
Nota: l'attesa è sempre (2 ^ n) + random_number_milliseconds, dove n è un numero intero in aumento monotonico inizialmente definito come 0. n viene incrementato di 1 per ogni iterazione (ogni richiesta).
L'algoritmo è impostato per terminare quando n è 5. Questo limite serve solo per impedire ai client di riprovare all'infinito e genera un ritardo totale di circa 32 secondi prima che una richiesta venga considerata "un errore irreversibile". Il client API può implementare un numero maggiore di tentativi, se necessario.
Limiti e quote dell'API
| Categorie di limiti API | Limiti |
|---|---|
| Creazione di utenti | Non puoi creare più di 10 utenti per dominio al secondo utilizzando l'API Directory. |
| Gruppo aggiunto come membro di un altro gruppo | Può avere un ritardo fino a 10 minuti prima che i membri del gruppo secondario vengano visualizzati come membri del gruppo principale. Questo limite può variare a seconda della capacità del sistema. |
| Dispositivi mobili |
Utilizzando l'API Directory, puoi eseguire fino a:
|
| Ridenominazione degli utenti | La propagazione a tutti i servizi può richiedere fino a 10 minuti. Prima di rinominare un utente, è consigliabile disconnetterlo da tutte le sessioni e tutti i servizi del browser. Per maggiori dettagli, vedi Aggiornare gli utenti. |
| Creare/aggiornare le unità organizzative |
|
| Categorie di quote API | Quote |
Dispositivi Chrome annotatedLocation, numero massimo di caratteri
|
Il numero massimo di caratteri per le informazioni sulla posizione di un dispositivo è 200. |
Dispositivi Chrome notes, numero massimo di caratteri
|
Il numero massimo di caratteri per le informazioni sulle note di un dispositivo è 500. |
Dispositivi Chrome, massimo user caratteri
|
Il numero massimo di caratteri per il nome di un utente del dispositivo è 100. |
| Alias di dominio, massimo | Il numero massimo di alias di dominio è 20. |
| Gruppi, descrizione | Il numero massimo di caratteri in una descrizione è 4096. |
| Gruppi, per account | Con un account della versione senza costi precedente di G Suite, il numero di gruppi è limitato a 10. Le altre versioni non hanno limiti al numero di gruppi. |
| Gruppi, membri per gruppo | Con un account della versione senza costi precedente di G Suite, un gruppo può contenere fino a 100 membri. Le altre versioni non hanno limiti al numero di membri che un gruppo può avere. Per i limiti di iscrizione ai gruppi per utente, vedi Informazioni sui criteri e i limiti di Gruppi |
| stringa di query maxResults | L'API restituisce:
|
| Più domini, numero massimo di domini consentiti in un account | 600 (1 dominio principale + 599 domini aggiuntivi) |
| Unità organizzativa, numero massimo di utenti spostati contemporaneamente | È possibile spostare 20 utenti alla volta. Inoltre, gli indirizzi email principali dell'utente devono già esistere nell'account. |
| Alias utente | Il numero totale di alias consentiti per ogni account utente è 30. |
| Alias utente con alias eliminato | Un alias utente eliminato può essere utilizzato di nuovo immediatamente. |
| Altri tipi di limiti | Limitazioni e linee guida |
|---|---|
| Fatturazione e creazione di utenti | Per gli utenti che hanno un piano flessibile per Google Workspace, la creazione di utenti tramite questa API avrà un impatto monetario e comporterà addebiti sul tuo account di fatturazione del cliente. Ad esempio, se hai un piano flessibile per Google Workspace, la creazione di 10 utenti comporterà l'addebito di 10 licenze Google Workspace sul tuo account, ripartite proporzionalmente dal momento della creazione. Se hai scelto un piano annuale, ti impegni già a pagare per un determinato numero di licenze e puoi creare solo un numero di utenti in base al tuo impegno. Per ulteriori informazioni sui piani di fatturazione e sul tuo account di fatturazione, consulta il Centro assistenza per gli amministratori. |
| Nome e cognome | Nome e cognome contengono un massimo di 40 caratteri. Supportano i caratteri Unicode/UTF-8 e possono contenere spazi, lettere (a-z), numeri (0-9), trattini (-), barre (/) e punti (.). Per ulteriori informazioni sulle regole di utilizzo dei caratteri, visita il Centro assistenza per l'amministrazione. |
| Gruppi, eliminazione | L'eliminazione di un gruppo non elimina gli account utente del membro del gruppo. |
| Gruppi e membri dei gruppi, modifica dell'indirizzo email | In questa versione dell'API, l'indirizzo email di un gruppo può essere modificato prima dell'attivazione del servizio Google Workspace. Utilizza la Console di amministrazione per modificare l'indirizzo email di un membro del gruppo. Una volta modificata, l'API riflette automaticamente le modifiche agli indirizzi email. |
| Gruppi, impostazioni | Le impostazioni di accesso dei gruppi, le opzioni di condivisione, il monitoraggio e l'archivio discussioni sono gestiti tramite la Console di amministrazione. Per ulteriori informazioni sulle impostazioni dei gruppi, visita il Centro assistenza per l'amministrazione. |
| Gruppi, invio di messaggi | Per impedire lo spam e l'abuso dell'email, Google limita il numero di messaggi che puoi inviare contemporaneamente a destinatari esterni. Se invii un messaggio a un gruppo, ogni membro esterno viene conteggiato come un destinatario. Per maggiori informazioni, vedi Limiti di invio delle email e Impedire che la posta indirizzata agli utenti Gmail venga bloccata o finisca nello Spam . |
| Gruppi, invio di messaggi NDR | Non puoi inviare o inoltrare a un gruppo le notifiche di mancato recapito, chiamate anche "messaggi di mancato recapito". |
| Gruppi creati dagli utenti, limitazioni | Per i limiti dei gruppi creati dagli utenti, visita il Centro assistenza per l'amministrazione |
| Unità organizzativa, attivazione/disattivazione di servizi | Utilizza la Console di amministrazione per gestire l'attivazione e disattivazione dei servizi per un'unità organizzativa. |
| Password | Può contenere qualsiasi combinazione di caratteri. È richiesto un minimo di 8 caratteri. La lunghezza massima è di 100 caratteri. |
| Foto | In questa versione dell'API, una foto è l'ultima foto del profilo Google dell'utente. |
| Nomi utente | I nomi utente possono contenere lettere (a-z), numeri (0-9), trattini (-), trattini bassi (_) e Google Workspace riconosce i punti o i punti (.). Questa funzione non equivale a quanto accade in Gmail. Il nome utente non può contenere il segno uguale (=), le parentesi (<,>) o più di un punto (.) in una riga. Per ulteriori informazioni, visita il Centro assistenza per gli amministratori. |
| Nomi utente, ridenominazione | Dopo la ridenominazione, Google Hangouts elimina tutti gli inviti a chat memorizzati. L'utente deve richiedere di nuovo l'autorizzazione per chattare con gli amici. Il vecchio nome utente viene conservato come alias email per garantire la continuità del recapito della posta in caso di impostazioni di inoltro email e non sarà disponibile come nuovo nome utente. Per informazioni importanti sull'impatto della ridenominazione degli utenti, visita il Centro assistenza per l'amministrazione. Utilizza l'operazione di eliminazione dell'alias di un utente per rimuovere l'alias email dopo la ridenominazione. |
| Utenti in più domini | Un account Google Workspace può includere qualsiasi tuo dominio. In un account con più domini, gli utenti di un dominio possono condividere servizi con utenti di altri domini di account. I componenti di più domini sono:
|
| Avvisi, membri del gruppo | GROUP_CANNOT_CONTAIN_CYCLE - L'API non consente un ciclo nelle iscrizioni ai gruppi. Ad esempio, se group1 è un membro di gruppo2, gruppo2 non può essere un membro di gruppo1. |