功能弃用和无版本控制的变更

此页面会跟踪 Google Ads API 中的功能弃用和无版本变更。如需了解完整的版本详细信息，请参阅版本说明。

请定期关注 Google Ads 开发者博客，以便率先了解即将弃用的功能。

计划弃用的功能

下表列出了 Google Ads API 计划在生效日期弃用的具体功能和变更。如需详细了解每项弃用，请参阅相关博文。

功能 说明 生效日期 其他说明
数据保留政策变更 细粒度报告数据（按天、按小时、按周）的保留期限将缩短为 37 个月。高级别数据（每月、每季度、每年）仍可保留 11 年。 2026 年 6 月 1 日 如需了解详情，请参阅我们的博文。
线下转化支持服务发生变化

自 2026 年 6 月 15 日起，如果开发者令牌近期未曾发出线下转化请求，则必须使用 Data Manager API 来完成线下转化工作流程。

  • 如果您的开发者令牌在 2025 年 12 月 17 日至 2026 年 6 月 15 日期间发送了 UploadClickConversions 请求，您可以继续将该开发者令牌与 Google Ads API 搭配使用，以实现线下转化工作流。 不过，我们建议您将线下转化工作流程升级为 Data Manager API，以获得更好的开发者体验并使用更多功能。
  • 否则，自 2026 年 6 月 15 日起，任何 UploadClickConversions 请求都会失败并显示错误 CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE。 对于线下转化工作流，请使用 Data Manager API，而不是 Google Ads API。
2026 年 6 月 15 日 如需了解详情，请参阅我们的博文。
目标客户匹配支持方面的变更

自 2026 年 4 月 1 日起，如果开发者令牌近期没有发出目标客户匹配请求，则必须使用 Data Manager API 来完成目标客户匹配工作流程。

April 1, 2026 如需了解详情，请参阅我们的博文。
IP 地址和会话属性支持方面的变更 Google Ads API 不再接受新用户在转化导入过程中使用会话属性或 IP 地址数据。现有用户应迁移到 Data Manager API。 2026 年 2 月 2 日 如需了解详情，请参阅我们的博文。
来电专用广告弃用 无法制作新的来电专用广告。现有的来电专用广告将于 2027 年 2 月停止投放，并且 API 支持将被移除。广告客户应改用包含电话素材资源的自适应搜索广告。 2026 年 1 月 如需了解详情，请参阅我们的博文。

未纳入版本控制的功能变更

以下未进行版本控制的更新和行为变化发生在近期的 API 版本中。

版本 更改区域 更改类型 指南和说明
v24
v24 自适应需求开发视频广告 行为转变 在制作或更改自适应需求开发视频广告时，提供 videos 和 logo_images（现在是必需的）。
v24 自适应视频广告 行为转变 在创建或更改视频自适应广告时，请提供 videos、business_name 和 logo_images（现在是必需的）。请注意，VideoResponsiveAdInfo 现在是可变的。
v24 ShareablePreviewService.GenerateShareablePreviews 行为转变 如果其中任何 ID 验证失败，请求将失败（不允许部分失败）并抛出错误。
v24 ShareablePreviewError 个旧版代码 行为转变 修改了为素材资源组返回的错误代码，使其与广告组广告错误保持一致。