端對端排序資料動態饋給的結構由關聯庫存結構定義定義。排序端對端資料動態饋給由下列頂層實體組成:
Restaurant
實體: 你提供服務的餐廳。Service
實體:服務的時間、地點和條件。Menu
實體:每間餐廳菜單的詳細資料。
下圖顯示 Service
、Restaurant
和 Menu
實體如何代表單一餐廳:
一般原則
每個檔案的餐廳數量:每個資料檔案都應代表具有相關
Service
和Menu
實體的餐廳。請使用有助於搜尋餐廳檔案的名稱。資料檔案格式:資料檔案必須格式化為以換行符號分隔的 JSON 檔案 (ndjson 格式)。
日期和時間值:如果屬性需要
DateTime
或Time
值,請使用日期和時間格式中指定的格式。例如DateTime
為2017-05-01T06:30:00+05:30
,Time
則為T08:08:00+05:30
。ID:使用
@id
屬性來識別實體類型中的所有不重複實體。長度上限為 300 個半形字元。@id
是該類型實體的專屬 ID,但在不同實體中,ID 可以重疊。舉例來說,假設您定義了一個Service
實體,並將@id
屬性設為a16
。您無法建立另一個@id
為a16
的Service
實體。不過,您可以使用a16
做為Menu
實體的@id
值。產生 ID:保持 ID 保持穩定 - 請勿使用 UUID,或在上傳的動態饋給之間變更/隨機 ID。這樣就能更輕鬆地支援實體相關問題。
空值:不可使用
null
值取代物件。如果物件為選用項目,則必須在動態饋給中省略。
用戶端程式庫
「工具」專區中的用戶端程式碼產生器可用來驗證「訂購端對端」資料動態饋給。