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 peuvent être dues à une faute de frappe ou à une conception de système inefficace. Pour garantir le bon fonctionnement du système Google Workspace, Google bloque le trafic provenant de sources spécifiques lorsqu'il atteint certains niveaux. Cela permet de s'assurer que les actions d'un développeur n'ont pas d'impact négatif sur la communauté.
Échecs de requêtes API
Si une requête API échoue, votre application reçoit un code d'état HTTP. Un code d'état 403 indique une entrée incorrecte, et un code d'état 503 indique que les quotas d'API ont été dépassés. Utilisez ces réponses pour détecter les erreurs et prendre des mesures.
Erreurs liées au temps
Pour les erreurs liées au temps, en particulier les codes d'état 503, utilisez un
algorithme d'intervalle exponentiel entre les tentatives. Attendez un court délai avant de réessayer l'appel ayant échoué. Par exemple, attendez cinq secondes, puis réessayez. Si l'opération réussit, répétez le schéma pour les autres threads. Si la deuxième requête échoue, réduisez la fréquence des requêtes jusqu'à ce qu'un appel aboutisse. Il est également recommandé de définir une limite de nouvelles tentatives, par exemple entre cinq et sept.
Limites
| Catégories de limites d'API | Limites |
|---|---|
purchaseOrderId de l'abonnement |
Cette propriété accepte jusqu'à 80 caractères en texte brut. |
maxResults de l'abonnement |
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 valide 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 celui défini dans votre contrat de revendeur. |
| Requêtes non autorisées | Google n'autorise pas les requêtes non autorisées adressées à l' API Reseller. Une requête n'est pas autorisée si aucun jeton d'autorisation n'est fourni. Pour en savoir plus, consultez la section En savoir plus sur l'authentification et l'autorisation. |
Autres types de limites
| Autres types de limites | Limites et consignes |
|---|---|
| Format des données |
Le format des données est JavaScript Object Notation
(JSON).
JSON est un format Internet courant pour représenter des structures de données arbitraires structures. Il s'agit d'un format de texte indépendant du langage qui utilise 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 | Les dates et les heures utilisent le convertisseur Epoch en millisecondes. Ce format s'applique à l'heure de création de l'abonnement, aux heures de début et de fin de l'engagement du forfait, ainsi qu'aux heures de fin de l'essai sans frais. |