2026 年 5 月 1 日，星期五
自 2026 年 6 月 1 日起，Google Ads 和相关效果衡量 API 将针对精细效果统计信息（每天、每小时和每周）采用 37 个月的数据保留政策。高级别数据（按月、按季度和按年）将继续保留 11 年。
| API | 影响 | 后续步骤 |
| Google Ads API 和 Google Ads 脚本 | 自 2026 年 6 月 1 日起，如果查询请求的细粒度细分（例如 segments.date、segments.week）对应的时间范围超过当前日期之前 37 个月，系统将返回 DateRangeError.INVALID_DATE 错误。未来的 API 版本将返回 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED 错误。
如需检索 37 个月以前的数据，您必须更新查询以使用 segments.month、segments.quarter 或 segments.year。对历史数据进行的未细分查询必须与日历月边界（当月 1 日至最后一天）完全一致，才能正常执行。
|
请检查您的应用并进行更新。如果您需要 37 个月以前的细粒度历史数据，建议您在 2026 年 6 月 1 日这一截止日期前将其导出。
如果您有任何疑问，可以通过我们的 Google Ads API 支持渠道或 Google Ads 脚本支持渠道与我们联系。 |
| Google Analytics Data API | 如果报告中还使用了“日期”维度，Google Analytics Data API 会将受影响的指标截断为过去 36 个月的时间范围。受影响的指标包括“广告客户广告费用”“点击次数”和“展示次数”。只有同时满足以下条件的报告才会受到影响：包含所有受影响的指标、数据时间超过 37 个月，并且包含“日期”维度。“星期几”和“日期”等日期等效维度也会受到影响。 | 请检查您的数据拼接逻辑，以考虑这种截断情况。 |
| DV360 API 和 CM360 API | 这些 API 目前的保留期限为 24 个月，此期限保持不变。 | 无影响。 |
| BigQuery Data Transfer Service | 自 2026 年 6 月 1 日起，适用于 Google Ads 的 BigQuery Data Transfer Service 和适用于 Search Ads 360 的 BigQuery Data Transfer Service 连接器将停止为日期早于当前日期 37 个月的补填运行填充数据。已传输并存储在 BigQuery 中的数据将保留在表中，不受任何影响。
自 2026 年 6 月 1 日起，适用于 Google Analytics 4 的 BigQuery Data Transfer Service 连接器将停止为日期早于当前日期 37 个月的补填运行填充数据。已传输并存储在 BigQuery 中的数据将保留在表中，但如果手动触发了报告日期为 37 个月或更早的数据传输，BigQuery 表中该日期的数据将被空值覆盖。 |
如果您想在 BigQuery 中保留 37 个月以前的历史数据，建议您尽早开始回填运行，以便在 2026 年 6 月 1 日之前完成。 |
如果您有任何疑问或想讨论此帖子，请通过我们的“Google 广告和效果衡量社区”Discord 服务器与我们联系。
Nadine Wang，广告和衡量 API 团队
标签： google-ads-api、 google-ads-scripts、 google-analytics-api