Представляем Google Ads API версии 17

Среда, 5 июня 2024 г.

Мы рады сообщить о выпуске версии 17 Google Ads API. Чтобы использовать некоторые функции версии 17, вам потребуется обновить клиентские библиотеки и код клиента. Обновленные клиентские библиотеки и примеры кода будут опубликованы на следующей неделе.

Вот несколько основных моментов:

  • Чтобы подготовиться к изменению политики использования ресурсов, которое произойдет 17 июня 2024 г., мы добавили два новых значения в QuotaError. Они будут возвращаться при чрезмерном потреблении ресурсов в течение определенного периода времени шаблоном запроса для запросов GoogleAdsService.Search() и GoogleAdsService.SearchStream().
  • Поле page_size всегда имеет значение 10 000, и вы больше не можете передавать page_size в GoogleAdsService.Search. В противном случае возникнет ошибка RequestError.PAGE_SIZE_NOT_SUPPORTED.
  • Добавлены поля campaign_aggregate_asset_view и channel_aggregate_asset_view, позволяющие получать больше показателей для кампаний с максимальной эффективностью и поисковых кампаний.
  • Изменения в пакетной обработке:
  • Добавлено поле Campaign.keyword_match_type, позволяющее задавать тип соответствия для всех ключевых слов в кампании.
  • Удален метод AdService.getAd, чтобы привести сервис в соответствие с другими сервисами в Google Ads API. Рекомендации по получению ресурсов приведены в разделе Получение объектов.
  • В AdGroupCriterion добавлены поля primary_status и primary_status_reasons, которые позволяют узнать, показывается ли критерий группы объявлений, и если нет, то почему.
  • Добавлен новый отчет shopping_product, который соответствует странице Товары в интерфейсе Google Рекламы.
  • Добавлены дополнительные проверки для ImageAdInfo.image_asset, касающиеся размеров и формата, что делает их более согласованными с другими проверками изображений в Google Ads API.
  • Добавлен столбец segments.sk_ad_network_redistributed_fine_conversion_value, в котором значения NULL перераспределяются между другими значениями на основе модели машинного обучения, использующей недавние данные, возвращенные SkAdNetwork.
  • Название Discovery изменено на Кампания для создания спроса во всех полях, перечислениях и ошибках всех ресурсов в Google Ads API.
  • Теперь при запросе к product_link можно выбирать только поля, связанные с одним связанным продуктом. В противном случае будет возвращена ошибка QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
  • Добавлено поле UserListCustomerTypeService.MutateUserListCustomerTypes() для настройки типов клиентов для аудиторий. Этот метод заменяет использование CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
  • Добавлены два поля expiration_date_time local_services_verification_artifact, чтобы рекламодатели могли отслеживать срок действия своих объектов.

Где найти подробную информацию?
Ниже приведены ресурсы, которые помогут вам начать работу.

Если у вас есть вопросы или вам нужна помощь, свяжитесь с нами на форуме.

Портрет автора – Танет Кнак Пранинарарат (Thanet Knack Praneenararat), от имени команды Google Ads API

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