Обновите до последней версии

Время от времени вам может потребоваться обновить старую основную версию Google Ads API до более новой основной версии. Это может быть связано с тем, что версия устарела или вы хотите использовать новую функцию. Мы рекомендуем всегда обновляться до последней версии.

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

Вот контрольный список, который поможет вам начать процесс обновления:

  1. Ваша конечная точка изменится при изменении основных версий. Обновите клиентские библиотеки , чтобы использовать новейшую конечную точку.
  2. Просмотрите примечания к выпуску , чтобы увидеть изменения, внесенные в каждый выпуск.
  3. В таблицах ниже указаны конкретные области, на которые следует обратить внимание при обновлении версии.

Полный обзор изменений, основанных на различиях между прототипами двух версий, можно найти в таблице различий .

с v16 по v17

Изменения в сервисах и их компонентах
Запросы GoogleAdsService Search и SearchStream

Ошибка, когда ваш запрос регулируется из-за его слишком высокой стоимости, будет либо QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION , либо QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION вместо QuotaError.RESOURCE_EXHAUSTED . Более подробную информацию можно найти в сообщении в блоге .

Search запросы GoogleAdsService .

Передача page_size в GoogleAdsService.Search приведет к ошибке RequestError.PAGE_SIZE_NOT_SUPPORTED .

Campaign и Ad

Кампании с AdvertisingChannelType DISCOVERY теперь будут иметь AdvertisingChannelType DEMAND_GEN .

Кроме того, для некоторых объявлений будут изменены тип и названия полей для отчетов:

  • DISCOVERY_MULTI_ASSET_ADD станет DEMAND_GEN_MULTI_ASSET_ADD , а соответствующее поле отчета ad_group_ad.ad.discovery_multi_asset_ad станет ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD станет DEMAND_GEN_CAROUSEL_AD , а соответствующее поле отчета ad_group_ad.ad.discovery_carousel_ad станет ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD станет DEMAND_GEN_VIDEO_RESPONSIVE_AD , а соответствующее поле отчета ad_group_ad.ad.discovery_video_responsive_ad станет ad_group_ad.ad.demand_gen_video_responsive_ad

AdService Конечная точка GetAd будет удалена. Это приводит AdService в соответствие с другими сервисами Google Ads API. Рекомендуемый способ получения рекламы и других типов ресурсов см. в нашем руководстве по извлечению объектов .
CustomerLifecycleGoal и CampaignLifecycleGoal Изменен способ управления сегментами для достижения целей жизненного цикла. Полный обзор см. в разделе «Сегментируйте аудиторию» документации по целям жизненного цикла.
ProductLink При запуске запроса GoogleAdsService или потока поиска для product_link вы теперь можете выбирать только поля, относящиеся к одному связанному продукту. Выбор нескольких полей из разных связанных продуктов приведет к ошибке QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE .
Составление отчетов Поле metrics.sk_ad_network_conversion_value переименовано в metrics.sk_ad_network_fine_conversion_value .

с v15 по v16

Изменения в сервисах и их компонентах
AccountLink Ссылки data_partner и google_ads в linked_account удалены. Вместо этого используйте ProductLinkService и ProductLinkInvitationService .
CampaignLifecycleGoal Ранее при обновлении существующего CampaignLifecycleGoal вам нужно было выполнить операцию create с конкретными требованиями. Теперь вместо этого вы можете выполнить операцию update , как и в случае с другими типами ресурсов.
Отчет об ошибках Два случая, когда была возвращена общая ошибка ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT , теперь приводят к более конкретным сообщениям об ошибках:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata Поле score было удалено.
KeywordMatchTypeRecommendation Если тип соответствия ключевого слова не задан, API теперь возвращает UNSPECIFIED вместо UNKNOWN для поля recommended_match_type .