Les limites et les quotas protègent l'infrastructure Google contre un processus automatisé qui utilise l'API Groups Settings de manière inappropriée. Un nombre excessif de requêtes provenant d'une API peut résulter d'une faute de frappe inoffensive ou d'un système mal conçu qui effectue des appels d'API inutiles. Quelle qu'en soit la cause, le blocage du trafic provenant d'une source spécifique une fois qu'il atteint un certain niveau est nécessaire au bon état général du système Google Workspace.
Échecs de requêtes API
Dans le cas peu probable où votre requête API échouerait, votre application recevra une réponse avec un code d'état HTTP. Le code d'état HTTP 403 contient des informations d'erreur indiquant les quotas d'API qui ont été dépassés. La réponse permet à votre application personnalisée de détecter les erreurs et de prendre les mesures appropriées.
Requêtes urgentes
Si vos requêtes doivent être traitées dans un délai déterminé, envoyez-les en parallèle ou utilisez plusieurs threads dans votre application Java ou C#. Par exemple, répartissez vos requêtes par mois ou par période. Dans le cas des threads, essayez de commencer par 10 threads, à raison d'un 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 requêtes devient trop élevé, des erreurs de quota se produisent.
Erreurs temporelles
Pour toutes les erreurs temporelles (nombre maximal d'éléments pendant X secondes par thread), en particulier les erreurs de code d'état 503, nous vous recommandons d'intercepter l'exception par le code et, à l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, attendez un court délai avant de relancer l'appel ayant échoué. Pour un thread, un exemple d'API Groups Settings consiste à attendre cinq secondes et à relancer l'appel ayant échoué. Si la requête aboutit, répétez ce schéma pour les autres threads. Si la deuxième requête échoue, votre application doit réduire la fréquence de la requête jusqu'à ce qu'un appel aboutisse. Par exemple, augmentez le délai initial de 5 secondes à 10 secondes et relancez l'appel ayant échoué. Définissez également une limite de nouvelles tentatives. Par exemple, relancez une requête cinq à sept fois avec des délais différents avant que votre application ne 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 depuis la page Quotas de la console Google Cloud. |
| Description du groupe, taille maximale | La description du groupe peut comporter jusqu'à 300 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 propriété defaultMessageDenyNotificationText, consultez la 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 la propriété 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 prend également en charge le format Atom. Les formats de données JSON et Atom sont compatibles avec toutes les fonctionnalités de lecture/écriture. Pour en savoir plus, consultez la section 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, consultez Activer les API Google Workspace. |