升级到最新版本

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

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

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

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

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

v17 到 v18

服务及其组件的更改
GoogleAdsService Search 和 SearchStream 请求

如果您的请求因开销过大而被节流，则错误将是 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 或 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION，而不是 QuotaError.RESOURCE_EXHAUSTED。查看博客 这篇帖子，了解更多详情。
GoogleAdsService summary_row_setting 和 SearchGoogleAdsRequest 中的 return_total_results_count 个字段 现在都属于新的 SearchSettings 对象。
AssetType DISCOVERY_CAROUSEL_CARD 枚举值已重命名为 DEMAND_GEN_CAROUSEL_CARD。这与之前的更改一致 将发现广告系列重命名为需求开发广告系列。
AudienceInsightsService.GenerateSuggestedTargetingInsights audience、baseline_audience 和 data_month 字段已移至 audience_definition 字段。
DemandGenCampaignSettings upgraded_targeting 字段的默认值现在为 true，而非 false。
LocalServicesLeadConversation 系统将不再为静态调用填充 phone_call_details.call_recording_url 字段。

v16 到 v17

服务及其组件的更改
GoogleAdsService Search 和 SearchStream 请求

如果查询开销过高，您的请求可能会遭到节流。如果是，您会收到 QuotaError.RESOURCE_EXHAUSTED 错误。查看博客 这篇帖子，了解更多详情。
GoogleAdsService Search 请求。

将 page_size 传递给 GoogleAdsService.Search 会导致 RequestError.PAGE_SIZE_NOT_SUPPORTED 错误。
Campaign和Ad

AdvertisingChannelType 为 DISCOVERY 的广告系列现在将改为 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。