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

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

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

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

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

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

с 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 .

с v14 по v15

Изменения в сервисах и их компонентах
AssetGroupListingGroupFilter Поле vertical перечисления было переименовано feed_type .
MediaFileService Услуга удалена, так как она больше не нужна. См. изменение ImageAdInfo ниже.
ImageAdInfo Поле media_file было заменено на image_asset .
MerchantCenterLinkService Служба была заменена на ProductLinkInvitationService и ProductLinkService .
Campaign.ShoppingSetting Поле sales_country было удалено. Информация теперь возвращается в feed_label .
ProductBiddingCategoryConstant Заменено на ProductCategoryConstant . Несколько полей были переименованы соответствующим образом, см. следующие три изменения ниже.
ListingDimensionInfo Поле product_bidding_category заменено на product_category .
ListingGroupFilterDimension Поле product_bidding_category заменено на product_category .
отчет shopping_performance_view Следующие поля сегмента:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
были заменены на:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting Удалена поддержка создания поисковых кампаний с этим полем.
CampaignCriterion.listing_scope Удалена поддержка создания поисковых кампаний с этим полем.
отчет sk_ad_network_conversions metrics.sk_ad_network_conversions заменен на metrics.sk_ad_network_installs .
OfflineConversionClientSummary Поле offline_conversion_client_summaries перенесено из Customer в ресурс верхнего уровня, к которому можно запрашивать отдельно.

Измените свой запрос с:

SELECT customer.offline_conversion_client_summaries
FROM customer
до:
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

Используйте построитель запросов , чтобы изучить список доступных полей для выбора и фильтрации.

OfflineConversionUploadAlert Переименован в OfflineConversionAlert .
OfflineConversionUploadError Переименован в OfflineConversionError .
AdNetworkType Перечисления YOUTUBE_SEARCH и YOUTUBE_WATCH были объединены в одно перечисление: YOUTUBE .