Limites d'utilisation et quotas

Les limites et les quotas protègent l'infrastructure Google contre les processus automatisés qui utilisent l'API des paramètres d'administration de manière inappropriée. Des requêtes excessives provenant 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. Un code d'état 403 contient des informations sur les erreurs liées à des entrées incorrectes, tandis qu'un 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, répartissez vos demandes par mois ou par une autre période. Dans le cas des threads, essayez de commencer par 10 threads, un par requête. 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 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, à 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 Email Settings 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, 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 quotas d'API Quotas
Jetons d'authentification ClientLogin Valable pendant 24 heures. L'erreur "401 token expired" s'affiche.
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 se trouve dans un certificat au format X.509. Pour en savoir plus sur les clés de signature de l'authentification unique basée sur 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 le fichier doit être inférieur à 20 Ko. Lorsque vous utilisez des logos personnalisés, veillez à respecter les Conditions d'utilisation de Google. Évitez également d'utiliser le logo Google, le logo Gmail ou tout autre logo Google. Pour en savoir plus, consultez les Règles relatives aux logos et aux pages de destination.

ssoWhitelist

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 de l'enregistrement MX

L'état de validation par défaut des enregistrements MX est défini sur "false", ce qui signifie que le système Google n'a pas vérifié récemment la configuration de vos enregistrements MX ou que vos enregistrements MX 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 apportées à vos enregistrements MX n'ont pas été propagées ou qu'il y a une faute de frappe dans l'enregistrement. Pour la propagation, nous vous recommandons d'attendre le délai défini 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é, la valeur par défaut est le nom de votre domaine principal. Pour en savoir plus sur les caractères des noms d'organisation, consultez Utilisation des caractères.

Propriété creationTime, représentation numérique des dates et heures

Consultez la norme ISO 8601, Représentation numérique des dates et heures.

Balises d'encodage de langue

Consultez les codes de langue RFC 3066 acceptés par Google Mail.

Nom de l'organisation

Si le nom de l'organisation n'a pas été personnalisé, la valeur par défaut est le nom de votre domaine principal. Pour en savoir plus sur les caractères des noms d'organisation, consultez Utilisation des caractères.

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 :