訂房端對端資料動態饋給的結構是由關聯式商品目錄結構定義。訂購端到端資料動態饋給包含下列最高層級實體:
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
值取代物件。如果物件為選用項目,則必須從動態饋給中省略。
用戶端程式庫
您可以使用「工具」部分中的用戶端程式碼產生器驗證訂購端對端資料動態饋給。