Les quotas protègent l'infrastructure de Google contre les processus automatisés qui utilisent de manière inappropriée l'API Campaign Manager 360. Ils garantissent que les actions d'un développeur ne peuvent pas avoir un impact négatif sur la communauté dans son ensemble.
Limites de quota
Les limites de quota par défaut suivantes sont partagées par toutes les 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 API, 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'à 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 l'éventualité peu probable que votre requête échoue en raison d'un dépassement de quota, l'API renvoie 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 indique les erreurs possibles et les actions recommandées en cas d'échec de la requête causé par un 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 d'exécuter d'autres rapports pour ce compte ce jour-là. 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 d'exécuter d'autres rapports pour ce profil utilisateur ce jour-là. 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 débit 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 la méthode de rétrogradation exponentielle. Il est déconseillé d'effectuer des requêtes d'écriture simultanées ou d'utiliser une limite de débit supérieure à 10 QPS 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 plus en suivant les instructions ci-dessous.
Les instructions suivantes ne s'appliquent qu'aux projets ayant rencontré une erreur dailyLimitExceeded. Les actions recommandées pour les autres erreurs de quota sont décrites 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. Soyez particulièrement attentif 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 de modification à côté de Requêtes par jour, puis sur le lien "Demander un quota supérieur".
Veillez à consulter les informations et à suivre les instructions fournies dans le formulaire de demande de quota avant d'envoyer une demande d'augmentation.