常見問題

什麼是 GBP API？

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

Business Profile API 提供的功能幾乎與 Business Profile 使用者介面相同，但也有一些 API 專屬的額外功能。API 使用者可預期 Google 更新會與使用者介面使用者一樣發生。

誰可以存取 GBP API？

GBP API 並未對外開放。使用者必須申請 GBP API 存取權，才能使用這些 API。任何個人或公司，只要能證明有合法的業務理由來存取 GBP API，即可獲得存取權。以下是幾項建議，可證明您是合法商家：

  • 使用與商家網域相關聯的有效商家電子郵件地址。
  • 確認商家網站已更新且處於有效狀態。

使用者是否可以透過 GBP API 查詢任何 Google 商家檔案資料？

不可以。即使您可以存取 Google 商家檔案 API，也就無法查詢 Google 商家檔案資料，除非您能存取該 Google 商家檔案。

Google 商家檔案使用者的相關政策為何？

合作夥伴必須遵守《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 Business Information API
  • My Business Q&A API
  • Business Profile Performance API

如果使用者提出的存取權要求申請獲得核准，系統會授予該使用者所有八個 API 的標準預設配額。

如何存取 GBP API？

GBP API 存取權是在 Google Cloud 專案層級授予。如果使用者 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 說明文件
  • 開始驗證地點。
  • 以特定語言回報某個地區的所有適用驗證選項。
問與答 API 說明文件
  • 可管理地點的提問和解答。
Business Profile Performance API 說明文件
  • 允許商家擷取 Google 商家資訊的成效洞察資料。
  • 洞察資料包括商家曝光次數、路線要求、來電點擊次數、網站點擊次數、預訂、餐點訂單、選單互動等。
Media API 說明文件
  • 允許 API 開發人員為商家檔案上傳相片和影片。
Reviews API 說明文件
  • 允許商家在商家檔案中取得評論，並回覆評論。
Local Posts API 說明文件
  • 允許商家取得、建立或更新本地貼文。
FoodMenus API 說明文件
  • 允許商家取得、建立或更新商家檔案的餐點菜單。

如果您對可用資料及 / 或如何存取資料仍有疑問，請使用以下表單提交要求：

合作夥伴該如何設定帳戶結構來使用 GBP API？

如果你是為商家管理商家資訊的第三方合作夥伴，請按照下列步驟操作：

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

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

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

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

    注意：強烈建議第三方合作夥伴不要將自己新增為 Google 商家檔案的擁有者，而是只將自己新增為管理員。

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

可以。你可以針對 10 個以上的商家檔案提出大量驗證申請。驗證完成後，您就可以使用 Business Profile API 管理已發布的連鎖店地點，管理方式與其他地點相同，但有些許例外。舉例來說，網站管理員的處理方式不同，且可將自己新增到加盟店地點。

各種 API 的配額限制為何？

標準配額限制列於「用量限制」一節。如需提高上限，您可以提交標準配額申請。

我可以申請多少配額？

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

GBP API 合作夥伴可以建立實際工作環境的測試帳戶嗎？

不可以。很遺憾，您無法透過 GBP UI 或 API 直接在正式環境中建立 Google 商家檔案資訊並進行測試。

大多數的假商品資訊都會被審核人員標記並停權。建議的做法是使用客戶資訊，並在幾個小時過後繼續運用 (前提是不會變更任何商家資訊的主要資訊，例如名稱、地址和類別)，或是為公司總部建立商家資訊。如果您想測試 API 回應，以驗證產品資訊或任何需要產品資訊的其他動作，可以使用模擬 API 回應。