Limites d'utilisation et quotas

Les limites et les quotas protègent l'infrastructure Google contre les processus automatisés qui utilisent l'API du Centre d'alertes de manière inappropriée. Les requêtes excessives d'une API peuvent être dues à une simple faute de frappe ou à un système mal conçu qui appelle inutilement l'API. Quelle qu'en soit la cause, il est nécessaire de bloquer le trafic provenant d'une source spécifique dès qu'il atteint un certain niveau afin de préserver l'état global du système Google Workspace. Cela permet de s'assurer 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 un code d'état HTTP en réponse. Le code d'état 403 contient des informations sur les erreurs liées à des entrées incorrectes, tandis que le code d'état HTTP 503 contient des informations sur les erreurs indiquant les quotas d'API qui ont été 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 fixe, envoyez-les en parallèle ou utilisez plusieurs threads dans votre application Java ou C#. Par exemple, il est préférable de demander de petits lots d'e-mails provenant de différents utilisateurs plutôt que d'ajouter ou de supprimer de nombreux e-mails d'un même utilisateur simultanément. Dans le cas des fils de discussion, essayez de commencer par 10 fils, un par adresse e-mail d'utilisateur. Notez que 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 produiront.

Pour toutes les erreurs basées sur le temps (maximum de N éléments pour N secondes par thread), en particulier les erreurs de code d'état 503, nous vous recommandons de faire en sorte que votre code détecte l'exception et, à l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, attende un court délai avant de réessayer l'appel ayant échoué. Un exemple d'API Alert Center pour un thread consiste à 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 des requêtes jusqu'à ce qu'un appel réussisse. Par exemple, augmentez le délai initial de cinq secondes à dix secondes, puis réessayez d'appeler. 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.

Catégories de limites d'API Limites
Fréquence des requêtes (QPS) et des requêtes par jour (QPD) du centre d'alerte L'API limite le nombre de requêtes pour votre projet de console APIs. Le nombre maximal de requêtes par seconde (RPS) du projet d'API est de 1 000. 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 503. Utilisez l'algorithme d'intervalle exponentiel entre les tentatives lorsque vous relancez vos requêtes.

Autres types de limites Limites et consignes
Format des 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 à 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 Autoriser les requêtes.

Demander une augmentation du quota par projet

Selon l'utilisation des ressources de votre projet, vous pouvez demander un ajustement de quota. Les appels d'API effectués par un compte de service sont considérés comme utilisant un seul compte. La demande d'ajustement de quota ne garantit pas l'approbation. Les demandes d'ajustement de quota qui augmenteraient considérablement la valeur du quota peuvent prendre plus de temps à être approuvées.

Tous les projets ne sont pas soumis aux mêmes quotas. À mesure que votre utilisation de Google Cloud s'accroît, vos quotas peuvent augmenter en conséquence. 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 :