Limites d'utilisation

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

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

  • Limites de quota totales, qui sont déduites de toutes les requêtes pertinentes.
  • Limites de quota d'écriture, qui sont prises en compte par toutes les requêtes pertinentes envoyées aux méthodes d'écriture. Les méthodes d'écriture sont définies comme des méthodes (telles que create, patch, delete ou bulkEdit) qui modifient des 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, un débit limité peut se produire.

Limite de quota à l'échelle du projet

Les limites de quota par défaut suivantes sont partagées par 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 de quota de requêtes spécifiques à l'annonceur

Les méthodes qui spécifient un ID d'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 comportant un ID d'annonceur spécifié dans leur chemin d'URL (par exemple, celles destinées aux services advertisers.lineItems, advertisers.creatives ou advertisers.channels) seront décomptées des limites de quota suivantes:

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

Méthodes intensives en écriture

Les méthodes d'API suivantes sont intensives en écriture, ce qui signifie qu'elles utilisent une quantité importante de ressources du produit et, par conséquent, consomment plus de quota de requêtes d'écriture que d'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 d'écriture intensives (aucune d'entre elles ne spécifiant d'annonceur) effectuées en une minute seraient 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 intensives en écriture:

Dépassement des limites de quota

Dans l'éventualité peu probable que votre requête échoue en raison du dépassement d'une limite de requêtes API, 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.

La liste suivante indique les erreurs possibles et les actions recommandées en cas d'échec de requêtes causé par le dépassement des limites de requêtes API.

Code RPC Message Action recommandée
429 RESOURCE_EXHAUSTED La ressource a été épuisée (par exemple, vérifiez le quota). Examinez votre utilisation depuis la console Google API et modifiez votre workflow pour mieux paralléliser les requêtes effectuées pour différents annonceurs ou, plus généralement, ralentir le débit auquel vous envoyez des requêtes.

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