Google Search Console 中的批量数据导出是什么？

批量数据导出是 Search Console 的一项设置，每天一次，把媒体资源的效果数据发送到你自己的 Google Cloud 项目中的 BigQuery 数据集。它包含 Search Console 拥有的每一行数据，其中罕见查询会以不含查询文本的行保留下来。它不受 16 个月的限制：数据会持续累积，直到你自行删除。它只从你启用的那一天开始导出，超出 BigQuery 免费额度的存储和查询费用由你承担。

它能提供报告和 API 无法提供的哪些能力

开始之前

• 你需要拥有 Search Console 媒体资源的所有者权限。
• 你需要一个已启用结算功能的 Google Cloud 项目。
• 在该项目中，前往 APIs & Services > Enabled APIs & Services，启用 BigQuery API 和 BigQuery Storage API。

如何设置批量数据导出

1. 在 Cloud 控制台中，打开 IAM and Admin，选择 Grant access。
2. 添加主账号 search-console-data-export@system.gserviceaccount.com，并授予两个角色：BigQuery Job User 和 BigQuery Data Editor。保存。
3. 在 Search Console 中，打开 Settings > Bulk data export。
4. 输入 Cloud 的项目 ID（不是项目编号）。
5. 选择数据集名称。默认名称为 searchconsole，所有名称都必须以它开头，且导出到同一项目的每个媒体资源都需要各自的数据集。
6. 请谨慎选择数据集位置：开始导出后，Google 不支持更改该位置。
7. 选择 Continue。首次导出会在 48 小时内到达，内容涵盖其运行当天的数据。

表创建完成后，你可以设置分区过期时间（14 天或更长）来限制存储量。请勿添加或修改列：架构变更会导致导出失败。

BigQuery 中会生成什么

• searchdata_site_impression：按媒体资源汇总的效果数据，与 Search Console 图表中的总计类似。没有 URL 列。
• searchdata_url_impression：按 URL 汇总，每种搜索外观对应一列(例如 is_job_listing)，另有 is_anonymized_discover 标记。
• ExportLog：每次成功导出，每个表对应一行。每当 Google 用更正后的数据重写某一天的数据时，其 epoch_version 就会增加。

日期采用太平洋时间。行数据并未预先聚合，因此请始终对指标使用 SUM()。位置从零开始计数且为累加值，所以在站点表中，平均排名为 SUM(sum_top_position) / SUM(impressions) + 1；在 URL 表中则把 sum_top_position 换成 sum_position，其余相同。

下面是查询上个月热门网页搜索查询的起始示例：

SELECT
  query,
  SUM(clicks) AS clicks,
  SUM(impressions) AS impressions,
  SUM(sum_top_position) / SUM(impressions) + 1 AS avg_position
FROM `your-project.searchconsole.searchdata_site_impression`
WHERE data_date BETWEEN '2026-09-01' AND '2026-09-30'
  AND search_type = 'WEB'
  AND query != ''
GROUP BY query
ORDER BY clicks DESC
LIMIT 100

请始终按 data_date 过滤。这些表按日期分区，日期过滤条件可以避免每次查询扫描（并计费）你的全部历史数据。

限制与故障情形

• 不会回溯。 设置之前的数据只能通过 API 或报告获取。
• 故障会中断导出。 出错后，Search Console 会在第二天重试，并将未导出的数据保留约一周。连续失败约一个月后，导出会彻底停止。导出失败或恢复时，所有者和完整权限用户会收到电子邮件。
• 缺口可能是永久性的。 Google 的数据异常页面记录显示，2026 年 2 月 28 日和 3 月 1 日的数据在部分媒体资源的导出中缺失，且无法恢复。请定期对照日历检查 ExportLog。
• 停止导出。 在设置页面点击 Deactivate export 后，导出会在 24 小时内停止。已有的表仍保留在 BigQuery 中。

你需要它吗？

如果你需要每一个长尾查询、每个 URL 的搜索外观标记，或需要用 SQL 与公司其他数据做关联，那就需要。如果你主要想为常规报告保留 16 个月以前的历史数据，那么 AutoPSEO 中的存储型媒体资源无需 Cloud 项目即可做到：开启完整存储后，它会回填 16 个月的数据，然后每天为网页搜索保存最多 25,000 行查询、页面以及查询加页面的数据，最长保留十年。这比保存每一行要少，但对大多数网站来说完全够用。参见管理、Search Console 保留数据多长时间以及 Search Console API。

来源：Google 的批量数据导出概览、设置、监控、表参考和示例查询。