Les limites et 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 inefficace du système. Pour préserver l'état 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 de l'API ont été dépassés. Utilisez ces réponses pour détecter les erreurs et prendre des mesures.
Erreurs basées sur le 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 peu avant de réessayer d'appeler. 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 fois).
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 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 envoyé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 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 de données est JavaScript Object Notation (JSON).
JSON est un format Internet courant pour représenter des structures de données arbitraires. Il s'agit d'un format de texte indépendant du langage 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 | Les dates et 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'à l'heure de fin de l'essai sans frais. |