2024 年 6 月 5 日，星期三
今天，我们宣布推出 v17 版 Google Ads API。如需使用 v17 的某些功能，您需要升级客户端库和客户端代码。更新后的客户端库和代码示例将于下周发布。以下是主要亮点：
- 为了准备将于 2024 年 6 月 17 日实施的资源使用政策变更，我们向
QuotaError添加了两个新值，当查询句式在一段时间内因GoogleAdsService.Search()和GoogleAdsService.SearchStream()请求而消耗过多资源时，系统会抛出这些值。 page_size字段始终设置为 10,000，您无法再将page_size传递给GoogleAdsService.Search。否则会导致RequestError.PAGE_SIZE_NOT_SUPPORTED错误。- 添加了
campaign_aggregate_asset_view和channel_aggregate_asset_view，用于报告效果最大化广告系列和搜索广告系列的更多指标。 - 批处理变更：
- 添加了对使用
BatchJobService时设置MutateOperation.asset_group_operation的支持。这样，您就可以使用批处理来制作和管理整个效果最大化广告系列。 - 添加了
BatchJobError.REQUEST_TOO_LARGE错误，用于在提交大于 10,484,504 字节的AddBatchJobOperationsRequest时显示。您应将这些操作分成较小的组，并作为单独的请求发送。
- 添加了对使用
- 添加了
Campaign.keyword_match_type，以便为广告系列中的所有关键字设置关键字匹配类型。 - 移除了
AdService.getAd，以使该服务与 Google Ads API 中的其他服务保持一致。如需了解有关如何提取资源的建议，请参阅检索对象。 - 向
AdGroupCriterion添加了primary_status和primary_status_reasons，以显示广告组条件是否正在投放，或未投放的原因。 - 添加了新报告
shopping_product，该报告对应于 Google Ads 界面的产品页面。 - 针对
ImageAdInfo.image_asset添加了更多关于尺寸和格式的验证，使其与 Google Ads API 中的其他图片验证更加一致。 - 添加了
segments.sk_ad_network_redistributed_fine_conversion_value，该功能会根据机器学习模型，利用新近的 SkAdNetwork 回传数据，将NULL值重新分配给其他值。 - 在 Google Ads API 的所有资源中，将所有字段、枚举和错误中的 Discovery 重命名为 Demand Gen。
- 现在，在查询
product_link时，您只能选择与一个关联产品相关的字段。否则，系统会抛出QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE。 - 添加了
UserListCustomerTypeService.MutateUserListCustomerTypes()，用于配置受众群体客户类型。此方法取代了CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings的使用。 - 添加了两个 expiration_date_time 字段
local_services_verification_artifact，以便广告客户更好地监控其工件何时过期。
在哪里可以获得更多信息？
以下资源可帮助您开始使用：
如果您有任何问题或需要其他帮助，请通过论坛与我们联系。
- Thanet Knack Praneenararat，代表 Google Ads API 团队
标签： google-ads-api、 release