Обновление политики использования ресурсов Google Ads API

Среда, 1 мая 2024 г.

Что изменится?

Мы обновляем правила использования ресурсов Google Ads API, чтобы ограничить шаблоны запросов GoogleAdsService.Search и GoogleAdsService.SearchStream, которые потребляют чрезмерное количество ресурсов API. Если ограничение применяется к определенному шаблону запроса, другие сервисы, методы и шаблоны запросов продолжат работать без изменений.

Начиная с 17 июня 2024 г. запросы, соответствующие шаблонам запросов, для которых установлено ограничение, будут обрабатываться следующим образом:

  • Если вы используете версию API v17 или более раннюю, то получите ошибку QuotaError.RESOURCE_EXHAUSTED.
  • Если вы используете API версии 18 или более поздней, то получите сообщение об ошибке QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION или QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION в зависимости от того, в течение какого периода времени (короткого или длительного) наблюдалось чрезмерное потребление ресурсов.

Чтобы вам было проще выявлять и отслеживать отчеты, требующие больших затрат, мы также будем возвращать показатель стоимости для отдельных отчетов. Чтобы посмотреть стоимость успешно созданных отчетов, проверьте следующие поля:

Чем вызвано это изменение

Это изменение необходимо, чтобы обеспечить надежность и стабильность работы API.

Что нужно сделать

До 17 июня 2024 г. обновите свои приложения, чтобы они выполняли следующие действия:

  • Обрабатывайте новые коды ошибок при вызовах GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Если вы используете Google Ads API версии 17 или более ранней, обработайте ошибки QuotaError.RESOURCE_EXHAUSTED.
    • Если вы используете версию API 18 или более позднюю, обработайте ошибки QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION и QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Если один или несколько шаблонов запросов отчетов ограничены, проверьте и исправьте их. Вот несколько способов улучшить эффективность запросов:
    • Запускайте запрос реже.
    • Используйте менее ресурсоемкий шаблон запроса или представление.

Подробнее об оптимизации запросов…

  • Необязательно. Добавьте новый показатель query_resource_consumption в свои системы мониторинга, чтобы обнаруживать и обрабатывать новые ресурсоемкие запросы.

Куда обратиться за помощью

Если у вас есть вопросы об этом изменении или вам нужна помощь в оптимизации конкретных шаблонов запросов, посетите страницу поддержки Google Ads API.

– Дэвид Стивенс (David Stevens), менеджер по продукту, Google Ads API

Ярлыки: google-ads-api