總覽

訂房端對端資料動態饋給的結構是由關聯式商品目錄結構定義。訂購端到端資料動態饋給包含下列最高層級實體:

下圖顯示 ServiceRestaurantMenu 實體如何代表單一餐廳:

餐廳服務菜單類別關係圖
圖 1:訂購端到端資料動態饋給實體的整體關係:服務、餐廳和菜單。

一般指南

  • 每個檔案中的餐廳數量:每個資料檔案都應代表一家餐廳,並包含相關的 ServiceMenu 實體。使用可協助你搜尋餐廳檔案的檔案名稱。

  • 資料檔案格式:資料檔案格式必須是換行符號分隔的 JSON 檔案 (ndjson 格式)。

  • 日期時間和時間值:如果屬性需要 DateTimeTime 值,請使用日期時間和時間格式中指定的格式。例如 2017-05-01T06:30:00+05:30 對應 DateTimeT08:08:00+05:30 對應 Time

  • ID:使用 @id 屬性,找出實體類型中的所有不重複實體。長度上限為 300 個半形字元。@id 是該類型實體的專屬 ID,但在不同實體之間,ID 可能會重疊。舉例來說,假設您定義了 Service 實體,並將 @id 屬性設為 a16。您無法建立另一個 Service 實體,其 @ida16。不過,您可以使用 a16 做為 Menu 實體的 @id 值。

  • ID 產生:請保持 ID 穩定,不要在動態饋給上傳之間使用 UUID 或以其他方式變更/隨機產生 ID。這樣一來,我們就能更輕鬆地為實體相關問題提供支援。

  • 空值:請勿使用 null 值取代物件。如果物件為選用項目,則必須從動態饋給中省略。

用戶端程式庫

您可以使用「工具」部分中的用戶端程式碼產生器驗證訂購端對端資料動態饋給。