Limites d'utilisation

Les limites d'utilisation protègent l'infrastructure de Google contre les processus automatisés qui utilisent l'API Display & Video 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 de requêtes API

L'API Display & Video 360 utilise deux types de limites:

  • Les limites de quota totales, dans lesquelles toutes les requêtes pertinentes sont prises en compte.
  • Les limites de quota d'écriture, qui sont prises en compte pour toutes les requêtes pertinentes effectuées pour les méthodes d'écriture. Les méthodes d'écriture sont définies en tant que méthodes (telles que create, patch, delete ou bulkEdit) qui modifient les ressources. Notez que certaines méthodes consomment plus de quota d'écriture que d'autres.

Si votre projet dépasse l'une de ces limites, une limitation peut se produire.

Limite de quota à l'échelle du projet

Les limites de quota par défaut suivantes sont partagées entre toutes les ressources et méthodes de l'API Display & Video 360:

  • Nombre total de requêtes par minute et par projet:1500
  • Requêtes d'écriture par minute et par projet:700

Limites du quota de requêtes propres aux annonceurs

Les méthodes qui spécifient une référence annonceur dans l'URL de la requête sont comptabilisées dans les limites de quota supplémentaires "par annonceur et par projet".

Toutes les requêtes dont le chemin d'URL comporte une référence annonceur (par exemple, celles envoyées aux services advertisers.lineItems, advertisers.creatives ou advertisers.channels) sont prises en compte dans les limites de quota suivantes:

  • Nombre total de requêtes par minute, par annonceur et par projet: 300
  • Requêtes d'écriture par minute, par annonceur et par projet: 150

Méthodes intensives d'écriture

Les méthodes d'API suivantes sont gourmandes en écriture, c'est-à-dire qu'elles utilisent une quantité importante de ressources produit et, par conséquent, consomment plus de quota de requêtes d'écriture que les autres requêtes d'écriture.

Les requêtes envoyées à des méthodes intensives en écriture sont comptabilisées comme cinq requêtes d'écriture lors du calcul de la consommation du quota de requêtes d'écriture. Par exemple, 100 requêtes d'écriture standards et 21 requêtes gourmandes en écriture (dont aucune ne spécifie un annonceur) effectuées en une minute seront comptabilisées comme 205 requêtes d'écriture (100 + (21 * 5) = 205) et dépasseraient la limite de quota de requêtes générales existante de 200 requêtes d'écriture par minute.

Les méthodes suivantes sont considérées comme exigeantes en écriture:

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 requêtes API, 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.

La liste suivante présente les erreurs possibles et les actions recommandées pour les échecs de requête causés par le dépassement des limites de requêtes API.

Code RPC Message Action recommandée
429 RESOURCE_EXHAUSTED La ressource est épuisée (par exemple, quota de contrôle). Examinez votre utilisation à partir de la console Google APIs et modifiez votre workflow afin de mieux mettre en parallèle les requêtes effectuées par différents annonceurs ou de ralentir plus généralement la fréquence d'envoi des requêtes.

Vous ne pouvez pas demander d'augmentation des limites de quota de l'API Display & Video 360.