總覽

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

• Restaurant 實體：你服務的餐廳。
• Service 實體：服務的時間、地點和條件。
• Menu 實體：各餐廳菜單的詳細資料。

下圖顯示 Service、Restaurant 和 Menu 實體如何代表單一餐廳：

一般指南

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

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

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

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

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

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

用戶端程式庫

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