資料動態饋給批次擷取功能可讓您在「端對端排序」中提供餐廳、服務和菜單。
Google 會擷取並處理儲存在代管平台上的資料動態饋給。 成功擷取後，藉由端對端排序會提供擷取狀態、新上傳檔案、檔案總數、錯誤和警告等資訊。
本文將詳細說明Actions Center 中的多數批次動態饋給錯誤、錯誤所代表的意義和修正方式。超連結會將您帶往關聯目錄結構定義頁面，該頁面提供更多背景資訊，例如接受的資料類型，以及特定欄位和實體的範例。
Actions Center 中的批次動態饋給錯誤在哪裡？
藉由資料動態饋給，您可以透過「端對端訂購」頁面提供餐廳、服務和菜單。如要進一步瞭解如何代管資料動態饋給，請參閱批次擷取一文。
動態饋給檔案上傳完畢後，Google 就會擷取並處理檔案。如果有任何問題，會顯示為錯誤。以下是在 Actions Center 查看批次動態饋給錯誤的步驟。
在 Actions Center 的主要導覽面板上，依序前往「Feed」(動態饋給) >「History」(記錄) 部分。
選取環境 (正式環境或沙箱)，然後按一下「Ingestion history」分頁標籤
輸入回溯期，即可查看過去 X 天的擷取記錄
如要進一步瞭解特定動態饋給擷取作業的錯誤資訊，請按一下箭頭 (→)
接著，
即可查看更多錯誤和警告的詳細資料
以下是批次動態饋給錯誤清單：
| 錯誤 | 代表意義 | 如何修正 |
缺少資料 - MenuItem
選單必須至少有一個 MenuItem
|
已定義選單，但沒有任何 MenuItem
|
在動態饋給中找出錯誤 Menu 實體的 ID，並新增菜單項目。 |
資料不正確 - maxPrice
「maxPrice」欄位的資料有誤
|
maxPrice 欄位的值不正確
|
確認錯誤說明中提及的實體 ID 的 maxPrice 欄位值大於 0
|
資料不正確 - eligibleQuantityMax
「eligibleQuantityMax」欄位的資料有誤
|
eligibleQuantityMax 欄位的值不正確
|
確認所提及的實體 ID 在 eligibleQuantityMax 欄位中的值大於 0。 |
資料不正確 - leadTimeMax
「leadTimeMax」欄位的資料有誤
|
leadTimeMax 欄位預期的值是整數。範例：12。它會為任何其他資料類型擲回錯誤，即使是雙精度浮點數 (15.0) 也不例外
|
針對錯誤訊息中提及的實體 ID，檢查 leadTimeMax 屬性的值，確認該屬性為整數。
|
資料不正確 - validFrom
「validFrom」欄位的資料有誤
|
validFrom 欄位的值必須是類型為 String 的 ISO 時間戳記格式。 |
針對 validFrom 欄位錯誤訊息中的實體 ID，確認該值是時間戳記字串。例如：「 2022-01-02T00:00:00-07:00」
|
| 缺少資料 - ServiceHours
OperationHour 不包含任何巢狀 OperationHour |
已定義 OperationHours 實體，但該實體未對應至任何有效的 ServiceHours 實體。 | 針對錯誤訊息中提及的實體 ID，確認系統是否已正確定義相應的 ServiceHours 實體。 範例：如果錯誤訊息為「Entity id: store-1: DELIVERY OperationHours」沒有任何巢狀 ServiceHours，且假設 OperationHours 實體的實體 ID 為「store-1:DELIVERY:operation_hours」，請檢查是否有 serviceHours 實體並繫結至「store-1:DELIVERY: OperationHoursIDLIVERY:OperationHoursIDLIVERY:OperationHoursID」ServiceID |
資料不正確 - advanceBookingRequirementMin
「advanceBookingRequirementMin」欄位的資料有誤
|
advanceBookingRequirementMin 欄位預期的值是整數。範例：12。若其他資料類型，系統會擲回錯誤，即使是雙倍 (15.0) 也一樣 |
針對錯誤訊息中提及的實體 ID，檢查 advanceBookingRequirementMin 屬性的值，確認該屬性為整數。
|
資料不正確 - availabilityStarts
「availabilityStarts」欄位的資料有誤
|
availabilityStarts 欄位的值必須是類型為 String 的 ISO 時間戳記格式。 |
針對 availabilityStarts 欄位錯誤訊息中的實體 ID，確認該值是時間戳記字串。例如：「 2022-01-02T00:00:00-07:00」
|
資料不正確 - closes
「closes」欄位的資料有誤
|
closes 欄位的值必須是類型為 String 的 ISO 時間戳記格式。 |
針對 closes 欄位錯誤訊息中的實體 ID，確認該值是時間戳記字串。例如：「 2022-01-02T00:00:00-07:00」
|
資料不正確 - dateModified
「dateModified」欄位的資料有誤
|
dateModified 欄位的值必須是類型為 String 的 ISO 時間戳記格式。 |
針對 dateModified 欄位錯誤訊息中的實體 ID，確認該值是時間戳記字串。例如：「 2022-01-02T00:00:00-07:00」
|
資料不正確 - discount
「discount」欄位的資料有誤
|
discount 欄位需要數值
|
針對 discount 欄位錯誤訊息中的實體 ID，確保該值為數字。範例： 10
|
資料不正確 - discountPercentage
「discountPercentage」欄位的資料有誤
|
discountPercentage 欄位需要數值
|
針對 discountPercentage 欄位錯誤訊息中的實體 ID，確保該值為數字。範例： 15
|
資料不正確 - geoRadius
「geoRadius」欄位的資料有誤
|
geoRadius 欄位預期的整數值。
|
針對錯誤訊息中提及的實體 ID，檢查 geoRadius 屬性的值，確認該屬性為整數。
範例：10000 |
資料不正確 - image
「image」欄位的資料有誤
|
「image」欄位會預期網址有效，並在偵測到任何其他情況時擲回錯誤。
|
檢查 image 欄位的值是否為有效的網址字串
|
資料不正確 - latitude
「latitude」欄位的資料有誤
|
latitude 欄位的值類型應為雙精度浮點值
|
針對錯誤說明中提及的餐廳類型實體 ID，確認 latitude 欄位的值為雙倍。範例：35.4565 |
資料不正確 - leadTimeMin
「leadTimeMin」欄位的資料有誤
|
leadTimeMin 欄位預期的值是整數。範例：12。若其他資料類型，系統會擲回錯誤，即使是雙倍 (15.0) 也一樣 |
針對錯誤訊息中提及的實體 ID，檢查 leadTimeMin 屬性的值，確認該屬性為整數。
|
資料不正確 - longitude
「longitude」欄位的資料有誤
|
longitude 欄位的值類型應為雙精度浮點值
|
針對錯誤說明中提及的餐廳類型實體 ID，確認 longitude 欄位的值為雙倍。範例：35.4565 |
資料不正確 - menuId
「menuId」欄位的資料有誤
|
menuId 欄位的值必須是非空白字串 |
針對錯誤說明中提及的實體 ID，確認該值屬於字串類型，而非空白 |
資料不正確 - name
「name」欄位的資料有誤
|
「name」欄位的值必須是非空白字串
|
檢查錯誤訊息中提及的實體 ID 值是否為非空白字串 |
資料不正確 - nutrition.calories
「nutrition.calories」欄位的資料有誤
|
calories 欄位的值必須是以「NN Cal」格式的字串
|
確認錯誤訊息中的實體 ID 值是正確格式的正數。
例如：「123.32 Cal」 |
資料不正確 - opens
「opens」欄位的資料有誤
|
opens 欄位的值必須是類型為 String 的 ISO 時間戳記格式。 |
針對 opens 欄位錯誤訊息中的實體 ID，確認該值是時間戳記字串。例如：「 2022-01-02T00:00:00-07:00」
|
資料不正確 - price
「price」欄位的資料有誤
|
price 欄位需要數值
|
針對 price 欄位錯誤訊息中的實體 ID，確保該值為數字。範例：15.4 |
資料不正確 - sku
「sku」欄位的資料有誤
|
「sku」欄位的值必須是非空白字串
|
檢查錯誤訊息中提及的實體 ID 值是否為非空白字串 |
資料不正確 - validFrom
「validFrom」欄位的資料有誤
|
validFrom 欄位的值必須是類型為 String 的 ISO 時間戳記格式。此外，validFrom 的值必須小於或等於 validThrough
|
針對錯誤說明中提及的實體 ID，確認 validFrom 欄位的值為時間戳記字串。「 2022-01-02T00:00:00-07:00」
此外，請確認 validFrom 的值小於或等於 validThrough
|
資料不正確 - validThrough
「validThrough」欄位的資料有誤
|
validThrough 欄位的值必須是類型為 String 的 ISO 時間戳記格式。此外，validThrough 的值必須大於或等於 validFrom
|
針對錯誤說明中提及的實體 ID，確認 validThrough 欄位的值為時間戳記字串。「 2022-01-02T00:00:00-07:00」
此外，請確認 validThrough 的值大於或等於 validFrom
|
資料不正確 - value
「value」欄位的資料有誤
|
只有在已定義 Optiontype 時，才需要提供值欄位。它需要字串或 Enum value。請注意，列舉值只適用於 PIZZA_SIDE 選項類型。
|
針對錯誤說明中提及的 entityID，檢查 value 欄位是否含有非空白字串。 |
| 選單過大
選單大小超過上限 |
如果選單檔案大小超出系統能接受的大小，系統就會擲回這個錯誤。每個檔案可包含多個實體，不得超過 200 MB。「餐廳」、「服務」和「菜單」等頂層實體及其子實體，不得超過 4 MB。 | 確認選單檔案大小未超過說明文件所規定的上限。 |
缺少資料 - addressCountry
輸入內容中缺少必填欄位 addressCountry。 |
addressCountry 是必填欄位，缺少餐廳實體
|
針對錯誤說明中提及的實體 ID，檢查 addressCountry 欄位是否為非空白字串 |
缺少資料 - addressLocality
輸入內容中缺少必填欄位 addressLocality。 |
addressLocality 是必填欄位，缺少餐廳實體
|
針對錯誤說明中提及的實體 ID，檢查 addressLocality 欄位是否為非空白字串 |
缺少資料 - addressRegion
輸入內容中缺少必填欄位 addressRegion。 |
addressRegion 是必填欄位，缺少餐廳實體
|
針對錯誤說明中提及的實體 ID，檢查 addressRegion 欄位是否為非空白字串 |
| 缺少資料 - 費用
外送/匯出服務沒有任何運費 |
費用類型的實體沒有任何與外送/匯出服務相關聯的 price |
根據錯誤說明中提及的實體 ID，確認 Fee 實體已按照此處指示，為外送/外帶 ServiceType 正確設定。 |
缺少資料 - FeeValue
輸入內容中必須包含 price、pricePerMeter、percentageOfCart 其中一個欄位。 |
「費用」金額必須設定其中一個 price, pricePerMeter or percentageOfCart 。
|
針對錯誤說明中提及的實體 ID，確認已設定一個 price, pricePerMeter or percentageOfCart 。 |
缺少資料 - geoMidpointLatitude
輸入內容中缺少必填欄位 geoMidpointLatitude。 |
定義 ServiceArea 時，當使用 geoRadius 時，必須提供 geoMidpointLatitude 和 geoMidpointLongitude。 |
針對錯誤說明中提及的實體 ID，確認 geoMidpointLatitude 欄位的值已定義，且為雙精度浮點值。範例：35.4565 |
缺少資料 - 輸入中的 geoMidpointLongitude
geoMidpointLongitude。 |
定義 ServiceArea 時，當使用 geoRadius 時，必須提供 geoMidpointLongitude 和 geoMidpointLatitude。 |
針對錯誤說明中提及的實體 ID，確認 geoMidpointLatitude 欄位的值已定義，且為雙精度浮點值。範例：122.4565 |
| 缺少資料 - MenuItemOption
MenuItemOption 需要用到 MenuItemOffer |
每個 MenuItemOption 都必須具備對應的 MenuItemOffer 實體 | 確保錯誤說明中所有選單項目 ID 的 MenuItemOption 實體均已正確定義 MenuItemOffer 實體。 |
| 缺少資料 - OperationHours
服務缺少營業時間 |
外送/匯出服務實體缺少對應的 OperationHours 實體。OperationHours 說明使用者可以存取流程並盡快提交訂單，或提前下單。 | 針對錯誤說明中提及的實體 ID，確認已正確定義 OperationHours 實體。 |
缺少資料 - postalCode
輸入內容中缺少必填欄位 postalCode。 |
postalCode 是必填欄位，缺少餐廳實體
|
針對錯誤說明中提及的實體 ID，檢查 postalCode 欄位是否為非空白字串 |
缺少資料 - priceCurrency
輸入內容中缺少必填欄位 priceCurrency。 |
priceCurrency 欄位空白或含有不正確的值。退款金額應為 3 個字母的 ISO 4217 貨幣代碼。
|
針對錯誤說明中所述的實體 ID，確認 priceCurrency 欄位是包含 3 個字母的 ISO 4217 貨幣代碼。範例：USD、EUR |
| 缺少資料 - ServiceArea
運送服務沒有運送服務範圍 |
如果相關聯的 Service 實體 serviceType 設為「DELIVERY」，則必須實作 ServiceArea 實體 |
確認錯誤訊息中提及的 Service 實體 ID 已正確定義 ServiceArea 實體 |
缺少資料 - streetAddress
輸入內容中缺少必填欄位 streetAddress。 |
streetAddress 是必填欄位，缺少 Restaurant 實體 |
按照錯誤說明中提及的 ID 找出 Restaurant 實體，檢查 streetAddress 欄位是否為非空白字串
|
| 實體過時 | 在擷取資料動態饋給的過程中，「排序端對端」會比較每個傳入實體的修改日期時間戳記與先前擷取實體的時間戳記。除非資料動態饋給中的實體更新，否則系統會將傳入實體標示為過時。 | 針對錯誤說明中提及的所有實體 ID，Google 必須確保資料動態饋給中的時間戳記高於先前傳送至 Google 的實體更新中設定的時間戳記。如需進一步說明，請參閱實體版本管理。 |