Les quotas protègent l'infrastructure de Google contre les processus automatisés qui utilisent l'API Campaign Manager 360 de manière inappropriée. Ils garantissent que les actions d'un développeur ne peuvent pas avoir d'impact négatif sur la communauté au sens large.
Limites de quota
Les limites de quota par défaut suivantes sont partagées par l'ensemble des ressources et méthodes de l'API Campaign Manager 360.
- 50 000 requêtes par projet et par jour (peut être augmenté)
- Une requête par seconde (RPS) par projet.
- Dans la console Google APIs, ce quota est appelé Requêtes par minute par utilisateur et est défini sur 60 par défaut. Cette limite peut être augmentée si nécessaire, jusqu'à un maximum de 600 (10 RPS).
L'outil de création de rapports applique des limites de quota supplémentaires qui varient selon le compte. Pour en savoir plus, consultez cet article du Centre d'aide et le tableau ci-dessous.
Dépassement des limites de quota
Dans le cas peu probable où votre requête échouerait en raison du dépassement d'une limite de quota, l'API renverra un code d'état HTTP et le motif de l'erreur. De plus, le corps de la réponse contient une description détaillée de la cause de l'erreur. Consultez le guide Messages d'erreur pour obtenir un exemple de réponse d'erreur.
La liste suivante présente les erreurs possibles et les actions recommandées en cas d'échec des requêtes en raison du dépassement des limites de quota.
| Code | Motif | Message | Action recommandée |
|---|---|---|---|
| 403 | dailyLimitExceeded | Limite quotidienne dépassée | Ne relancez pas la requête avant d'avoir résolu le problème. Examinez votre utilisation dans la console Google API et modifiez votre workflow pour envoyer moins de requêtes. Vous pouvez demander un quota supplémentaire si vous pensez que votre utilisation est raisonnable. |
| 403 | quotaExceeded | Ce compte a dépassé son quota de x rapports par jour. | N'essayez pas de générer d'autres rapports pour ce compte aujourd'hui. Contactez votre responsable de compte pour obtenir de l'aide. |
| 403 | quotaExceeded | Ce profil utilisateur a dépassé son quota de x rapports par jour. | N'essayez pas de générer d'autres rapports pour ce profil utilisateur aujourd'hui. Passez à un autre profil utilisateur ou contactez votre responsable de compte pour obtenir de l'aide. |
| 403 | quotaExceeded | Ce compte a dépassé son quota de x rapports planifiés actifs. | Désactivez les rapports planifiés dont vous n'avez pas besoin avant de relancer cette requête. |
| 403 | quotaExceeded | Le profil utilisateur propriétaire de ce rapport a dépassé son quota de x rapports planifiés actifs. | Demandez au propriétaire de ce rapport de désactiver les rapports planifiés dont il n'a pas besoin avant de relancer cette requête. |
| 403 | quotaExceeded | Ce profil utilisateur a dépassé son quota de x rapports planifiés actifs. | Désactivez les rapports planifiés dont vous n'avez pas besoin avant de relancer cette requête. |
| 403 | quotaExceeded | Impossible d'effectuer cette action, car l'un de vos quotas a été dépassé. Veuillez contacter votre responsable de compte pour obtenir de l'aide. | Contactez votre responsable de compte pour obtenir de l'aide. |
| 403 | userRateLimitExceeded | Limite de fréquence par utilisateur dépassée | Augmentez la limite par utilisateur dans la console Google API ou ralentissez le débit d'envoi des requêtes à l'aide de l'algorithme de backoff exponentiel. Il est déconseillé d'effectuer des requêtes d'écriture simultanées ou d'utiliser une limite de débit supérieure à 10 RPS avec cette API. |
Demander un quota quotidien supplémentaire
Si vous pensez que votre application nécessite un quota quotidien supplémentaire, vous pouvez en demander un en suivant les instructions ci-dessous.
Les instructions suivantes ne s'appliquent qu'aux projets qui ont rencontré une erreur dailyLimitExceeded. Les actions recommandées pour les autres erreurs de quota sont présentées dans le tableau ci-dessus.
- Accédez à l'API Campaign Manager 360 dans la console Google APIs.
- Consultez vos statistiques d'utilisation sur la page Métriques pour vous assurer que votre application se comporte comme prévu. Portez une attention particulière aux méthodes qui ont été appelées et corrigez toute utilisation inattendue ou excessive avant de continuer.
- Si l'utilisation semble normale, accédez à la page Quotas, cliquez sur l'icône Modifier à côté de Requêtes par jour, puis sur le lien "Demander un quota supérieur".
Avant de demander une augmentation de quota, veillez à consulter les informations et à suivre les instructions fournies dans le formulaire de demande de quota.