Les limites et les quotas protègent l'infrastructure Google d'un processus automatisé qui utilise l'API Enterprise License Manager 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 pour assurer l'état général du système Google Workspace. Il garantit que les actions d'un développeur ne peuvent pas avoir d'impact négatif sur la communauté au sens large.
Dans le cas peu probable où votre requête API échouerait, vous recevrez une réponse avec code d'état HTTP. Un code d'état 403 contient des informations d'erreur concernant une entrée incorrecte, tandis qu'un code d'état HTTP 503 contient des informations d'erreur indiquant les quotas d'API dépassés. Ces réponses permettent à votre application personnalisée de détecter ces erreurs et de prendre les mesures appropriées.
Si vos requêtes doivent être traitées dans un délai déterminé, envoyez-les par lot. En fonction de l'objectif de votre API et si le nombre de requêtes devient trop élevé, des erreurs de quota se produiront.
Si vous n'êtes pas en mesure d'utiliser la fonctionnalité de requêtes API par lot recommandée, utilisez l'algorithme d'intervalle exponentiel entre les tentatives. Pour toutes les erreurs temporelles (au maximum N éléments pour X secondes par thread), en particulier les erreurs de code d'état 503, nous vous recommandons d'intercepter l'exception avec votre code et, à l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, d'attendre un court délai avant de relancer l'appel ayant échoué. Pour un thread donné, l'API Enterprise License Manager consiste à attendre cinq secondes et à retenter 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, faites passer ce délai initial de 5 secondes à 10 secondes, puis relancez l'appel ayant échoué. Définissez également un nombre maximal de 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.
| Catégories de quota de l'API | Quotas |
|---|---|
| Requêtes par seconde (RPS) | Le quota de RPS est de 1. |
| Catégories de limites de l'API | Limites |
|---|---|
| Chaîne de requête maxResults | La taille maximale de "maxResults" est de 100. |
| Autres types de limites | Limites et consignes |
|---|---|
| Requêtes par lot |
L'API permet l'envoi de requêtes par lot. |
| Format des données dans les réponses de l'API | Le format de données de la réponse est le format JavaScript Object Notation (JSON). |
| Activer l'API Enterprise License Manager | Vous devez activer l'API de gestion des licences avant d'appeler l'API Enterprise License Manager. Dans votre panneau de configuration, accédez à la page Paramètres de l'onglet Utilisateurs et groupes et activez l'API de gestion des comptes. Enregistrez les modifications. En outre, le service Google Groupes doit être activé. |
| Demandes non autorisées | L'API n'accepte aucune requête non autorisée. Une requête est considérée comme non autorisée si aucun jeton d'autorisation n'est fourni. Pour en savoir plus, consultez la section Autoriser les requêtes . |