總覽

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

動態饋給

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

Maps Booking API

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

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

注意：「即時更新」功能很少適用於入門整合。如要進行初始整合，您可以忽略 Maps Booking API。

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

預訂伺服器

如要讓 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。如想瞭解如何使用 Protocol Buffers 產生 pb3 檔案的一般資訊，請參閱 Java 環境中的範例。