資訊提供總覽

本節將詳細說明與 Actions Center 整合的 3 個主要部分。您將在端對端指南中說明這些步驟來使用。

動態饋給

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

Maps Booking API

有了 Maps Booking API，您就能在每次提交動態饋給之間更新 Actions Center 系統中的物件，隨時取得最新資訊。此外，這個 API 也可讓您取消透過「透過 Google 預訂」的端對端整合程序提出的預訂資料。

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

注意：即時更新功能通常不適用於新手整合。 如要進行新手整合，請忽略 Maps Booking API。

注意：部分現有的舊版整合功能正在使用遠端程序呼叫 (RPC)。這個選項仍會維護，但不得用於新的整合功能。

Booking Server (預訂伺服器)

如要讓 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 格式，將動態饋給檔案上傳為二進位序列化的通訊協定緩衝區資料。 建議你以 JSON 格式上傳動態饋給。

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

本指南適用於 Actions Center 通訊協定緩衝區。關於如何使用通訊協定緩衝區產生 pb3 檔案的一般資訊，請參考這個 Java 中的範例。