預訂伺服器已準備就緒

您需要預訂伺服器，才能讓動作中心進行回呼，代您建立及更新預訂。這個方式可讓 Actions Center 代替使用者向您進行預約和預訂。

如要瞭解如何設定與沙箱和實際執行環境中預訂伺服器的連線，請參閱「設定預訂伺服器憑證」。

請先完成下列「預訂伺服器準備就緒」工作，再前往「即時更新」：

透過 Sandbox 預訂流程，將準確的即時房源詳細資料傳送至預訂伺服器要求後，各項工作就會標示為完成並變成綠色。系統會分析 14 天內的預訂伺服器里程碑。

導入 REST API 介面

導入以 REST 為基礎的 API 介面。這樣一來，Google 就能透過 HTTPS 傳送預訂伺服器要求。

如要實作 API 介面，請設定可連線至 Actions Center 沙箱環境的開發或沙箱預訂伺服器。您必須先完整測試沙箱伺服器，才能移至實際執行環境。

Google 所有的預訂伺服器要求，都以在「預訂伺服器」頁面中設定的預訂伺服器網址為基準。舉例來說，如果您將網址設為 api.example.com/google，那麼所有的 HealthCheck 要求都會傳送至 api.example.com/google/v3/HealthCheck。

請務必使用環境切換器，為沙箱和正式環境設定正確的預訂伺服器端點。

安全性和驗證

所有與預訂伺服器的通訊都是透過 HTTPS 進行，並使用基本驗證。為協助您設定伺服器，建議使用公開提供的安全資料傳輸層 (SSL) 或傳輸層安全標準 (TLS) 驗證工具，例如 Qualys 的安全資料傳輸層 (SSL) 伺服器測試。

Google 對預訂伺服器發出的所有要求，都會透過 HTTPS 基本驗證進行驗證。您可以在�憑證必須每六個月變更一次。

建構預訂伺服器

預訂伺服器會決定整合服務與系統的通訊方式，並建立或更新預訂。如要設定與沙箱及實際執行環境中預訂伺服器的連線，請參閱「設定預訂伺服器憑證」。

預訂伺服器對「透過 Google 預訂」要求做出的每個回應，都應包含準確的即時商品目錄詳細資料。下表列出每種導入的方法，並包含服務通訊協定格式的連結：

方法 定義 回應 HTTP 要求
BatchAvailabilityLookup 載入網頁

使用者點選商家「預訂座位」時，系統會在網頁載入時呼叫 BatchAvailabilityLookup 要求。

酬載包含許多根據最新動態饋給上傳內容的時段，這些時段會被「透過 Google 預訂」視為可預訂。

 回應必須包含每個時段要求和時段目前的空位情況。這樣一來，系統就不會顯示任何無法預約的時段。 POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup 點擊版位 系統向使用者顯示可預訂的時段，使用者點按時段後，系統會呼叫 BatchAvailabilityLookup 要求。 回覆內容必須反映時段目前的實際供應情形。如果時段在點選前已預訂完畢，請傳回無法預訂的回應。 POST /v3/BatchAvailabilityLookup/
CreateBooking 使用者在預訂模式中確認要預訂所選時段時，系統會傳送 CreateBooking 要求。

回應必須代表預訂成功或失敗。

如果預訂失敗，請傳回失敗的具體原因。舉例來說，在呼叫 CreateBooking 回應之前，該時段已預訂完畢。

如果成功建立預訂，回應會包含專屬的 booking_id，以便在日後的要求或更新中參照該預訂。

 POST /v3/CreateBooking/
UpdateBooking 使用者透過「透過 Google 預訂」完成預訂後，可以選擇修改預訂。使用者更新或取消預訂時，系統會傳送 UpdateBooking 要求。 與 CreateBooking 回應類似，您對 UpdateBooking 的回應必須代表預訂成功，或傳回失敗的具體原因。 POST /v3/UpdateBooking/
HealthCheck 動作中心會定期呼叫預訂伺服器，確認基礎架構是否處於啟用及運作狀態。

請使用 HTTP 狀態碼來表示伺服器的服務狀態。 如果伺服器處於啟用狀態且順利運作，請傳回 HTTP 狀態碼 200。

如要指出錯誤或暫時將整合功能離線，請傳回適當的非 2xx HTTP 狀態碼。

 GET /v3/HealthCheck/

沙箱預訂流程

如要查看沙箱預訂流程，請前往動作中心「目錄」檢視畫面。在「目錄」檢視畫面中，RwG - E2E 欄會顯示「Live (in Sandbox)」連結，供相符且未來有空檔的沙箱商家使用沙箱預訂流程。

預訂流程中的動作如下：

  • 點選「RwG - E2E」連結後，系統會在網頁載入時觸發 BatchAvailabilityLookup 要求，並顯示商家已知的供應情形。
  • 點選預約時間時，系統會觸發 BatchAvailabilityLookup 點選預約時段要求，並顯示預約模式。
  • 使用預訂模式完成預訂，即可傳送 CreateBooking 要求。
  • 在沙箱環境中完成預訂後，用於建立預訂的帳戶會收到內含預訂詳細資料的確認電子郵件。
  • 如要觸發 UpdateBooking 方法，請透過電子郵件變更或取消預訂。

健康狀態檢查

請務必在沙箱和正式環境中實作 HealthCheck 方法。這個方法會傳回預訂伺服器的狀態，協助 Google 持續監控預訂伺服器的服務狀態。

要求：無

傳回值：無

請使用 HTTP 狀態碼來表示伺服器的服務狀態。

如果伺服器處於啟用狀態且順利運作，請傳回 HTTP 狀態碼 200；如要表示發生錯誤，請傳回其中一個 HTTP 狀態碼。