Les limites et les quotas protègent l'infrastructure Google contre un processus automatisé qui utilise l'API Groups Migration 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, il est nécessaire de bloquer le trafic provenant d'une source spécifique une fois qu'il a atteint un certain niveau, afin d'assurer l'état général du système Google Workspace.
É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 HTTP 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 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.
Requêtes urgentes
Si vos requêtes doivent être traitées dans un délai déterminé, envoyez-les en parallèle ou utilisez plusieurs threads dans votre application Java ou C#. Par exemple, répartissez vos requêtes par mois ou par période. Dans le cas des threads, essayez de commencer par 10 threads, à raison d'un par requête. La recommandation de thread comporte 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 produisent.
Erreurs temporelles
Pour toutes les erreurs temporelles (nombre maximal d'éléments pendant X secondes par thread), en particulier les erreurs de code d'état 503, nous vous recommandons de faire en sorte que votre code intercepte l'exception et, à l'aide d'un algorithme d'intervalle exponentiel entre les tentatives, attendez un court délai avant de réessayer l'appel ayant échoué. Pour un thread, un exemple d'API Groups Migration consiste à attendre cinq secondes et à relancer 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, augmentez le délai initial de 5 secondes à 10 secondes et relancez l'appel ayant échoué. Définissez également un nombre maximal de relances. 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 |
|---|---|
| Requêtes par seconde (RPS) | La limite pour les projets de développement est de 10 requêtes par seconde (RPS) et par compte. |
Quotas
| Catégories de quotas d'API | Quotas |
|---|---|
| Nombre maximal de requêtes API par jour | Le nombre maximal de requêtes API par jour est de 500 000. |
| Archivage, expiration des messages | Les archives de groupe n'expirent pas. Les messages sont conservés jusqu'à la suppression du groupe. La règle de conservation des e-mails n'a aucune incidence sur les messages contenus dans les archives d'un groupe. |
| Taille des messages | La taille maximale des e-mails est de 25 Mo. Cette limite inclut les en-têtes de métadonnées, le corps et les éventuelles pièces jointes du message. |
Autres types de limites
| Autres limites | Limites et consignes |
|---|---|
| Formats de type de contenu | Les e-mails doivent être au format texte RFC 822 standard.
Lors de l'importation d'e-mails migrés, le type de contenu d'une requête doit utiliser l'en-tête Content-type: message/rfc822.
|
| Format de données dans les réponses de l'API | Le format de données de la réponse est au format JSON (JavaScript Object Notation). |
| Règles concernant l'emplacement des données | L'API Groups Migration n'est pas compatible avec les règles d'emplacement des données qui exigent que les données soient stockées dans des limites géographiques ou politiques spécifiques pour des raisons contractuelles. N'utilisez pas l'API Groups Migration si l'emplacement des données est requis pour votre compte. |
| Insertions de messages en parallèle | L'API Groups Migration accepte les requêtes parallèles pour insérer des e-mails dans différentes archives de groupe. Toutefois, l'API Groups Migration n'accepte pas l'insertion de messages en parallèle dans la même archive de groupe. Les requêtes par lot ne sont pas non plus compatibles avec cette version de l'API Groups Migration. |
| Demandes non autorisées | L'API Groups Migration n'accepte aucune demande non autorisée. 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. |