Limites d'utilisation et quotas

Les limites et les quotas protègent l'infrastructure Google contre les processus automatisés qui utilisent l'API Alert Center 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 effectue des appels d'API inutiles. Quelle qu'en soit la cause, le blocage du trafic d'une source spécifique une fois qu'il atteint un certain niveau est nécessaire pour la santé globale 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 échoue, vous recevrez un code d'état HTTP. Le code d'état 403 contient des informations d'erreur concernant une entrée incorrecte, et le code d'état HTTP 503 contient des informations d'erreur 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 effectuées dans un délai fixe, envoyez-les en parallèle ou utilisez plusieurs threads dans votre application Java ou C#. Par exemple, vous pouvez demander de petits lots d'e-mails à différents utilisateurs plutôt que d'ajouter ou de supprimer simultanément un grand nombre d'e-mails d'un seul utilisateur. Dans le cas des threads, essayez de commencer par 10 threads, un par e-mail 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 que votre code intercepte 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 n'aboutit pas, 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 cinq secondes à dix secondes et réessayez votre appel ayant échoué. Définissez également une limite de tentatives. Par exemple, réessayez 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équences des requêtes (RPS) et des requêtes par jour (RPJ) du centre d'alerte L'API limite le nombre de requêtes pour votre projet Google Cloud. Le nombre maximal de requêtes par seconde (RPS du projet) est de 1 000. Le nombre maximal de requêtes par utilisateur et par seconde (RPS de l'utilisateur) est de 150.

Si ces limites sont dépassées, le serveur renvoie un code d'état HTTP 503 status code. Utilisez l' algorithme d'intervalle exponentiel entre les tentatives lorsque vous réessayez vos requêtes.

Autres types de limites Limites et consignes
Format de données, par défaut Le format de données par défaut est JSON.
Requêtes non autorisées Google n'autorise pas les requêtes non autorisées pour 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 les requêtes.

Demander une augmentation de 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 nécessiter plus de temps pour ê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 valeurs de quota peuvent devoir augmenter. Si vous prévoyez une augmentation significative de votre utilisation, vous pouvez anticiper cette évolution en demandant des ajustements de quotas sur la page Quotas et limites système de la console Google Cloud.

Pour en savoir plus, consultez les ressources suivantes :