動態饋給報表會顯示動態饋給最近一次擷取作業的詳細資料。這包括整體狀態、該動態饋給中每個檔案的可用性狀態,以及動態饋給中所有實體的數量與狀態。你可以在這份報表中,檢視過去 90 天內所有動態饋給擷取作業的記錄。資源中的每個動態饋給都會有獨立的動態饋給報表。
如果資源只有一個動態饋給,該動態饋給報表只會加上「動態饋給」標記。如果資源有多個動態饋給,每個動態饋給都會有專屬的動態饋給報表,且都會加上該動態饋給的專屬名稱標籤。
常見問題
以下說明如何找出最常用到的動態饋給資訊:
最近一次擷取作業狀態
查看擷取記錄
特定狀態的實體數量
特定實體類型的狀態記錄
Google 中的實體數量
- 在動態饋給報表的到達網頁上按一下「查看擷取記錄」,然後在擷取記錄中找出最近一次成功的擷取作業,並記下擷取的日期和時間。
- 返回動態饋給報表的到達網頁,前往「偵測到的實體」表格。
- 按一下表格中「其他實體」列以外的每一列。
- 在圖表上方,依序選取「有效」和「有效但出現警告」兩欄,並取消選取「無效」欄。
- 尋找你在步驟 1 中記錄的日期和時間。
- 加總「偵測到的實體」表格中各項目類型的數量。
- 在動態饋給報表中找到「偵測到的實體」表格
- 按一下實體類型,即可查看該類型的問題表格。在問題表格中找出特定問題。
- 在問題表格中按一下該資料列,即可查看受到該問題影響的實體清單 (非完整清單)。
最近一次擷取作業中的實體問題
- 按一下表格任一列,即可查看該類型實體的記錄。
- 在圖表頂端選取「無效」或「有效但出現警告」,即可查看影響動態饋給的問題清單。
- 按一下「實體」數量大於 0 的任一列,即可查看受該問題影響的實體清單。如果數量為 0,代表最近一次擷取時該問題已解決;如果最近一次擷取失敗,這個問題可能會顯示在最後一次成功擷取的記錄中。
- 按一下實體樣本表格中的任一實體,即可查看出錯的程式碼。請注意,實體樣本表格可能不會顯示受到問題影響的所有實體。
擷取狀態
動態饋給報表頂端會顯示最近一次嘗試擷取的作業認定結果。這個結果會受許多因素影響,包括是否能夠要求檔案和剖析檔案,以及動態饋給中所找到實體是否有效。如果動態饋給有一個檔案層級問題或是太多實體問題,系統就會判定擷取失敗。
擷取作業結束後,作業記錄可能需要幾個小時的時間才會顯示在動態饋給報表中。雖然大多數擷取都是定期排程進行,不過基於各種原因,系統也可能會自動進行幾次動態饋給擷取作業。
現行動態饋給的狀態
標示為「現行」的動態饋給可能有以下幾種狀態:
- 資料處理完成並推送至 Google
動態饋給已通過驗證,動態饋給中所有的有效實體可能都已進入知識圖譜資料庫。這項認定結果代表系統在動態饋給中偵測到至少一個有效實體。不過,成功動態饋給中的有效實體不保證一定能進入知識圖譜資料庫。此外,如果僅是輕微或是可修正的錯誤,部分無效實體還是有可能納入知識圖譜。瞭解詳情。 - 資料處理完成,但無法推送至 Google
擷取作業遭拒,可能是因為實體不一致、有效實體數量與最後一次擷取時相差過大,或是其他原因。請洽詢你在 Google 的動態饋給聯絡人,進一步瞭解發生的問題和修正方法。知識圖譜會繼續使用最後一次成功動態饋給中的有效實體。 - 資料處理失敗:動態饋給檔案發生問題
擷取作業因為檔案層級問題而遭到拒絕,系統不會將這個動態饋給的任何實體推送至知識圖譜。動態饋給報表的「偵測到的實體」部分不會顯示這次擷取作業中的任何實體。這裡顯示的實體都來自於標示為「有效」或「資料處理完成,但無法推送至 Google」的最近一次擷取作業。 - 資料處理失敗:動態饋給空白
所有動態饋給檔案要不是空白,就是未包含可剖析的實體。如果有實體存在,但全都有誤,則屬於「資料處理完成,但無法推送至 Google」。
非現行動態饋給的狀態
非現行的動態饋給可能會是以下幾種狀態:
- 資料處理完成
Google 可以讀取、剖析動態饋給並進行初始驗證。動態饋給報表的實體表格會列出在動態饋給中找到的任何警告或錯誤,請加以檢查並修正。 - 資料處理失敗:動態饋給空白
所有動態饋給檔案要不是空白,就是未包含可剖析的實體。 - 資料處理失敗:動態饋給檔案發生問題
擷取作業因為檔案層級問題而遭到拒絕,動態饋給報表的「偵測到的實體」部分不會顯示這次擷取作業中的任何實體。
其他資訊
- 「現行」標記
- 動態饋給成功推送至 Google 至少一次之後,該動態饋給就會顯示「現行」標記。
- 時間
- 系統根據認定結果所回報的擷取時間,就是 Google 擷取到動態饋給中第一個檔案的時間 (以使用者當地時間為準)。
動態饋給檔案
「動態饋給檔案」部分會顯示 Google 是否能讀取你動態饋給中的檔案。如果 Google 無法讀取其中任何一個檔案,該次擷取就會失敗。
動態饋給檔案問題
可能會發生的檔案層級錯誤如下:
- 找不到 (404):系統在提供的網址中找不到動態饋給檔案。
- 因傳回未經授權的要求 (401) 而遭到封鎖:請務必在動態饋給設定中加入任何必要的驗證資訊,讓 Google 能夠存取檔案。
- 遭到 robots.txt 封鎖:robots.txt 規則封鎖了動態饋給。找出並修改這項規則,或是直接移除。
- 伺服器錯誤 (5xx):系統嘗試讀取動態饋給檔案時發生伺服器錯誤。
- 重新導向錯誤:檔案發生某種重新導向錯誤,例如重新導向迴圈或重新導向至無效網址 (意即不是有效網址,而是非回應式的網址)。動態饋給檔案讀取器會追蹤重新導向,但如果動態饋給檔案已永久改變位置,請更新動態饋給檔案設定,而不要使用重新導向。
- 因拒絕存取 (403) 而遭到封鎖:Google 因存取受限制而無法讀取檔案。請務必在動態饋給設定中加入任何必要的驗證資訊,讓 Google 能夠存取檔案。
- 因其他 4xx 問題而遭到封鎖:因為其他問題導致 Google 無法存取這個動態饋給檔案。
- 剖析問題:發生嚴重的剖析問題,導致整個檔案都無法讀取。按一下問題說明,即可查看含有剖析錯誤的程式碼片段。
- 內部錯誤:Google 發生不明問題,稍後會再試一次。
- DNS 伺服器沒有回應:DNS 伺服器未回應我們的要求。Google 會定期重試讀取你的動態饋給。
- DNS 錯誤:主機不明:DNS 服務無法解讀你提供的動態饋給網址。希望這只是暫時性錯誤,但別忘了檢查我們提供的網址以確認情況。
- DNS 錯誤:提供的是私人 IP:DNS 服務傳回保留給私人位址的 IP 位址 (例如 10.0.0.1)。請與 DNS 服務供應商聯絡。
- 伺服器連線錯誤:發生 5XX 層級錯誤 (無法連上伺服器、連線遭拒或無法回應)。
- 伺服器傳回無效回應:伺服器不支援所要求的通訊協定、回應/標頭遭到截斷,或是系統無法剖析回應 (原因可能是壓縮錯誤)。
- 伺服器安全資料傳輸層 (SSL) 憑證無效:網站的 SSL 憑證無效。如果 SSL 憑證無效,Google 就不會處理請求。
- 已擷取,但尚未處理:動態饋給中有任何系統無法擷取或處理的檔案,Google 會嘗試擷取其餘檔案但不進行處理,而動態饋給擷取作業也會失敗。系統會為這個情況下成功擷取的所有檔案加上「已擷取,但尚未處理」標籤。
偵測到的實體
這個部分會顯示系統針對你的動作類型,在本次擷取作業中偵測到的所有頂層實體,並依實體類型分組。
頂層實體表格
表格會依照狀態,顯示每個頂層實體類型的實體數量。如要查看特定實體類型的詳細資料,請按一下表格中的實體列,開啟該實體的詳細資料頁面。
如果擷取作業因為沒有可供讀取的檔案而失敗,表格中的值將全部為零,此時按下實體列還是能夠查看該實體類型的擷取記錄。請記得,Google 會持續提供使用者最後一次成功擷取時的實體。
其他實體
如果表格顯示「其他實體」這個類型,該類型會列出無法正確分類的實體,可能的原因包括缺少類型說明,或是動態饋給中有 ID 相同的重複實體。如果有無法剖析的實體,則完全不會顯示在報表中。
實體詳細資料頁面
按一下動態饋給實體表格中的任一列,即可查看該實體類型的詳細資料。
實體擷取記錄圖表
特定實體類型的記錄圖表會顯示每次擷取中該類型在各狀態的實體數量。圖表中的資料點代表擷取,無論成功與否。圖表顯示的並非 Google 的資料庫清單內容,而是特定擷取作業中特定狀態的實體數量。
雖然因為圖表以圓點代表擷取,而讓每個點之間出現像是逐漸增加或衰退的斜線,但事實上,每次擷取時,變更都是即時發生,而不是逐漸更新;因此,建議你將圖表視為長條圖而非折線圖,而每一道長條的寬度就是這次擷取到下次擷取之間的時間。
圖表會以附註方式標示出失敗的擷取作業。如果 Google 無法讀取任何檔案,該次擷取的所有狀態會在圖表上全部顯示為零。
實體表格
選取實體類型後,這個表格會顯示該類型在 Google 最近一次嘗試進行擷取時的狀態詳細資料。
- 按一下表格中的任一列,即可查看實體狀態和說明的詳細資訊,其中會包括一份實體樣本清單 (最多會列出 1,000 個實體),以及含有該狀態和說明的實體記錄圖表。
- 按一下表格中的實體樣本即可查看更多詳細資料,如果有錯誤的話,系統會醒目顯示發生錯誤的實體程式碼。
實體狀態
每個問題會屬於下列其中一種狀態,而每個實體中最嚴重問題的狀態就決定了該實體的狀態。舉例來說,假設某個實體中有兩個問題,一個為「無效」,另一個為「有效但出現警告」,那麼該實體的狀態就會是「無效」。
- 無效:這個實體目前在動態饋給中為無法使用的狀態。如果你想讓 Google 使用這個實體,請在下次動態饋給擷取作業前進行更新。如果是狀態為成功的現行動態饋給,系統會將無效的實體從 Google 中移除。
- 有效但出現警告:這個實體可依目前的狀態使用,不過建議你修正部分問題。出現警告表示可能有建議要變更的項目 (例如你使用了已淘汰的欄位),或者建議你要提供額外資訊 (例如價格)。未來,我們可能會將其中部分問題歸類為錯誤。
- 有效:這些實體符合納入知識圖譜的資格。如要查看有效實體清單,請在動態饋給報表摘要頁面的圖表下方按一下「查看有效實體的相關資料」。
為動態饋偵錯
為動態饋給偵錯是一項疊代程序。請使用「動態饋給」報表找出並修正錯誤,然後透過報表追蹤下一次動態饋給擷取作業的修正結果。
問題按照頂層實體類型分組。在單一例項中檢查問題並修正實體產生程式碼,或許可以修正絕大多數特定類型的問題。
如要驗證個別項目,你可以使用資料動態饋給驗證工具。
如何修正實體問題:
- 查看動態饋給報表底部表格中的實體類型清單,點選「無效」項目數量大於零的任一資料列。
- 請務必選取「無效」分頁標籤,以查看動態饋給中錯誤狀態實體的記錄。
- 在報表底部的錯誤詳細資料表格中,查看錯誤清單。
- 點選任一錯誤即可查看哪些實體曾發生該錯誤的記錄,以及 Google 最近一次嘗試擷取時,發生該錯誤的實體樣本。基於多種原因,這份清單不一定能列出所有發生錯誤的實體;不過,此圖表會顯示有多少實體受這個錯誤影響,這個數量則會是完整的數量。
- 點選樣本清單中的任一實體即可查看程式碼,系統會醒目顯示錯誤的部分 (不過並非所有錯誤都能以這種方式顯示)。如要進一步瞭解所列錯誤,請按一下「瞭解詳情」連結。在某些情況下,額外資訊面板中可能會顯示修正建議。建議同時參閱該特定實體的說明文件,瞭解必要的值或格式。
- 產生更新後的動態饋給,然後使用資料動態饋給驗證工具檢查先前毀損的一或兩個實體。
- 如果看起來一切正常,請更新動態饋給並等待下次擷取作業,看看錯誤是否已消失。如要查看特定實體類型中的特定錯誤類型記錄,請在動態饋給報表的「偵測到的實體」表格中按一下實體類型,然後在「詳細資料」表格中點選問題。
問題類型
動態饋給可含有動態饋給問題和實體問題。
- 動態饋給問題關係到讀取及剖析檔案。任何檔案問題都會導致擷取作業失敗。查看檔案問題清單。
- 實體問題可以是語法錯誤,或是缺少必填欄位。實體問題也可能是比對動態饋給中的實體與知識圖譜中的實體時發生的問題。瞭解詳情
實體問題
單一實體可能出現一或多個問題,而同個問題也可能重複出現多次。如要針對實體問題偵錯,請按一下最新動態饋給的報表以查看錯誤和警告,然後點選特定實體,即可查看受到特定問題影響的實體樣本清單。
- 如要針對特定「錯誤類型」偵錯 (例如缺少「name」屬性的所有實體),請尋找你必須深入瞭解特定實體類型的錯誤。
實體問題類型
實體可以有剖析/規範遵循問題或比對問題。動態饋給報表不會區分這兩類問題,但瞭解問題類別有助於修正問題:
- 剖析或規範遵循問題表示系統無法剖析實體、實體缺少必要值,或是實體的特定欄位含有不支援的值。如果遇到這類問題,請參閱問題名稱來瞭解問題,並參閱特定實體類型的說明文件,瞭解特定實體必須遵循的條件。
- [實驗功能] 比對問題是指 Google 無法將動態饋給中的實體與知識圖譜中的實體進行比對時發生的問題。之所以發生這個問題,通常是缺少動態饋給實體的相關資料,或是有關動態饋給實體的某些資訊與 Google 中有關這個實體的資訊不符。這些問題的觸發條件仍在開發階段,因此請先著重於修正剖析或規範遵循問題。瞭解如何針對比對問題偵錯。