擷取作業檢視器

透過「擷取檢視器」(可從「動作中心」的「擷取」>「記錄」存取)，即可近乎即時地掌握在地興趣點動態消息的狀態、驗證健康狀態和處理記錄。

使用擷取檢視器追蹤每日動態饋給上傳作業、監控擷取健康狀態、檢查項目層級的驗證錯誤統計資料，以及確認動態饋給檔案是否已送達。

總覽

主要「擷取檢視器」頁面會顯示 Google 收到的所有動態饋給記錄，並依時間反向排序。

擷取生命週期階段

每個動態饋給提交作業都會依序經過下列處理階段：

  1. 檔案擷取：Google 會使用 SFTP 接收動態饋給檔案。
  2. 檔案驗證：系統會驗證檔案完整性、解壓縮情形和整體結構定義格式。
  3. 實體擷取和驗證：管道會剖析個別的本機記錄 (poi_id、地址、座標、本地化)，並檢查語法、完整性和政策遵循情形。
  4. 對帳和比對：有效實體會傳送至 Google 的比對引擎，與標準 Google 地點 ID 建立連結，以利放送。
  5. 產生報表：系統會將摘要指標和分組問題診斷結果發布至擷取檢視器。

如要查看動態饋給擷取記錄，請完成下列步驟：

  1. 登入Actions Center。
  2. 開啟「Ingestion」>「History」頁面。
  3. 使用資料欄控制項篩選、排序及查看擷取資料表。

擷取清單資料欄

主要摘要表格會為每次擷取作業提供下列欄位：

欄 資料類型 說明
ID String 擷取作業的專屬 ID。
擷取時間 (世界標準時間) Timestamp Google 開始處理動態饋給擷取的日期和時間 (世界標準時間)。
擷取類型 Enum 資料擷取類型 (例如 Feed)。
名稱 String 動態饋給擷取類型的名稱。這會是 google.local_vss。
狀態 State 擷取作業的整體處理狀態 (例如「完成」或「失敗」)。請參閱狀態定義。
擷取行為 Enum 所有本機 POI 動態饋給都會以 Batch 模式處理。
錯誤 Integer 偵測到的驗證問題總數 (錯誤層級)。
警告 Integer 偵測到的非阻斷性警告層級問題總數。
項目 Integer 本次擷取作業處理的店面房源總數。

狀態定義

「狀態」欄會顯示動態消息提交作業目前的運作狀態：

  • 完成 (STATUS_COMPLETE)：動態饋給已順利擷取、驗證及處理，未發生嚴重錯誤。
  • 失敗 (STATUS_FAILED)：擷取作業遇到嚴重結構定義、檔案損毀或管道錯誤，因此無法完成。
  • 處理中 (STATUS_PROCESSING)：Google 正在驗證、比對及儲存動態饋給資料。
  • 已略過 (NOT_STARTED)：系統已略過動態饋給上傳作業 (例如，如果生成時間戳記比先前處理的動態饋給舊)。

「擷取詳細資料」檢視畫面

按一下「擷取檢視器」表格中的任一行，開啟「擷取詳細資料檢視」。這個檢視畫面提供完整的診斷資訊卡和展開面板，可供偵錯。

詳細資料面板

「擷取詳細資料」頁面分為四個可展開的部分：

1. 基本資訊

顯示執行作業的核心中繼資料：

  • 擷取時間 (世界標準時間)：Google 開始擷取資料的時間戳記。
  • 擷取類型： Feed。
  • 名稱： google.local_vss
  • 擷取行為： Batch
  • 狀態：以顏色區分的狀態徽章 (Done、Failed、Processing、Skipped)。

2. 驗證

列出擷取期間遇到的所有驗證結果：

  • 檔案錯誤 (附註方塊)：如果整個動態饋給檔案失敗 (例如，因無法讀取的封存檔或格式錯誤的 JSON 語法)，系統會顯示顯眼的警告附註，說明根本原因訊息。
  • 實體問題 (手風琴式表格)：依嚴重程度和錯誤代碼分組的項目層級驗證問題。
    • 問題代碼：特定錯誤 ID (例如 INVALID_ATTRIBUTE_VALUE、MISSING_RECOMMENDED_FIELD 或 SAFE_SEARCH_POLICY_VIOLATION_TEXT)。
    • 問題資訊：診斷說明，解釋根本原因和受影響的欄位。
    • 記錄：受這個問題影響的資源實體總數。
    • 按一下任一問題列，即可展開範例實體 ID (poi_id)，並透過直接連結在商品目錄檢視器中檢查屬性。

3. 項目

提供擷取作業的項目層級廣告空間差異評估表：

  • 總數：處理的店面房源總數。
  • 已新增：新增至目錄的新發現商家資訊數量。
  • 已變更：屬性 (例如名稱、地址、座標或圖片) 經過更新的現有房源數量。
  • 已移除：與先前的動態饋給基準相比，已捨棄或省略的屬性數量。

4. 檔案

顯示上傳的動態饋給檔案名稱：

  • 檔案名稱：動態饋給檔案的名稱 (例如 local_feed.json.gz)。

排解擷取失敗問題

在擷取檢視器中排解動態饋給問題時，請遵循下列指南：

問題 可能原因 建議做法
狀態為Failed「有檔案錯誤」 ZIP/GZIP 封存檔已損毀、JSON 語法格式錯誤，或檔案編碼不受支援。 請按照動態消息封裝指南，確認動態消息已正確封裝。
驗證Errors中的高計數 記錄中缺少必要結構定義欄位 (例如 poi_id、結構化 location.address 或 WGS84 座標)。 展開「驗證」摺疊元素，找出違規的 poi_id，修正搜尋點動態饋給管道，然後重新匯入動態饋給。
Zero Items processed 動態饋給檔案為空白，或記錄無法剖析根層級的 JSON 陣列。 確認動態消息包裝函式結構符合 VssPoi 訊息規格。請參閱動態饋給封裝指南。