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

Время от времени вам может потребоваться обновить старую основную версию 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 .