升级到最新版本

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

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

下面的核对清单可帮助您开始升级过程：

1. 当您更改主要版本时，您的端点将发生变化。请更新您的客户端库以使用最新端点。
2. 浏览版本说明，了解每个版本中引入的更改。
3. 请查看下表，了解您要升级到的版本需要重点关注的特定方面。

如需根据两个版本的 proto 之间的差异全面了解相关更改，请查看差异表。

v16 到 v17

服务及其组件的更改
GoogleAdsService Search 和 SearchStream 请求	如果您的请求因开销过高而受到限制时，错误将是 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 或 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION，而不是 QuotaError.RESOURCE_EXHAUSTED。如需了解详情，请参阅这篇博文。
GoogleAdsService Search 请求。	将 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	针对 product_link 运行 GoogleAdsService 搜索或搜索流请求时，您现在只能选择与一件关联商品相关的字段。如果从不同的关联产品中选择多个字段，则会导致 QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 错误。
通报失准	metrics.sk_ad_network_conversion_value 字段已重命名为 metrics.sk_ad_network_fine_conversion_value。

v15 到 v16

服务及其组件的更改
AccountLink	移除了 linked_account 中的 data_partner 和 google_ads 链接。请改用 ProductLinkService 和 ProductLinkInvitationService。
CampaignLifecycleGoal	之前，在更新现有 CampaignLifecycleGoal 时，您需要发出具有特定要求的 create 操作。现在，您可以改为发出 update 操作，就像对待其他资源类型一样。
Error Reporting	现在，返回一般性 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。