您可以定期从 Google Ads API 的较旧主要版本升级到较新的主要版本。这可能是因为某个版本即将停用,也可能是因为您想要使用新功能。我们建议您始终升级到最新版本。
请查看我们的弃用时间表,规划您的升级。请参阅我们的版本控制指南,了解版本控制的工作原理。
以下核对清单可帮助您开始升级:
如需全面了解这两个版本的 proto 之间的差异,请查看差异表。
v15 到 v16
服务及其组件的更改 | |
---|---|
AccountLink |
linked_account 中的 data_partner 和 google_ads 关联已被移除。请改用 ProductLinkService 和 ProductLinkInvitationService 。 |
CampaignLifecycleGoal |
以前更新现有 CampaignLifecycleGoal 时,您将发出具有特定要求的 create 操作。现在,您可以改为发出 update 操作,就像对其他资源类型一样。 |
错误报告 | 现在,返回常规 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 。
|