透過商家檔案新增地點

商家檔案是一項免費且簡單好用的工具，可供商家和機構組織管理在 Google 各項服務 (例如 Google 搜尋和 Google 地圖) 中的網路形象。

Google Business Profile API 提供介面，可用於管理 Google 上的商家地點資訊。商家可以透過 OAuth 同意聲明，將存取權授予其他商家，以便代為管理商家檔案。

商家檔案中的管理式商家已通過商家檔案驗證程序。您可以擴充商家檔案 OAuth 同意聲明流程，將這些商家加入 Business Messages，並自動驗證，以便在 Business Messages 上推出。

這是啟動 Business Messages 的更具彈性且更快速的方法，也是建議的流程，可為商家檔案地點啟用訊息功能。

必要條件

您必須是現有的商家檔案合作夥伴，才能存取 Google Business Profile API。如果不是，請按照商家檔案前置條件申請存取權。

取得 Google 商家檔案 API 存取權後，請按照基本設定和 OAuth 設定指南操作說明，再繼續操作。

為已驗證的商家檔案實體據點啟用商家訊息

下圖說明您的網路服務如何利用品牌的商家檔案位置驗證，為商家訊息服務代理人提供服務。請參閱下方的詳細操作說明。

使用商家檔案驗證功能自動驗證服務專員的流程圖

  1. 在現有的 OAuth 同意聲明流程中，商家檔案帳戶擁有者授予您代為呼叫 Google 商家檔案 API 的存取權，請更新 API 範圍，納入以下項目：

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    這兩個權限都是自動驗證服務專員和商家地點的必要條件。

  2. 建立代理人，並使用 displayName 與您在前一個步驟取得的 OAuth 憑證所擁有的至少一個 Google 商家檔案商家資訊名稱相符。使用 Google 商家檔案 API 查詢地點，即可找出商家名稱。

    如要比對名稱，

    • 字元大小寫不拘。
    • 代理人的全名必須與商家檔案位置名稱中的首個字詞完全一致。舉例來說，名為「GBP Bakery」的代理程式會與「Gbp Bakery Mountain View」、「Gbp Bakery」和「gbp bakery sunnyvale」相符，但不會與「Bakery San Francisco」相符。

  3. 針對商家檔案中的每個地點，請使用相同的 placeId建立地點。從 Google Business Profile API 擷取地點時，商家檔案地點的 placeId 會包含在 LocationKey 物件中。

  4. 使用您建立的代理程式和取得的 OAuth 權杖，要求代理程式驗證。

    驗證要求需要品牌聯絡資訊。不過，如果代理人名稱與商家檔案名稱相符，且您取得的 OAuth 權杖具有正確的範圍，驗證程序就不會向品牌寄送電子郵件。

    如果您正確執行這項操作，驗證要求的輸出內容應會立即傳回 verificationState 的 VERIFICATION_STATE_VERIFIED。如果 verificationState 傳回的值不同，表示您在提出要求時可能未使用正確的 OAuth 權杖，或是代理人無法與商家檔案地點比對。

  5. 使用相同的 OAuth 權杖，針對商家檔案中商家擁有的所有地點要求地點驗證。

    與服務專員驗證一樣，如果您正確執行這項操作，驗證要求的輸出內容應會立即傳回 VERIFICATION_STATE_VERIFIED 的 verificationState。如果 verificationState 傳回不同的值，表示您在提出要求時可能未使用正確的 OAuth 權杖，或是商家檔案地點並非已聲明並驗證的商家。

  6. 使用進入點 LOCATION啟動代理程式。

  7. 如要為特定地點啟用訊息功能，請啟動您希望透過 Google 搜尋和 Google 地圖提供的特定地點。啟動程序開始後，系統會在幾小時內為每個啟動位置提供訊息，供使用者查看。

完成這些步驟後，所有消費者訊息都會發布至您註冊的 Business Messages webhook，您必須使用 Business Messages API 傳送回覆給消費者。