什麼是 Google Search Console 的大量資料匯出?
成效報表與資料
大量資料匯出是 Search Console 的一項設定,每天會將資源的成效資料傳送到你自己 Google Cloud 專案中的 BigQuery 資料集。它包含 Search Console 擁有的每一列資料,罕見查詢也會以不含查詢文字的資料列形式保留,而且不受 16 個月的限制:資料會持續累積,直到你自行刪除為止。匯出只會從你啟用的那一天開始,超出 BigQuery 免費用量的儲存空間與查詢費用則由你負擔。
它能提供報表和 API 做不到的哪些功能
| 成效報表 | Search Analytics API | 大量資料匯出 | |
|---|---|---|---|
| 資料列數 | 每個表格或匯出檔 1,000 列 | 每種搜尋類型每天最多 50,000 列 | 所有資料列 |
| 歷史資料 | 16 個月 | 16 個月 | 從設定當天開始,保留到你刪除為止 |
| 罕見(匿名化)查詢 | 不顯示於表格,但計入總計 | 同左 | 以空查詢的資料列形式保留 |
| 費用 | 免費 | 不產生 Cloud 帳單,但有配額限制 | BigQuery 儲存與查詢費用 |
| 所需投入 | 無 | 程式碼與 OAuth | Cloud 專案與 SQL |
開始之前
- 你需要擁有 Search Console 資源的擁有者權限。
- 你需要一個已啟用計費功能的 Google Cloud 專案。
- 在該專案中,前往 API 和服務 > 已啟用的 API 和服務,啟用 BigQuery API 和 BigQuery Storage API。
如何設定大量資料匯出
- 在 Cloud 控制台中,開啟 IAM 與管理,然後選擇授予存取權。
- 新增主體
search-console-data-export@system.gserviceaccount.com,並指派兩個角色:BigQuery 工作使用者和 BigQuery 資料編輯者,然後儲存。 - 在 Search Console 中,開啟設定 > 大量資料匯出。
- 輸入 Cloud 專案 ID(不是專案編號)。
- 選擇資料集名稱。預設為
searchconsole,所有名稱都必須以此開頭,且匯出到同一專案的每個資源都需要各自的資料集。 - 請謹慎選擇資料集位置:匯出開始後,Google 不支援變更位置。
- 選擇繼續。第一次匯出會在 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_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與日曆比對。 - 停止匯出。 在設定頁面中選擇停用匯出,匯出會在 24 小時內停止。現有的資料表會保留在 BigQuery 中。
你需要它嗎?
如果你需要每一筆長尾查詢、每個 URL 的搜尋外觀標記,或要與公司其他資料進行 SQL 聯結,那麼答案是需要。如果你主要是想在一般報表中查看超過 16 個月的歷史資料,AutoPSEO 的已儲存資源就能做到,而且不需要 Cloud 專案:開啟完整儲存後,它會回填 16 個月的資料,之後每天為網頁搜尋儲存最多 25,000 列查詢、頁面以及查詢加頁面的資料,最長保留十年。這比所有資料列少,但對大多數網站來說已綽綽有餘。請參閱管理、Search Console 會保留資料多久以及 Search Console API。