Les limites et les quotas protègent l'infrastructure Google d'un processus automatisé qui utilise l'API Reseller de manière inappropriée. Un nombre excessif de requêtes provenant d'une API peut résulter d'une faute de frappe inoffensive ou d'un système mal conçu qui effectue des appels d'API inutiles. Quelle qu'en soit la cause, le blocage du trafic provenant d'une source spécifique lorsqu'il atteint un certain niveau est nécessaire au bon fonctionnement général du système Google Workspace. Cela garantit que les actions d'un développeur ne peuvent pas avoir d'impact négatif sur la communauté au sens large.
Échecs de requêtes API
Dans le cas peu probable où votre requête API échouerait, votre application recevra une réponse avec un code d'état HTTP. Un code d'état 403 contient des informations d'erreur concernant une entrée incorrecte, et un code d'état HTTP 503 contient des informations d'erreur indiquant les quotas d'API dépassés. Ces réponses permettent à votre application personnalisée de détecter ces erreurs et de prendre les mesures appropriées.
Erreurs temporelles
Pour toutes les erreurs temporelles (au maximum N éléments pour N secondes par thread), en particulier les erreurs de code d'état 503, nous vous recommandons d'intercepter l'exception par le code et, à l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, attendez un court délai avant de relancer l'appel ayant échoué. Pour un thread, par exemple, l'API Reseller consiste à attendre cinq secondes et à retenter 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 de la requête jusqu'à ce qu'un appel aboutisse. Par exemple, faites passer le délai initial de 5 secondes à 10 secondes, puis relancez l'appel ayant échoué. Définissez également un nombre maximal de 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.
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 comporter de 1 à 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 30 jours à compter de sa génération. |
| Nombre maximal d'utilisateurs pour un client | En fonction de votre contrat, le nombre maximal d'utilisateurs peut être de 50 000 ou défini dans votre contrat revendeur. |
| Demandes non autorisées | Google n'autorise pas les requêtes non autorisées adressé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 JSON JavaScript Object Notation.
JSON est un format Internet courant qui fournit une méthode pour représenter des structures de données arbitraires. JSON est un format de texte qui est totalement indépendant du langage, mais qui utilise des conventions connues des programmeurs de la famille C, y compris C, C++, C#, Java, JavaScript, Perl et Python. |
| Format de l'heure | Toutes les dates et heures se trouvent dans le convertisseur Epoch en millisecondes. Ce format s'applique aux valeurs de l'heure de création de l'abonnement, des heures de début et de fin de l'engagement d'un forfait, et de l'heure de fin d'un essai sans frais de 30 jours. |