Les quotas protègent l'infrastructure de Google contre les processus automatisés qui n'utilisent pas l'API Campaign Manager 360 de manière inappropriée. Elles permettent de s'assurer 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 avec l'ensemble des ressources et méthodes de l'API Campaign Manager 360.
- 50 000 requêtes par projet et par jour peuvent être augmentées.
- 1 requête par seconde (RPS) par projet.
- Dans la console Google APIs, ce quota est appelé Requêtes par minute et 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 RPS (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 quotas
Dans le cas peu probable où votre requête échoue en raison du dépassement d'une limite 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 présente les erreurs possibles et les actions recommandées en cas d'échec des requêtes, causées par un dépassement des limites de quota.
| Coder | Motif | d'un 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 à partir de la console Google APIs et modifiez votre workflow pour réduire le nombre 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 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 de générer d'autres rapports pour ce profil utilisateur ce jour-là. Changez de 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 réessayer. |
| 403 | quotaExceeded | Le profil utilisateur qui possè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 d'envoyer une nouvelle demande. |
| 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 réessayer. |
| 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 utilisateur dépassée | Augmentez la limite par utilisateur dans la console Google APIs ou ralentissez le rythme d'envoi des requêtes à l'aide d'un intervalle exponentiel entre les tentatives. Il est déconseillé d'envoyer 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 davantage 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étaillées dans le tableau ci-dessus.
- Accédez à l'API Campaign Manager 360 dans la console Google APIs.
- Examinez vos statistiques d'utilisation sur la page Métriques pour vous assurer que votre application se comporte comme prévu. Vérifiez attentivement les méthodes appelées et corrigez toute utilisation inattendue ou excessive avant de poursuivre.
- 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".
Vérifiez les informations et suivez les instructions fournies dans le formulaire de demande de quota avant d'envoyer une demande d'augmentation.