Les limites et les quotas protègent l'infrastructure Google d'un processus automatisé qui utilise l'API Alert Center 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. Le 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 en parallèle ou utilisez plusieurs threads dans votre application Java ou C#. Un exemple de requêtes parallèles consiste à demander de petits lots d'e-mails de différents utilisateurs au lieu d'ajouter ou de supprimer simultanément de nombreux e-mails d'un même utilisateur. Dans le cas des fils de discussion, essayez de commencer avec 10 fils de discussion (un par e-mail d'utilisateur). Notez que la recommandation de threads comporte 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 produiront.
Pour toutes les erreurs temporelles (N éléments maximum pour N 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, par exemple, l'API du centre d'alerte doit attendre cinq secondes et réessayer 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 limites de l'API | Limites |
|---|---|
| Taux de RPS et de RPJ du centre d'alerte | L'API limite le nombre de requêtes pour votre projet de console d'API. Le nombre maximal de requêtes par seconde (RPS du projet) pour le projet d'API est de 1 000. Par ailleurs, le nombre maximal de requêtes par utilisateur et par seconde (RPS utilisateur) est de 150.
Si ces limites sont dépassées, le serveur renvoie un code d'état HTTP |
| Autres types de limites | Limites et consignes |
|---|---|
| Format de données, par défaut | Le format de données par défaut est JSON. |
| Demandes non autorisées | Google n'autorise pas les requêtes non autorisées adressées à cette API. 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 des requêtes. |
Demander une augmentation du quota par projet
En fonction de l'utilisation des ressources par votre projet, vous pouvez demander une augmentation de quota. Les appels d'API effectués par un compte de service sont considérés comme n'utilisant qu'un seul compte. La demande d'augmentation de quota ne garantit pas l'approbation. L'approbation des augmentations de quota importantes peut prendre plus de temps.
Tous les projets ne sont pas soumis aux mêmes quotas. À mesure que vous utilisez Google Cloud de plus en plus, vos quotas peuvent avoir besoin d'augmenter. Si vous prévoyez une augmentation notable de l'utilisation, vous pouvez anticiper cette évolution en demandant des ajustements de quota sur la page Quotas de la console Google Cloud.
Pour en savoir plus, consultez les ressources suivantes :
- À propos des demandes d'augmentation de quota
- Consulter l'utilisation et les limites de quota actuelles
- Demander une limite de quota plus élevée