您会定期从 Google Ads API 的较旧主要版本升级到较新的主要版本。这可能是因为某个版本即将弃用,也可能是因为您想要使用新功能。我们建议您始终升级到最新版本。
请查看我们的弃用时间表以规划您的升级。如需了解版本控制的工作原理,请参阅我们的版本控制指南。
下面的核对清单可帮助您开始升级过程:
如需根据两个版本的 proto 之间的差异全面了解相关更改,请查看差异表。
v16 到 v17
服务及其组件的更改 | |
---|---|
GoogleAdsService
Search 和 SearchStream 请求 |
如果您的请求因开销过高而受到限制时,错误将是 |
GoogleAdsService
Search 请求。 |
将 |
Campaign 和 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 错误的两种情况会导致更具体的错误消息:
|
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 报告 |
以下细分字段:
|
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 。
|