Les limites et les quotas protègent l'infrastructure Google d'un processus automatisé qui utilise l'API Admin Settings de manière inappropriée. Les requêtes excessives provenant d'une API peuvent résulter d'une faute de frappe inoffensive ou d'un système inefficace qui effectue des appels d'API inutiles. Quelle que soit la cause, il est nécessaire de bloquer le trafic provenant d'une source spécifique lorsqu'il atteint un certain niveau pour assurer le bon fonctionnement global du système Google Workspace. Ainsi, les actions d'un développeur ne peuvent pas nuire à la communauté au sens large.
Dans le cas peu probable où votre requête API échoue, vous recevrez une réponse de code d'état HTTP. Un code d'état 403 contient des informations sur les erreurs de saisie, tandis qu'un code d'état HTTP 503 indique des erreurs de dépassement de quotas d'API. 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#. Par exemple, répartissez vos requêtes par mois ou par une autre période. Dans le cas des fils de discussion, essayez de commencer avec 10 fils, un par fil par requête. Notez que la recommandation de fil de discussion présente des compromis et n'est pas utile dans toutes les situations de l'API. Si le nombre de requêtes est trop élevé, des erreurs de quota se produiront.
Pour toutes les erreurs qui sont limitées dans le temps (soit N éléments au maximum pendant X 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, en utilisant un algorithme d'intervalle exponentiel entre les tentatives, d'attendre un court délai avant de relancer l'appel ayant échoué. Un exemple d'API Email Settings pour un fil de discussion consiste à attendre 5 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 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 à 10 secondes, puis réessayez votre appel ayant échoué. Définissez également une limite de nouvelle tentative. 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 quotas de l'API | Quotas |
|---|---|
| Jetons d'authentification ClientLogin | Valable pendant 24 heures. L'erreur est "Le jeton 401 a expiré". |
| Générer des clés publiques et privées | Avec votre fournisseur d'identité, générez un ensemble de clés publiques et privées à l'aide des algorithmes DSA ou RSA. La clé publique est au format X.509. Pour en savoir plus sur les clés de signature à authentification unique SAML, consultez Générer des clés et des certificats pour le service d'authentification unique Google Workspace. |
| Logo | Le fichier image du logo d'un compte peut être au format JPEG, PNG ou GIF. La taille recommandée est de 143 x 59 pixels, et la taille du fichier doit être inférieure à 20 Ko. Lorsque vous utilisez des logos personnalisés, n'oubliez pas de respecter les Conditions d'utilisation de Google. N'utilisez pas le logo Google, le logo Gmail ni aucun autre logo Google. Pour en savoir plus, consultez Règles relatives aux logos et aux pages de destination. |
| Liste blanche sso | Une ssoWhitelist est une adresse IP de masque de réseau au format CIDR(Classless Inter-Domain Routing). |
| Autres types de limites | Limites et consignes |
|---|---|
| État de validation des enregistrements MX | L'état de validation des enregistrements MX par défaut est "false". Cela signifie que le système Google n'a pas récemment vérifié la configuration de vos enregistrements MX ou qu'ils n'ont pas été configurés pour pointer vers les systèmes Google. Si vous avez mis à jour vos enregistrements et que l'état de validation reste "false", cela peut signifier que les modifications de vos enregistrements MX n'ont pas été propagées ou que l'enregistrement contient une faute de frappe. Pour la propagation, nous vous recommandons d'attendre la durée définie par la valeur TTL (Time To Live) de l'enregistrement MX, puis de réessayer. |
| Codes pays | Si le nom de l'organisation n'a pas été personnalisé, le nom de votre domaine principal est utilisé par défaut. Pour en savoir plus sur les caractères associés au nom de l'organisation, consultez Utilisation des caractères. |
Propriété creationTime, représentation numérique des dates et de l'heure |
Voir ISO 8601, représentation numérique des dates et des heures. |
| Balises d'encodage de langue | Consultez les tags de langue RFC 3066 acceptés par Google Mail. |
| Le nom de l'organisation | Si le nom de l'organisation n'a pas été personnalisé, le nom de votre domaine principal est utilisé par défaut. Pour en savoir plus sur les caractères associés au nom de l'organisation, consultez Utilisation des caractères. |