Google Реклама API версии 17 уже вышла

В Google Рекламе есть выпущенный выпуск основной версии Google Ads API, версия 17. Версия 17 включает подготовку к изменениям политики использования ресурсов, изменениям размера страниц, изменениям пакетной отчетности, дополнительным отчетам по PMax и типам соответствия, а также многому другому.

Опять же, это основной выпуск этого обновления: до этого была версия 16.1, а затем версия 16 в феврале 2024 года. До этого была версия 15 еще в октябре 2023 года. До этого была версия 14.1, выпущенная в августе. Этой новой версии предшествовала версия 13.1, выпущенная в апреле 2023 года. Версия 12.0 была выпущена в октябре 2022 года, версия 11.0 Google Ads API была выпущена в июне, а версия 11.1 — в августе. Также версия 10.1 была выпущена 27 апреля 2022 года, а версия 10.0 — 9 февраля 2022 года. А Google прекратил работу API AdWords 27 апреля, который полностью перестанет работать в конце июля.

Вот видеообзор изменений:

Вот полный журнал изменений:

Объявления

• Удален AdService.getAd. Это приводит AdService в соответствие с другими сервисами Google Ads API. Рекомендуемый способ получения рекламы и других типов ресурсов см. в разделе «Извлечение объектов».
• Добавлены дополнительные проверки для ImageAdInfo.image_asset относительно размеров и формата. Если изображение недействительно, могут возникнуть следующие ошибки: ImageError.UNEXPECTED_SIZE, ImageError.FORMAT_NOT_ALLOWED.

Ресурсы

• Добавлено новое перечисление: ClickType.AD_IMAGE.
• Добавлены следующие новые отчеты с новыми показателями для кампаний с максимальной эффективностью и поисковых кампаний: Campamp_aggregate_asset_view и Channel_aggregate_asset_view.

Аудитории

• Добавлен OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED.

Пакетные задания

• Добавлен BatchJobError.REQUEST_TOO_LARGE, который будет генерироваться, если отправленный запрос AddBatchJobOperationsRequest превышает 10484504 байта.
• Добавлена ​​поддержка настройки MutateOperation.asset_group_operation при использовании BatchJobService. Это позволяет использовать пакетную обработку для создания целых кампаний с максимальной эффективностью и управления ими. Смотрите наше новое специальное руководство.

Кампании

• Обнаружение переименовано в Генерирование спроса во всех полях, перечислениях и ошибках всех ресурсов в API Google Рекламы, таких как кампании, объявления и активы. Например, AdvertisingChannelType.DISCOVERY теперь называется AdvertisingChannelType.DEMAND_GEN.
• Добавлен Campaign.keyword_match_type, позволяющий установить тип соответствия ключевых слов для всех ключевых слов в кампании.

Конверсии

• Для конверсий SKAdNetwork сегменты.sk_ad_network_conversion_value переименованы в сегменты.sk_ad_network_fine_conversion_value. и добавлены сегменты.sk_ad_network_redistributed_fine_conversion_value.
• Следующие метрики теперь возвращаются вместе с ответом, даже если они равны нулю. Это делает их совместимыми с другими показателями. metrics.all_conversions_value_by_conversion_date, metrics.all_conversions_by_conversion_date, metrics.conversions_value_by_conversion_date, metrics.conversions_by_conversion_date

Критерии

• Добавлено в следующие поля AdGroupCriterion, чтобы показать, выполняется ли критерий группы объявлений или причины, по которым он не показывается: Primary_status и Primary_status_reasons.
• Добавлена ​​поддержка metrics.search_impression_share для гендера_view.
• Добавлена ​​поддержка metrics.phone_calls для ключевого слова_view.

Местные услуги

• Добавлен LocalServicesLeadService.AppendLeadConversation(), используемый для добавления нового LocalServicesLeadConversation к LocalServicesLead, который отправляет сообщения пользователям через соответствующие каналы, такие как SMS, в зависимости от того, как был создан интерес. Размер AppendLeadConversationRequest.conversations ограничен 1000. В Conversation.local_services_lead можно указать только LocalServicesLead с Lead_type, установленным в LeadType.MESSAGE.
• В ConversationType: WHATSAPP добавлены новые значения перечисления, представляющие беседу, инициированную через WhatsApp. ADS_API для представления диалога, введенного с помощью нового метода LocalServicesLeadService.AppendLeadConversation().
• В local_services_verification_artifact добавлены следующие новые поля: local_services_verification_artifact.insurance_verification_artifact.expiration_date_time и local_services_verification_artifact.license_verification_artifact.expiration_date_time.

Составление отчетов

• Теперь при запросе Product_link можно выбирать только поля, относящиеся к одному связанному продукту. Выбор нескольких полей нескольких связанных продуктов приведет к возникновению ошибки QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Например, Product_link.advertising_partner.customer и Product_link.data_partner.data_partner_id не могут быть выбраны в одном запросе.
• Передача page_size в GoogleAdsService.Search приведет к ошибке RequestError.PAGE_SIZE_NOT_SUPPORTED.

Покупка

• Добавлен новый отчет Shopping_product, который соответствует странице «Товары» в пользовательском интерфейсе Google Рекламы. Он поддерживает возврат данных о текущем состоянии продуктов из учетных записей Google Merchant Center, связанных с учетной записью Google Рекламы.
• Вы можете фильтровать показатели из отчета Shopping_product, используя сегменты.дата при использовании GoogleAdsService.Search или GoogleAdsService.SearchStream. Сегментация по дате не разрешена. В результате будет возвращена ошибка ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Единые цели

• Добавлен UserListCustomerTypeService.MutateUserListCustomerTypes() для настройки типов клиентов аудитории.
• Удален CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Чтобы настроить параметры аудитории для целей жизненного цикла клиента, используйте вместо этого UserListCustomerTypeService.MutateUserListCustomerTypes().
• Прикрепите или отсоедините список пользователей, задав для UserListCustomerType.customer_type_category значение UserListCustomerTypeCategory.PURCHASERS, чтобы включить его в существующее определение клиента или исключить из него для целей жизненного цикла клиента соответственно. Посетите раздел «Сегментируйте свою аудиторию», чтобы получить более подробную информацию.

Видео

• В ContentLabelType добавлены следующие значения. Вы можете исключить следующие ContentLabelTypes на уровне клиента: BRAND_SUITABILITY_CONTENT_FOR_FAMILIES, BRAND_SUITABILITY_GAMES_FIGHTING, BRAND_SUITABILITY_GAMES_MATURE, BRAND_SUITABILITY_HEALTH_SENSITIVE, BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED, BRAND_SUITABILITY, _NEWS_RECENT, BRAND_SUITABILITY_NEWS_SENSITIVE, BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED, BRAND_SUITABILITY_POLITICS, BRAND_SUITABILITY_RELIGION
• Добавлен AdVideoAsset.ad_video_asset_info для поддержки настроек инвентаря для видеоресурсов при создании DemandGenVideoResponsiveAdInfo.
• (Только учетные записи из белого списка) Campaign.video_brand_safety_suitability изменен.

Обсуждение на форуме Икс.