常見問題

什麼是 GBP API？

Business Profile API 是程式設計介面，可讓開發人員編寫應用程式，以便管理商家檔案帳戶和位置資料。商家或其代表可以透過 API 管理資料在 Google 各項服務中的呈現方式，並控管共同管理資料的人員。您也可以透過 API 管理使用者建立的資料，例如相片、貼文和評論。

Business Profile API 的功能與商家檔案使用者介面幾乎相同，但提供一些 API 專屬功能。API 的使用者可以預期 Google 更新，就像使用者介面使用者一樣。

誰可以使用 Google GBP API？

GBP API 未對外開放。使用者必須要求存取 GBP API，才能使用這些 API。任何能證明使用 GBP API 的個人或公司，均獲準使用。以下是一些可證明企業合法性的建議：

  • 請使用與您的商家網域綁定的有效企業電子郵件地址。
  • 確認商家網站已更新並上線。

使用者是否能存取 Google 商家檔案 API，以便查詢任何 Google 商家檔案資料？

不可以。即使取得 Google 商家檔案 API 的存取權，除非擁有該 Google 商家檔案存取權，否則無法查詢 Google 商家檔案資料。

GBP API 使用者的相關政策為何？

合作夥伴必須遵守 Google 商家檔案政策，以及所有 API 政策和條款及細則。

使用者如何存取 GBP API？

您必須完成下列必要條件，才能成功建立您的第一個用戶端應用程式：

  1. 取得 Google 帳戶。
  2. 試用商家檔案。
  3. 在 Google API 控制台中建立專案。
  4. 要求 API 存取權：我們會在 14 天內審查要求。

使用者如何存取 GBP API 中的特定 API？

您必須在 Google API 控制台中啟用下列八個與商家檔案相關聯的 API：

  • Google My Business API 4.9 版，包含下列重要的功能 API 呼叫：
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • My Business Lodging API
  • My Business Place Actions API
  • My Business Notifications API
  • My Business Verifications API
  • My Business Information API
  • My Business Q&A API
  • Business Profile Performance API

如果使用者的應用程式要求存取權已獲核准，則系統會將八個 API 的標準預設配額授予該使用者。

Google 商家檔案 API 存取權的運作方式為何？

系統會授予 Google Cloud 專案層級的 GBP API 存取權。如果使用者 A 已為專案 # - 12345678 申請 Google Business Profile API 存取權，則系統會授予專案 # - 12345678 的存取權。因此，任何擁有 Google Cloud 專案存取權的使用者 (包括使用者 A) 都可以呼叫 Google Business Profile API。合作夥伴必須在需要存取權的情況下控管 Google Cloud 專案的存取權，才能避免遭到濫用。

貴公司是否有 API 和範例功能的相關摘要？

請參閱下表，瞭解不同的 API 及其功能。

API 參考說明文件 功能範例
Account Management API 說明文件
  • 管理位置存取權。
  • 在指定父項下，建立具有指定名稱和類型的帳戶。
  • 列出已驗證使用者的所有帳戶。
  • 列出指定帳戶的待處理邀請。
  • 將使用者擁有的帳戶移至其他帳戶。
  • 更新指定位置的管理員。
Business Information API 說明文件
  • Business Information API 可讓您管理商家檔案的生命週期，以及新增或管理 Google 商家檔案上的商家資訊。
  • 允許商家取得、建立、更新或刪除 Google 商家檔案。
  • 可讓商家取得或更新商家檔案屬性。
  • 可讓商家取得或搜尋連鎖店和商家檔案類別。
Lodging API 說明文件
  • 可讓您管理住宿資料，例如房源設施和 Google 商家政策。這個 API 僅適用於提供住宿服務 (例如飯店) 的商家。Lodging API 可讓開發人員更新 Google 商家檔案的住宿屬性。
Place Actions API 說明文件
  • 可管理商家的地點動作連結。
  • 將使用者重新導向，讓使用者執行特定動作，例如預約、訂位及訂購餐點外送。
Notifications API 說明文件
  • 啟用指定帳戶的通知設定管理。
Verifications API 說明文件
  • 開始某地點的驗證程序。
  • 回報特定語言某個地區所有符合資格的驗證選項。
Q&A API 說明文件
  • 可管理地點的問題和答案。
Business Profile Performance API 說明文件
  • 允許商家從 Google 擷取商家資訊的成效深入分析。
  • 洞察包括商家曝光、路線要求、來電點擊、網站點擊、預訂、訂餐、菜單互動等。
媒體 API 說明文件
  • 允許 API 開發人員上傳商家檔案的相片和影片。
Reviews API 說明文件
  • 讓商家在商家檔案中取得評論及回覆評論。
Local Posts API 說明文件
  • 讓商家能取得、建立或更新本地貼文。
FoodMenus API 說明文件
  • 可讓商家取得、建立或更新商家檔案的菜單。

合作夥伴如何設定帳戶結構，才能使用 Google 商家檔案 API？

如果您是為商家執行商家資訊管理的第三方合作夥伴：

商家如何授權 GBP API 合作夥伴代為管理商家資訊？

商家可透過兩種方式將存取權授予第三方合作夥伴：

  • OAuth 設定： 請參閱這份指南 ，瞭解第三方合作夥伴平台如何使用商家憑證，代表商家或商家編輯及存取 Google 商家檔案資料。

  • 擁有者或管理員存取權：如果商家已將第三方合作夥伴新增為 Google 商家檔案的管理員 (也就是 Google 商家檔案的主要擁有者)，則該第三方合作夥伴不必使用商家憑證，就能使用 Google 商家檔案 API 編輯及存取 Google 商家檔案資料。

    注意：強烈建議您只將自己新增為管理員，不要將自己新增為 Google 商家檔案的擁有者。

如果商家擁有超過 10 個營業地點，可以透過大量驗證的方式進行驗證嗎？

是的。你可以針對 10 個以上的商家檔案申請大量驗證。驗證完成後，您就能使用 Google 商家檔案 API 管理已發布的連鎖店地點，方法就跟管理其他位置一樣，但有一些例外。舉例來說，營業地點管理員的處理方式不同，可將自己加入加盟店。

各種 API 的配額限制為何？

如要查看標準配額限制，請參閱用量限制一文。如要提高上限，您可以提交標準配額要求。

可以申請多少配額？

配額是一種有限的資源。GBP API 支援團隊會確認您過去的配額用量，判斷您的配額提高要求是否符合資格。如果您的平均配額用量低於目前配額限制的 70%，可能會拒絕進一步提高配額限制。

Google 商家檔案合作夥伴可以建立正式版的測試帳戶嗎？

不行。很抱歉，目前無法透過 Google 商家檔案的 UI 或 API，在 Google 實際工作環境中建立假的 GBP 清單並進行測試。

大多數不實商家資訊都會遭我們的審核並停權。 建議您使用客戶資訊，並在下班後進行合作 (前提是請不要更改任何商家資訊的主要資訊，例如名稱、地址、類別)，或為貴公司總部建立商家資訊。 如要測試 API 回應以驗證清單或其他需要正式版清單的動作，可以使用「模擬 API 回應」。