Quota

Le quota de l'API Display & Video 360 limite la fréquence à laquelle un projet peut envoyer des requêtes à l'API.

Suivez ces bonnes pratiques pour mieux utiliser votre quota d'API Display & Video 360.

Envoyer des requêtes à plusieurs annonceurs en même temps

Le quota de l'API Display & Video 360 est défini par projet et par annonceur. Les limites de quota de projet limitent les requêtes effectuées par un projet. Le quota d'annonceur limite le nombre de demandes qu'un projet peut envoyer à un annonceur.

Pour utiliser l'intégralité du quota de votre projet, envoyez des requêtes à plusieurs annonceurs en même temps.

Utiliser les paramètres de requête list

Utilisez les paramètres de requête de la méthode list pour n'inclure que les ressources souhaitées. Moins de ressources signifie moins de requêtes pour les lister.

Les méthodes list offrent trois paramètres clés :

  • pageSize définit le nombre de ressources pouvant être renvoyées par la requête. La taille de page par défaut dépend de la méthode. Définissez cette valeur sur la plus élevée pour lister plus de ressources par requête.
  • filter limite les ressources listées en fonction des critères fournis. Définissez cette option pour n'afficher qu'un sous-ensemble de ressources. Pour en savoir plus, consultez Requêtes de liste de filtres.
  • orderBy ordonne les ressources listées selon la propriété donnée. Définissez cette valeur pour récupérer le plafond ou le plancher de la liste de ressources avec moins de requêtes.

Utiliser des fonctions groupées et à l'échelle des ressources

Les fonctions groupées et à l'échelle des ressources permettent d'effectuer des tâches complexes. Une seule requête envoyée à ces méthodes peut remplacer plusieurs requêtes envoyées à d'autres.

Pour en savoir plus sur ces méthodes, consultez la section Requêtes groupées.

ID de cache

De nombreuses actions de l'API Display & Video 360 nécessitent des ID récupérés à l'aide de l'API. Par exemple, les ID d'option de ciblage et les ID d'audience Google. Stockez les ID en local pour ne pas avoir à les récupérer en permanence.

L'utilisation d'ID pour des ressources obsolètes ou supprimées peut renvoyer une erreur. Vous devez récupérer les ID mis en cache chaque semaine pour confirmer leur état.

Utiliser un intervalle exponentiel entre les tentatives

L'intervalle exponentiel entre les tentatives est une stratégie de gestion des erreurs. Il relance les requêtes avec un délai croissant.

Lors de l'interrogation d'une tâche de longue durée, telle qu'une tâche de téléchargement de fichier SDF, une stratégie d'intervalle exponentiel entre les tentatives peut réduire le nombre de requêtes envoyées.

Nos exemples de code de téléchargement SDF utilisent l'intervalle exponentiel entre les tentatives avec nos bibliothèques clientes. Voici un exemple de flux d'intervalle exponentiel entre les tentatives :

  • Récupérez l'objet Operation avec la requête get.
    • Si done n'est pas défini sur "true", la tâche est toujours en cours d'exécution.
    • Vous patientez 5 secondes + un nombre aléatoire de secondes, puis vous relancez la requête.
  • Récupérez l'opération.
    • Si done n'est pas défini sur "true", la tâche est toujours en cours d'exécution.
    • Vous patientez 10 secondes + un nombre aléatoire de secondes, puis vous relancez la requête.
  • Récupérez l'opération.
    • Si done n'est pas défini sur "true", la tâche est toujours en cours d'exécution.
    • Vous patientez 20 secondes + un nombre aléatoire de secondes, puis vous relancez la requête.
  • Récupérez l'opération.
    • Si done n'est pas défini sur "true", la tâche est toujours en cours d'exécution.
    • Attendez 40 secondes + un nombre aléatoire de secondes, puis relancez la requête.
  • Récupérez l'opération.
    • Si done n'est pas défini sur "true", la tâche est toujours en cours d'exécution.
    • Attendez 80 secondes + un nombre aléatoire de secondes, puis relancez la requête.
  • Continuez ce schéma jusqu'à ce que done soit défini sur "true" ou qu'un temps maximal écoulé soit atteint.