升级到最新版本

您可以定期从 Google Ads API 的较旧主要版本升级到较新的主要版本。这可能是因为某个版本即将停用,也可能是因为您想要使用新功能。我们建议您始终升级到最新版本。

请查看我们的弃用时间表,规划您的升级。请参阅我们的版本控制指南,了解版本控制的工作原理。

以下核对清单可帮助您开始升级:

  1. 当您更改主要版本时,您的端点也会随之更改。更新客户端库以使用最新的端点。
  2. 浏览版本说明,了解每个版本中引入的更改。
  3. 请查看下面的表格,了解您升级到的目标版本需要重点关注哪些特定方面。

如需全面了解这两个版本的 proto 之间的差异,请查看差异表

v15 到 v16

服务及其组件的更改
AccountLink linked_account 中的 data_partnergoogle_ads 关联已被移除。请改用 ProductLinkServiceProductLinkInvitationService
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 现在会针对 recommended_match_type 字段返回 UNSPECIFIED,而不是 UNKNOWN

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