即時更新已準備就緒

由於你的商家可能會有新的預訂、取消和排程變更，因此系統中的供應存量會跟著波動。即時更新 (RTU) API 是一種機制，可通知 Google 這些變更，以及現有預訂的變更。

在下列情況中，您必須使用 RTU：

  • 使用者在你的系統上取消預訂，因此該時段可供預訂。
  • 使用者透過 Actions Center 預訂，但該時段已無法預訂。
  • 透過 Actions Center 進行的預訂由你這端取消。舉例來說，商家直接取消預訂。由於原本的時段現已重新開放預訂，因此你必須更新該預訂和供應情形。

在進入沙箱審查前，請先完成下列 RTU 里程碑工作：

如果最後 20 項要求在 14 天內都沒有錯誤，系統就會將每項工作標示為完成並顯示綠色。請繼續傳送成功的要求，確保里程碑維持綠色。

API RTU 和動態饋給

API RTU 可即時通知 Google 有關供應存量情形及預訂的漸進式變更。除了 RTU 之外，每天也要傳送完整的供應情形動態饋給。確保 Google 掌握系統中最新最準確的供應情形資訊。完整的動態饋給可做為數據匯報，讓我們瞭解您目前系統中供應存量情形的最新狀態。

詳情請參閱下列資源：

使用 API

您將透過 Google Cloud 專案存取 Actions Center 的 Maps Booking API，並透過該 API 提交 RTU。您必須在 Google 開發人員控制台中使用 Google 帳戶，並在新手上路計畫的「設定」里程碑中提供 Cloud 專案編號。如要進一步瞭解如何啟用 Cloud API，請參閱「啟用 Cloud API」。

使用符合 REST 樣式的呼叫或下載用戶端程式庫

建議您使用 JSON 酬載直接對 Maps Booking API 執行 符合 REST 樣式的呼叫。詳情請參閱 REST API 說明文件。

您也可以使用用戶端程式庫連線至 API。

。
語言 下載連結
Java Java 用戶端程式庫。詳情請參閱 Java 用戶端操作說明。

您可以下載額外的支援程式庫， 以用來處理授權及對 Google API 發出的 其他方面的呼叫。詳情請參閱「程式碼範例」。

擷取「探索」文件

針對特定用戶端程式庫 (例如 Ruby)，您必須為該 API 擷取「探索」文件， 其中會說明 API 方法和參數。

如要擷取探索文件，請使用下列指令：

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

如要進一步瞭解如何透過 Ruby 存取 API，請參閱 Ruby API 用戶端和 Ruby 驗證程式庫。

對 API 發出授權呼叫

如要向 API 發出呼叫，請參閱「對 API 發出委派呼叫的相關準備事項」，並使用私密金鑰及以下 OAuth 範圍來授權您的服務帳戶：

https://www.googleapis.com/auth/mapsbooking

沙箱和正式環境端點

您可以透過 API 向沙箱和實際執行環境 發出呼叫。請務必在 Google Cloud 專案中啟用這兩個 API。這兩個 API 都使用同樣的範圍，但具有不同的端點。

正式版端點：https://mapsbooking.googleapis.com/

沙箱端點：https://partnerdev-mapsbooking.googleapis.com/

以下範例說明如何在 Java 中切換端點：

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()