透過商家檔案加入地點

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

Google Business Profile API 提供了一個介面，可用來管理 Google 上的商家地點資訊。商家可以透過 OAuth 同意授權其他商家管理其商家檔案。

商家檔案上的受管理商家已透過商家檔案驗證程序完成驗證。您可以延伸商家檔案 OAuth 同意流程，讓這些商家加入 Business Messages 服務，並自動驗證這些商家，以便在 Business Messages 中啟動。

這個方法更靈活、更快，可啟動 Business Messages 功能，這也是啟動商家檔案地點訊息的建議流程。

必要條件

您必須是可存取 Google Business Profile API 的現有商家檔案合作夥伴。否則，請按照商家檔案先決條件申請存取權。

取得 Google Business Profile API 存取權後，請先按照其基本設定和 OAuth 設定指南操作，再繼續操作。

為已驗證的商家檔案地點啟用 Business Messages

下圖說明您的網路服務如何利用該品牌在商家檔案訊息中的商家檔案進行位置驗證。詳細操作說明如下。

使用商家檔案自動驗證代理程式的流程圖

  1. 在現有的 OAuth 同意流程中，商家檔案帳戶擁有者可授予您呼叫 Google Business Profile API 的權限，請更新 API 範圍以納入

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

    您需要這兩個範圍，才能自動驗證代理程式和商家位置。

  2. 請使用 displayName 來建立代理程式，且該名稱必須與您在上一步取得的 OAuth 憑證中，包含至少一個 Google 商家檔案資訊的名稱相符。使用 Google Business Profile API 查詢地點，找出商家名稱。

    名稱比對

    • 字元大小寫不區分大小寫。
    • 代理程式的全名必須與商家檔案地點名稱中的第一個字完全相同。例如，名為「GBP Bakery」的代理程式符合「Gbp Bakery Mountain View」、「Gbp Bakery」和「gbp 控制項 sunnyvale」的比對結果，但是卻找不到「Bakery San Francisco」。

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

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

    驗證要求需要品牌聯絡資訊。不過，如果代理程式名稱與商家檔案名稱相符，且您取得的 OAuth 憑證範圍正確無誤，則驗證程序不會傳送電子郵件給品牌。

    如果已正確完成這項作業，驗證要求中的輸出內容應該會立即傳回 VERIFICATION_STATE_VERIFIED 的 verificationState。如果 verificationState 傳回不同的值，則在提出要求時，您可能未使用正確的 OAuth 憑證，或是無法將代理程式對應至商家檔案位置。

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

    如同代理程式驗證，如果已正確完成這項作業，驗證要求中的輸出內容應會立即傳回 VERIFICATION_STATE_VERIFIED 的 verificationState。如果 verificationState 傳回不同的值，則您在提出要求時可能並未使用正確的 OAuth 憑證，或者商家檔案地點並非已聲明擁有權且通過驗證的商家。

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

  7. 可啟動您想要透過 Google 搜尋和 Google 地圖取得特定地點的訊息。啟動程序啟動後，使用者會在幾小時內看到各個啟動位置的訊息。

完成上述步驟後，所有消費者訊息都會發布到您註冊的 Business Messages Webhook，且您必須使用 Business Messages API 傳送回應給消費者。