Limites d'utilisation et quotas

Les limites et les quotas protègent l'infrastructure Google contre les processus automatisés qui utilisent l'API Reseller 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 n'ont pas d'incidence négative sur la communauté au sens large.

Échecs de requêtes API

Dans le cas peu probable où votre requête API échoue, votre application reçoit 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.

Erreurs basées sur le temps

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 Reseller 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 aboutisse. Par exemple, augmentez le délai initial de cinq secondes à dix secondes, puis réessayez d'effectuer l'appel qui a échoué. 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.

Limites

Catégories de limites d'API Limites
Abonnement purchaseOrderId Cette propriété accepte jusqu'à 80 caractères en texte brut.
Abonnement maxResults La chaîne de requête maxResults peut contenir entre 1 et 100 résultats. La valeur par défaut est de 20 résultats.
Jeton de transfert (customerAuthToken) Le jeton de transfert d'un client est valable pendant 30 jours après sa génération.
Nombre maximal d'utilisateurs pour un client Selon votre contrat, le nombre maximal d'utilisateurs peut être de 50 000 ou correspondre au maximum défini dans votre contrat de revendeur.
Demandes non autorisées Google n'autorise pas les requêtes non autorisées à l'API Reseller. Une requête est considérée comme non autorisée si aucun jeton d'autorisation n'est fourni. Pour en savoir plus, consultez En savoir plus sur l'authentification et l'autorisation.

Autres types de limites

Autres types de limites Limites et consignes
Format des données Les données sont au format JavaScript Object Notation JSON.

JSON est un format Internet courant qui permet de représenter des structures de données arbitraires. JSON est un format de texte entièrement indépendant du langage, mais qui utilise des conventions familières aux programmeurs de la famille de langages C, y compris C, C++, C#, Java, JavaScript, Perl et Python.
Format de l'heure Toutes les dates et heures sont indiquées en millisecondes dans le convertisseur Epoch. Ce format s'applique aux valeurs de l'heure de création de l'abonnement, aux heures de début et de fin de l'engagement d'un forfait, ainsi qu'à l'heure de fin d'un essai sans frais de 30 jours.