預訂伺服器已準備就緒

你需要預訂伺服器，才能讓 Actions Center 代表你建立及更新預訂。這個方式可讓 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 Actions Center 會定期呼叫預訂伺服器，確認基礎架構是否處於啟用狀態並正常運作。

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

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

 GET /v3/HealthCheck/

里程碑條件

如要完成「預訂伺服器準備就緒」里程碑，您的整合服務必須在沙箱和正式環境中符合下列條件：

方法 必要 要求數量 (沙箱) 必要要求數 (製作) 必要成功率
BatchAvailabilityLookup 載入網頁 20 20 90%
BatchAvailabilityLookup 點擊廣告空間 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

沙箱預訂流程

如要查看沙箱預訂流程，請前往 Actions Center「目錄」檢視畫面。在「目錄」檢視畫面的「RwG - E2E」欄中，系統會為相符且未來有空檔的 Sandbox 商家顯示「Live (in Sandbox)」連結，方便商家進入 Sandbox 預訂流程。

預訂流程中的動作如下：

  • 點選「RwG - E2E」連結後，系統會在網頁載入時觸發 BatchAvailabilityLookup 要求，並顯示商家已知的供應情形。

  • 點選預約時間時，系統會觸發 BatchAvailabilityLookup 上的預約時段點選要求，並顯示預約模式。

  • 使用預訂強制回應完成預訂，即可傳送要求。CreateBooking

  • 在沙箱環境中完成預訂後，用於建立預訂的帳戶會收到內含預訂詳細資料的確認電子郵件。

  • 如要觸發 UpdateBooking 方法，請透過電子郵件變更或取消預訂。

健康狀態檢查

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

要求：無

傳回值：無

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

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