動態饋給總覽

本節指定用於將商品目錄資料傳送至「透過 Google 預訂」的動態饋給檔案。動態饋給的內容會定義您提供的服務、提供的服務，以及提供的服務時間。

請參閱入門指南整合指南或端對端整合指南 (視整合類型而定)，瞭解如何向我們提供這類動態饋給。

商品目錄動態饋給的結構是由 Google Maps Booking API 定義。

無論整合為何，都必須啟用以下動態饋給：

• 商家動態饋給：包含商家的說明資料。

此外，如要進行端對端整合，必須使用下列 2 個動態饋給。

• 服務動態饋給：說明商家提供的服務。
• 供應情形動態饋給：列出商家提供的服務供應情形。

也會指定一些選用動態饋給：

• 優惠動態饋給：說明系統提供給使用者的優惠 (促銷活動)。詳情請參閱優惠指南。
• 菜單動態饋給：說明餐廳的菜單。詳情請參閱選單指南。

注意：所有動態饋給都必須透過 processing_instruction PROCESS_AS_COMPLETE 上傳。PROCESS_AS_INCREMENTAL 已遭淘汰，因此無法使用。

這些動態饋給中有些欄位為必填，有些則為選填。如果您將任何欄位標示為可選，則可在動態饋給中留空。

系統會使用 Protocol Buffers 第 3 版的語法來描述動態饋給格式。您可以選擇以 pb3 格式或衍生的 JSON 格式，將動態饋給檔案儲存為通訊協定緩衝區的二進位序列化。建議您以 JSON 格式上傳動態饋給。

建議您先使用 gzip 壓縮動態饋給，然後再上傳。

本指南僅適用於「透過 Google 預訂」的 Protocol Buffers。要瞭解如何使用通訊協定緩衝區來產生 pb3 檔案，請參閱 Java 中的範例。