Mise à jour des règles d'utilisation des ressources de l'API Google Ads

Mercredi 1er mai 2024

Ce qui change

Nous mettons à jour les règles d'utilisation des ressources de l'API Google Ads afin de limiter les schémas de requête GoogleAdsService.Search et GoogleAdsService.SearchStream qui consomment des quantités excessives de ressources API. Si un schéma de requête particulier est limité, les autres services, méthodes et schémas de requête continueront de fonctionner normalement.

À partir de la semaine du 17 juin 2024, et uniquement pour les schémas de requête limités, les requêtes seront affectées comme suit :

  • Si vous utilisez la version 17 ou une version antérieure de l'API, vous recevrez une erreur QuotaError.RESOURCE_EXHAUSTED.
  • Si vous utilisez la version v18 ou une version ultérieure de l'API, vous recevrez une erreur QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ou QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, selon que la consommation excessive de ressources a duré peu de temps (quelques minutes) ou longtemps.

Pour vous aider à identifier et à surveiller vos rapports coûteux, nous renverrons également une métrique de coût pour chaque rapport. Pour afficher le coût des rapports générés, consultez les champs suivants :

Pourquoi ce changement ?

Nous apportons ce changement pour préserver la fiabilité et la stabilité de l'API.

Que dois-je faire ?

Avant le 17 juin 2024, mettez à jour vos applications pour effectuer les opérations suivantes :

  • Gérer les nouveaux codes d'erreur lors des appels GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Si vous utilisez la version 17 ou une version antérieure de l'API Google Ads, gérez les erreurs QuotaError.RESOURCE_EXHAUSTED.
    • Si vous utilisez la version v18 ou une version ultérieure de l'API, gérez les erreurs QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION et QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Si un ou plusieurs de vos schémas de requête de reporting sont limités, vous devez les examiner et les corriger. Voici quelques façons d'améliorer les performances des requêtes :
    • Exécutez la requête moins fréquemment.
    • Utilisez un schéma de requête ou une vue moins coûteux.

Pour en savoir plus sur l'optimisation de vos requêtes, consultez Gérer l'efficacité des données.

  • [Facultatif] Intégrez la nouvelle métrique query_resource_consumption à vos systèmes de surveillance pour détecter et gérer les nouvelles requêtes coûteuses.

Obtenir de l'aide

Si vous avez des questions concernant ce changement ou si vous avez besoin d'aide pour optimiser des schémas de requête spécifiques, consultez la page d'assistance de l'API Google Ads pour connaître les options disponibles.

- David Stevens, responsable produit de l'API Google Ads

Libellés : google-ads-api