Les limites et les quotas protègent l'infrastructure de Google contre un processus automatisé qui utilise le API Groups Settings de manière inappropriée. Un nombre excessif de requêtes provenant d'une API peut résulter d'une une faute de frappe inoffensive ou un système inefficace qui effectue des appels d'API inutiles. Quelle que soit la cause, bloquer le trafic provenant d'une source spécifique dès qu'il atteint un certain niveau est nécessaires au bon fonctionnement global du système Google Workspace.
Échecs des requêtes API
Dans le cas peu probable où votre requête API échouerait, votre application recevra un code d'état HTTP.
de réponse. Le code d'état HTTP 403 contient des informations d'erreur indiquant les quotas d'API
ont été dépassés. Cette réponse permet à votre application personnalisée de détecter les erreurs et de prendre
action.
Requêtes urgentes
Si vos requêtes doivent être traitées dans un laps de temps déterminé, envoyez-les en parallèle ou utiliser plusieurs threads dans votre application Java ou C#. Par exemple, décomposez vos requêtes par mois ou une autre période. Dans le cas des threads, essayez de commencer avec 10 threads, soit un thread par requête. La recommandation de thread présente des compromis et n'est pas utile dans toutes les situations d'API. Si le nombre de devient trop élevé, des erreurs de quota se produisent.
Erreurs temporelles
Pour toutes les erreurs temporelles (N éléments maximum pendant X secondes par thread), en particulier la
503 erreur de code d'état, nous vous recommandons de faire en sorte que votre code intercepte l'exception, et en utilisant
une
intervalle exponentiel entre les tentatives
, attendez un court délai avant de réessayer l'appel ayant échoué. Exemple d'utilisation de l'API Groups Settings pour
un thread doit attendre 5 secondes
et retenter l'appel ayant échoué. Si la requête aboutit, répétez cette opération
pour les autres threads. Si la deuxième demande n'aboutit pas,
réduire la fréquence des requêtes jusqu'à ce qu'un appel aboutisse. Par exemple, augmentez la valeur
un délai initial de 5 secondes à 10 secondes, puis relancez l'appel ayant échoué. Décidez également d'une nouvelle tentative
limite. Par exemple, relancez une requête cinq à sept fois avec des délais différents avant que votre application
renvoie une erreur à l'utilisateur.
Quotas
| Catégories de quotas d'API | Quotas |
|---|---|
| Requêtes par jour | Vous pouvez effectuer jusqu'à 100 000 requêtes par jour. Si vous avez besoin d'une capacité supérieure cette limite, vous pouvez envoyer une demande Page Quotas de la console Google Cloud |
| Description du groupe, taille maximale | La description du groupe peut contenir jusqu'à 4 096 caractères. |
| Nom du groupe, taille maximale | Le nom d'un groupe peut comporter jusqu'à 60 caractères. |
defaultMessageDenyNotificationText |
Le texte de la notification peut comporter jusqu'à 10 000 caractères. Pour en savoir plus sur la
defaultMessageDenyNotificationText, consultez les
Documentation de référence de l'API
|
maxMessageBytes |
Par défaut, la taille maximale des messages est de 1 Mo. Pour en savoir plus sur les maxMessageBytes
consultez la documentation de référence de l'API.
|
Limites
| Types de limites | Limites et consignes |
|---|---|
| Format de données, par défaut |
Le format de données par défaut est JSON. L'API est également compatible avec le format Atom. Les fichiers JSON et Atom les formats de données sont compatibles avec des fonctionnalités complètes de lecture/écriture. Pour en savoir plus, consultez Formats de données JSON et Atom : |
| API Groups Settings, activation | Vous devez activer l'API Directory avant d'appeler l'API Groups Settings Pour en savoir plus d'informations, consultez Activer les API Google Workspace. |