使用 Maps Booking API 驗證

如要進行即時更新，您必須向 Maps Booking API 提出要求。Maps Booking API 規定，您必須使用可存取 API 的 GCP 服務帳戶，透過 OAuth 2.0 驗證要求，並分配了必要的 QPS。本指南將逐步引導您完成下列步驟：

  1. 設定 Google Cloud 專案
  2. 建立服務帳戶
  3. 在 GCP 專案中啟用 Maps Booking API
  4. 偵錯常見問題

如要瞭解如何向 API 提出要求，請參閱「在地生活服務廣告端對端指南」的「即時 API 更新」一節。

使用 Actions Center 設定 Google Cloud 專案

  1. 登入您的 Google Cloud Platform 帳戶。
  2. 您可以建立新專案或使用現有專案。
    • 請記下雲端專案編號，後續步驟將會用到。您也可以在 Google Cloud Platform 首頁找到 Cloud 專案編號。Cloud 專案編號一律僅限數字。
  3. 登入合作夥伴入口網站。
  4. 在合作夥伴入口網站的「新手上路工作」頁面上，提交 Cloud 專案編號和 Cloud 專案電子郵件地址 (用來管理雲端專案的電子郵件地址)，完成步驟 1。

建立服務帳戶和 OAuth 憑證

  1. 重新登入 Google Cloud Platform 帳戶。
  2. 依序前往「IAM 與管理」>「服務帳戶」。
  3. 搜尋現有或新建立的 Cloud 專案 ID。
  4. 建立服務帳戶。
  5. 填妥服務帳戶詳細資料。
  6. 請為新的服務帳戶指派最適合您應用程式的角色。服務帳戶的角色不會影響可對 Google Maps Booking API 發出的呼叫，這是因為這些呼叫所分配到的配額足夠，取決於 Actions Center 設定中專案編號的關聯而決定。 如果不確定該選擇何種角色，請依序選取「Project」>「Viewer」。
  7. 在步驟 (6) 按一下「繼續」後，畫面上就會顯示建立 JSON 金鑰的選項。
  8. 儲存 JSON 憑證。請務必將這些項目儲存在安全的地方，因為之後無法擷取。
  9. 重新登入合作夥伴入口網站，然後在合作夥伴入口網站的「新手上路工作」頁面上完成其餘工作。

啟用 MapsBooking API

  1. 登入您的 Google Cloud Platform 帳戶。
  2. 依序前往「API 和服務」>「資訊主頁」。
  3. 按一下「啟用 API 和服務」，然後搜尋 Google Maps Booking API。
  4. 啟用下列 API：
    • Google Maps Booking API
    • Google Maps Booking API (開發人員)

常見錯誤

提出即時更新要求時，可能會因為各種原因而遇到授權問題。如需提出即時更新要求的一般指引，請參閱「在地生活服務廣告端對端指南」的「即時 API 更新」一節。您也可以在「程式碼範例」一節中找到多種語言的範例用戶端。

如果遇到 403 錯誤，請確認您符合下列所有需求條件：

  1. 使用 Google 用戶端程式庫。
  2. 使用服務帳戶驗證建立 OAuth 憑證。
  3. 依據適當範圍授權。
  4. 呼叫適當的端點 (列於下方)。

確認您會呼叫正確的端點：

  1. 沙箱：https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. 正式版：https://mapsbooking.googleapis.com/v1alpha/...

確認您已正確授權 OAuth 憑證要求：

  1. 您正在授權「https://www.googleapis.com/auth/mapsbooking」範圍。
  2. 您正在使用在建立服務帳戶和 OAuth 憑證一節中建立的服務帳戶金鑰。

還是出現錯誤嗎？

如果完成上述步驟後仍看到錯誤訊息，請洽詢您的 Actions Center 聯絡人並提供下列資訊：

  • 含有螢幕截圖的 Cloud 專案編號和專案 ID
  • 服務帳戶 ID
  • 用來建立服務帳戶的電子郵件
  • 端點詳細資料嘗試傳送要求
  • 要求嘗試時間
  • 提出要求時所收到的完整要求與錯誤訊息。