Время от времени вам может потребоваться обновить старую основную версию Google Ads API до более новой основной версии. Это может быть связано с тем, что версия устарела или вы хотите использовать новую функцию. Мы рекомендуем всегда обновляться до последней версии.
Ознакомьтесь с нашим графиком прекращения поддержки , чтобы спланировать обновления. Ознакомьтесь с нашим руководством по управлению версиями , чтобы узнать, как работает управление версиями.
Вот контрольный список, который поможет вам начать процесс обновления:
- Ваша конечная точка изменится при изменении основных версий. Обновите клиентские библиотеки , чтобы использовать новейшую конечную точку.
- Просмотрите примечания к выпуску , чтобы увидеть изменения, внесенные в каждый выпуск.
- В таблицах ниже указаны конкретные области, на которые следует обратить внимание при обновлении версии.
Полный обзор изменений, основанных на различиях между прототипами двух версий, можно найти в таблице различий .
с v16 по v17
Изменения в сервисах и их компонентах | |
---|---|
Запросы GoogleAdsService Search и SearchStream | Ошибка, когда ваш запрос регулируется из-за его слишком высокой стоимости, будет либо |
Search запросы GoogleAdsService . | Передача |
Campaign и 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 , теперь приводят к более конкретным сообщениям об ошибках:
|
AudienceInsightsAttributeMetadata | Поле score было удалено. |
KeywordMatchTypeRecommendation | Если тип соответствия ключевого слова не задан, API теперь возвращает UNSPECIFIED вместо UNKNOWN для поля recommended_match_type . |