
Google 搜索控制台(Search Console)绩效报告 API 新增元数据字段,用于标识不完整数据点。该更新旨在为开发者提供数据状态上下文,特别是在请求最新数据时,可明确显示数据来源的具体时间节点,帮助准确识别数据收集与处理的起止时间。
新增元数据字段说明
当使用 all 或 hourly_all 作为 dataState 请求近期数据时,返回的部分行可能因数据仍在处理中而不完整。新增的元数据对象包含以下两个值,所有日期和时间均基于 America/Los_Angeles 时区:
first_incomplete_date
表示数据仍处于收集和处理阶段的第一个日期,格式为 YYYY-MM-DD(ISO-8601 扩展本地日期格式)。该字段仅在满足以下条件时填充:dataState 为 all、数据按日期分组,且请求范围内包含不完整数据点。需注意,此日期之后的所有数值仍可能发生显著变化。
first_incomplete_hour
表示数据仍处于收集和处理阶段的第一个小时,格式为 YYYY-MM-DDThh:mm:ss[+|-]hh:mm(ISO-8601 扩展偏移日期时间格式)。该字段仅在满足以下条件时填充:dataState 为 hourly_all、数据按小时分组,且请求范围内包含不完整数据点。同样,此时段之后的所有数值仍存在变动可能。
更多技术细节建议查阅 Google 官方相关文档。

