資訊提供總覽

本節將進一步說明整合 Actions Center 時必須進行的 三個主要設定。在端對端指南所述的步驟中，這三個設定將分別派上用場。

動態饋給

動態饋給 是 JSON 或 pb3 格式的檔案，可用來將你的庫存資料傳送到 Actions Center。這樣您就可以透過安全檔案傳輸通訊協定上傳功能，一次提交所有資料，輕鬆更新商家、服務和供應情形時段。

Maps Booking API

Maps Booking API 可讓你在下次要提交動態饋給之前，隨時更新「動作中心」系統中的物件，以提供最新的資訊。這個 API 也可讓您取消用「透過 Google 預訂」端對端整合服務進行的預訂。

即時更新是透過 REST 呼叫實作。

注意：即時更新很少適用於入門整合。 如果是入門整合，可以忽略 Maps Booking API。

注意：部分現有的舊版整合功能使用 RPC 呼叫。 系統仍會維護這個介面，但不適用於新整合。

預訂伺服器

如要讓 Actions Center 端對端整合功能代替您建立預訂，您必須設定預訂伺服器。

注意：這不適用於入門整合。

REST API

v3 版是最新版的 API，且支援 REST 型介面。所有新的整合作業都應使用 v3 API。

本節說明用來將庫存清單資料傳送到 Actions Center 的動態饋給檔案。動態饋給的內容將定義你提供的服務種類與項目以及服務時間。

請查看「參考資料和範例」摺疊元素，瞭解如何與我們分享這些動態饋給。

庫存動態饋給的結構是由 Google Maps Booking API 定義。

無論採用哪種整合方式，都必須提供下列動態饋給：

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

此外，端對端整合必須提供下列 2 個動態饋給。

• 服務動態饋給：說明商家提供的服務。
• 預訂情形動態饋給：列出商家可提供服務的時段。

注意：所有已上傳動態饋給的 processing_instruction 都必須設為 PROCESS_AS_COMPLETE。PROCESS_AS_INCREMENTAL 已淘汰，無法使用。

這些動態饋給中有些欄位為必填，有些則為選填。將動態饋給中標示為「選填」的欄位保持空白，即可予以略過。

系統會使用 Protocol Buffers 第 3 版的語法來描述動態饋給格式。你可以選擇用 pb3 格式或衍生的 JSON 格式，將動態饋給檔案上傳為二進位序列化的 Protocol Buffers 資料。建議上傳 JSON 格式的動態饋給。

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

本指南僅適用於 Actions Center 的通訊協定緩衝區。如想瞭解有關如何使用 Protocol Buffers 產生 pb3 檔案的一般資訊，請參閱 Java 環境中的範例。