透過批次擷取資料動態饋給,即可在端對端訂購服務中提供餐廳、服務和菜單。
Google 會擷取儲存在代管平台上的資料動態饋給,並加以處理。擷取成功後,「訂單端到端」會提供擷取狀態、上傳的新檔案、檔案總數、錯誤和警告等資訊。
本文將詳細說明 行動中心中的大部分批次動態饋給錯誤,包括這些錯誤的含義和修正方式。超連結會將您帶往關聯式廣告空間結構定義頁面,該頁面會提供更多背景資訊,例如可接受的資料類型,以及特定欄位和實體的範例。
在行動中心中,哪裡會顯示批次動態饋給錯誤?
您可以透過資料動態饋給,在端對端訂購服務中提供餐廳、服務和菜單。如要進一步瞭解如何代管資料動態饋給,請參閱「批次攝入」一文。
動態饋給檔案上傳後,Google 就會擷取並處理這些檔案。如果發生任何問題,系統會顯示錯誤。以下是查看「行動中心」中的「批次動態饋給」錯誤訊息的步驟。
在「動作中心」的主要導覽面板中,依序前往「動態饋給」>「記錄」區段。
選擇環境 (實際工作環境或沙箱),然後按一下「攝入記錄」分頁標籤
輸入回溯期,即可查看過去 X 天的擷取記錄
如要進一步瞭解特定動態饋給擷取作業的錯誤,請按一下箭頭 (→)
接著,您可以查看錯誤和警告的詳細資料
以下是批次動態饋給錯誤清單:
錯誤 | 代表意義 | 如何修正 |
缺少資料 - MenuItem
Menu 至少須包含一個 MenuItem
|
已定義選單,但沒有任何 MenuItem
|
在動態饋給中找出錯誤的「Menu」實體 ID,然後新增「Menu」項目。 |
資料不正確 - maxPrice
欄位 maxPrice 的資料不正確
|
maxPrice 欄位的值不正確
|
請確認錯誤說明中所提及的實體 ID maxPrice 欄位值大於 0
|
資料不正確 - eligibleQuantityMax
欄位 eligibleQuantityMax 的資料不正確
|
eligibleQuantityMax 欄位的值不正確
|
請確認所提及實體 ID 的 eligibleQuantityMax 欄位值大於 0。 |
資料不正確 - leadTimeMax
欄位 leadTimeMax 的資料不正確
|
leadTimeMax 欄位必須是整數值。例如 12。它會針對任何其他資料類型擲回錯誤,甚至是雙精度 (15.0) |
針對錯誤訊息中提及的實體 ID,請檢查 leadTimeMax 屬性的值,並確保該值為整數。 |
資料不正確 - validFrom
欄位 validFrom 的資料不正確
|
validFrom 欄位的值應為 ISO 時間戳記格式,類型為字串。 |
針對 validFrom 欄位的錯誤訊息中的實體 ID,請確認值為時間戳記字串。例如:「 2022-01-02T00:00:00-07:00 」
|
缺少資料 - ServiceHours
OperationHour 不包含任何巢狀 ServiceHours |
已定義 OperationHours 實體,但沒有對應的有效 ServiceHours 實體。 | 針對錯誤訊息中提及的實體 ID,請檢查是否有對應的 ServiceHours 實體。 範例:如果錯誤訊息是「Entity id: store-1:DELIVERY OperationHour contains no nested ServiceHours」,且假設 OperationHours 實體的實體 ID 為 'store-1:DELIVERY:operation_hours',請檢查是否有與 'store-1:DELIVERY' ServiceID 和 'store-1:DELIVERY:operation_hours' OperationHoursID 相關聯的 serviceHours 實體。 |
資料不正確 - advanceBookingRequirementMin
欄位 advanceBookingRequirementMin 的資料不正確
|
advanceBookingRequirementMin 欄位必須是整數值。例如 12。它會針對任何其他資料類型擲回錯誤,甚至是 double (15.0) |
針對錯誤訊息中提及的實體 ID,請檢查 advanceBookingRequirementMin 屬性的值,並確保該值為整數。 |
資料不正確 - availabilityStarts
欄位 availabilityStarts 的資料不正確
|
availabilityStarts 欄位的值應為 ISO 時間戳記格式,類型為字串。 |
針對 availabilityStarts 欄位的錯誤訊息中的實體 ID,請確認值為時間戳記字串。例如:「 2022-01-02T00:00:00-07:00 」
|
資料不正確 - closes
欄位 closes 的資料不正確
|
closes 欄位的值應為 ISO 時間戳記格式,類型為字串。 |
針對 closes 欄位的錯誤訊息中的實體 ID,請確認值為時間戳記字串。例如:「 2022-01-02T00:00:00-07:00 」
|
資料不正確 - dateModified
欄位 dateModified 的資料不正確
|
dateModified 欄位的值應為 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 欄位預期值的類型為 double
|
針對錯誤說明中提到的餐廳類型實體 ID,請確認 latitude 欄位的值為雙精度浮點值。示例:35.4565 |
資料不正確 - leadTimeMin
欄位 leadTimeMin 的資料不正確
|
leadTimeMin 欄位必須是整數值。例如 12。它會針對任何其他資料類型擲回錯誤,甚至是 double (15.0) |
針對錯誤訊息中提及的實體 ID,請檢查 leadTimeMin 屬性的值,並確保該值為整數。 |
資料不正確 - longitude
欄位 longitude 的資料不正確
|
longitude 欄位預期值的類型為 double
|
針對錯誤說明中提到的餐廳類型實體 ID,請確認 longitude 欄位的值為雙精度浮點值。示例:35.4565 |
資料不正確 - menuId
欄位 menuId 的資料不正確
|
menuId 欄位的值必須是非空白的字串
|
針對錯誤說明中提及的實體 ID,請確認值的類型為字串,且不為空白 |
資料不正確 - name
欄位 name 的資料不正確
|
name 欄位的值應為非空白字串
|
檢查錯誤訊息中提到的實體 ID 值是否為非空白字串 |
資料不正確 - nutrition.calories
欄位 nutrition.calories 的資料不正確
|
calories 欄位的值必須是「NN Cal」格式的字串
|
請確認錯誤訊息中的實體 ID 值為正整數,且格式正確。 示例:「123.32 卡路里」 |
資料不正確 - opens
欄位 opens 的資料不正確
|
opens 欄位的值應為 ISO 時間戳記格式,類型為字串。 |
針對 opens 欄位的錯誤訊息中的實體 ID,請確認值為時間戳記字串。例如:「 2022-01-02T00:00:00-07:00 」
|
資料不正確 - price
欄位 price 的資料不正確
|
price 欄位需要數值 |
針對 price 欄位的錯誤訊息中的實體 ID,請確認值為數字。範例:15.4 |
資料不正確 - sku
欄位 sku 的資料不正確
|
sku 欄位的值應為非空白字串
|
檢查錯誤訊息中提到的實體 ID 值是否為非空白字串 |
資料不正確 - validFrom
欄位 validFrom 的資料不正確
|
validFrom 欄位的值應為 ISO 時間戳記格式,類型為字串。此外,validFrom 的值應小於或等於 validThrough 。 |
針對錯誤說明中提及的實體 ID,請確認 validFrom 欄位的值為時間戳記字串。「 2022-01-02T00:00:00-07:00 」
此外,請確認 validFrom 的值小於或等於 validThrough
|
資料不正確 - validThrough
欄位 validThrough 的資料不正確
|
validThrough 欄位的值應為 ISO 時間戳記格式,類型為字串。此外,validThrough 的值應大於或等於 validFrom
|
針對錯誤說明中提及的實體 ID,請確認 validThrough 欄位的值為時間戳記字串。「 2022-01-02T00:00:00-07:00 」
此外,請確認 validThrough 的值大於或等於 validFrom
|
資料不正確 - value
欄位 value 的資料不正確
|
只有在定義 Optiontype 時,才需要填入值欄位。預期會收到字串或列舉 value 。請注意,列舉值僅適用於 PIZZA_SIDE 選項類型。 |
針對錯誤說明中提及的 entityID,請檢查 value 欄位是否含有非空字串。 |
選單過大
選單大小超過上限 |
當選單檔案的大小超過系統可接受的大小時,系統就會擲回這個錯誤。每個檔案 (可包含多個實體) 的大小不得超過 200 MB。頂層實體 Restaurant、Service 和 Menu 及其子實體的總大小不得超過 4 MB。 | 請確認選單檔案的大小符合說明文件中指定的限制。 |
缺少資料 - addressCountry
輸入內容中缺少必填欄位 addressCountry 。
|
addressCountry 是必填欄位,但餐廳實體中缺少該欄位
|
針對錯誤說明中提及的實體 ID,請檢查 addressCountry 欄位是否為非空白字串
|
缺少資料 - addressLocality
輸入內容中缺少必填欄位 addressLocality 。
|
addressLocality 是必填欄位,但餐廳實體中缺少該欄位
|
針對錯誤說明中提及的實體 ID,請檢查 addressLocality 欄位是否為非空白字串
|
缺少資料 - addressRegion
輸入內容中缺少必填欄位 addressRegion 。
|
addressRegion 是必填欄位,但餐廳實體中缺少該欄位
|
針對錯誤說明中提及的實體 ID,請檢查 addressRegion 欄位是否為非空白字串
|
缺少資料 - 費用
外送/外帶服務沒有任何外送費 |
費率類型的實體沒有任何與外送/外帶服務相關聯的 price |
針對錯誤說明中提到的實體 ID,請按照這裡的指示,為外送/外帶 ServiceType 正確設定 Fee 實體。 |
缺少資料 - 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
MenuItemOffer 是 MenuItemOption 的必要屬性 |
每個 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 貨幣代碼。示例:美元、歐元 |
缺少資料 - ServiceArea
貨運服務沒有貨運服務區域 |
如果相關聯的 Service 實體已將 serviceType 設為「DELIVERY」,就必須實作 ServiceArea 實體
|
請確認錯誤訊息中提到的服務實體 ID 已正確定義 ServiceArea 實體。 |
缺少資料 - streetAddress
輸入內容中缺少必填欄位 streetAddress 。
|
streetAddress 是必填欄位,但 Restaurant 實體中缺少該欄位
|
根據錯誤說明中提及的 ID 找出「Restaurant」實體,檢查 streetAddress 欄位是否為非空字串
|
過時的實體 | 在資料動態饋給擷取期間,End-to-End 訂購服務會比較每個傳入實體的修改日期時間戳記,以及先前擷取的實體時間戳記。除非資料動態消息中的實體較新,否則系統會將傳入的實體標示為過時。 | 針對錯誤說明中提及的所有實體 ID,Google 必須確保資料動態饋給中的時間戳記,比先前傳送至 Google 的實體更新中設定的時間戳記更新。如需進一步說明,請參閱「實體版本控制」一文。 |