總覽

端對端排序資料動態饋給的結構由關聯庫存結構定義定義。排序端對端資料動態饋給由下列頂層實體組成:

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

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

一般原則

  • 每個檔案的餐廳數量:每個資料檔案都應代表具有相關 ServiceMenu 實體的餐廳。請使用有助於搜尋餐廳檔案的名稱。

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

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

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

  • 產生 ID:保持 ID 保持穩定 - 請勿使用 UUID,或在上傳的動態饋給之間變更/隨機 ID。這樣就能更輕鬆地支援實體相關問題。

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

用戶端程式庫

「工具」專區中的用戶端程式碼產生器可用來驗證「訂購端對端」資料動態饋給。