Google Business Profile API 串接最麻煩的地方，不是寫程式碼，而是權限。這篇是我在開發「Google 商家評論同步」外掛時踩到的坑：明明已經送出 API 申請，也啟用了幾個看起來很像的 API，實際呼叫時卻遇到 429 quota_limit_value = 0、403 Google My Business API disabled，甚至在 Cloud Console 裡根本找不到 Google My Business API。
先說結論：Google Business Profile API 不是一般「搜尋 API → 啟用 → 拿 key」那種流程。它有額外的存取權限要求，部分 API 只有被核准的帳號和專案才看得到。如果你看不到 Google My Business API，不一定是你操作錯，很可能是 Google 還沒有把私人 API 權限開給你目前登入的帳號。
我遇到的情境：評論同步外掛需要讀 Google 商家評論
這次需求是做一個比較完整的 Google 商家評論同步外掛，架構採主從式分離：server 端控管 client，只有通過客戶驗證的網站才能讀取評論資料。理論上流程很直覺：申請 Google Business Profile API、設定 OAuth、拿 token、呼叫 reviews endpoint。實際做才發現，真正卡住的是 API 權限和 Cloud Console 裡的 API 可見性。
Google 官方的基本設定文件也提醒，使用 Business Profile APIs 前，要先完成專案建立、Organization account、API access request，收到核准後再啟用相關 API。換句話說，單純在 Cloud Console 裡亂搜 API，不一定會成功。
先搞清楚：GBP API 不是只有一個 API
很多人會被名稱搞混。Google Business Profile 相關功能拆成好幾個 API，例如：
- Google My Business API：舊版 / v4 API，很多 reviews endpoint 還會碰到它。
- My Business Account Management API：帳號與商家檔案管理相關。
- Business Information API：商家資訊、地點資料相關。
- Business Profile Performance API：成效數據相關。
所以你可能會遇到一個很尷尬的狀況：Account Management API 已經啟用了，但呼叫 reviews 時還是報錯，因為真正缺的是 mybusiness.googleapis.com 這個 Google My Business API endpoint。
錯誤一：429 quota_limit_value = 0，不是你打太快
我一開始看到 429，以為是 rate limit，也就是呼叫太頻繁。但仔細看錯誤內容才發現，配額不是被打爆，而是根本沒有配額：
{
"code": 429,
"status": "RESOURCE_EXHAUSTED",
"metadata": {
"service": "mybusinessaccountmanagement.googleapis.com",
"quota_limit": "DefaultRequestsPerMinutePerProject",
"quota_limit_value": "0"
}
}quota_limit_value = 0 的意思很直接：你的 Google Cloud 專案目前沒有被核准使用這個 API，不是你多等幾分鐘就會好。這時候要回頭確認：
- 你是否已經提交 Business Profile API access request。
- 申請時填的 Google Cloud Project ID 是否就是現在使用的專案。
- 收到 Google 核准信後，是否真的到 Cloud Console 啟用相關 API。
- 配額頁面中
DefaultRequestsPerMinutePerProject是否仍是 0。
錯誤二：403 Google My Business API disabled
另一個常見錯誤是 403，訊息大概會長這樣：
{
"code": 403,
"message": "Google My Business API has not been used in project ... before or it is disabled.",
"status": "PERMISSION_DENIED",
"metadata": {
"service": "mybusiness.googleapis.com",
"activationUrl": "https://console.developers.google.com/apis/api/mybusiness.googleapis.com/overview?project=..."
}
}這段的重點是 service: mybusiness.googleapis.com。它不是叫你只啟用 Account Management API，而是要啟用 Google My Business API 這個 endpoint。問題來了：很多人照錯誤訊息點進 Cloud Console，卻看不到這個 API。
重點流程：開通後仍看不到 Google My Business API 怎麼辦？
這是我後來聯絡 Google Business Profile API 支援團隊後，收到的關鍵流程。整理成可操作版本如下：
- 進入 Google Cloud Console。
- 確認右上角專案切換器已切到你申請 GBP API 時填的那個 Google Cloud 專案。
- 從左側或導覽進入 APIs & Services → Library，也就是 API Library。
- 在 API Library 頁面內搜尋 Google My Business API。
- 找到後進入 API 頁面，按 Enable。
重要：不要使用 Cloud Console 最上方的全站搜尋列。Google 支援團隊特別提醒，要從 API Library 裡面搜尋 Google My Business API，才比較能正確找到這個私人 API endpoint。
如果你在 API Library 裡仍然看不到 Google My Business API，下一步不是亂開別的 API，而是回覆 Google Business Profile API 支援團隊，提供你目前登入 Cloud Console 的電子郵件地址。Google 需要這個 email 來幫你的帳號配置權限，讓這個私人 API 對你可見。
我建議回覆 Google 支援的內容
如果你也遇到「申請通過但看不到 Google My Business API」，可以直接整理以下資訊給支援團隊：
- 目前登入 Cloud Console 的 Google 帳號 email。
- Google Cloud Project ID。
- Google Cloud Project Number。
- 你已收到 GBP API access approval 的時間或信件截圖。
- 你在 API Library 搜尋 Google My Business API 但找不到的截圖。
- 錯誤訊息中的
service、consumer、activationUrl。
這樣 Google 支援比較容易判斷，是專案沒有核准、帳號沒有被配置私人 API 權限，還是你切錯 Google Cloud 專案。
完整排查順序：不要一開始就改程式碼
我會建議照這個順序查：
- 先確認 Google Cloud Project ID 是否和申請時一致。
- 確認 OAuth consent screen、OAuth client ID 已設定。
- 確認 Business Profile API access request 已通過。
- 進 API Library 啟用 Google My Business API，不要用頂部搜尋列。
- 再啟用 Account Management、Business Information 等相關 API。
- 到 Quotas 頁面確認配額不是 0。
- 重新產生或刷新 OAuth token，再測 API。
- 如果仍看不到 API，把登入 email 提供給 Google 支援配置權限。
這個順序很重要。因為很多時候錯不在程式碼，而是 API 根本沒有對你的帳號或專案開放。你改 client library、改 token、改 scope，通常只是原地打轉。
常見問題 FAQ
Google Business Profile API 429 一定是呼叫太頻繁嗎？
不一定。如果錯誤內容出現 quota_limit_value = 0，通常代表專案尚未被核准使用該 API，或配額尚未開通。這時不是等一等就好，而是要確認 API access request、專案 ID 和配額設定。
為什麼 Cloud Console 找不到 Google My Business API？
Google My Business API 有額外存取權限要求，不是每個 Google Cloud 帳號都能看到。如果 API Library 裡搜尋不到，需要聯絡 Google Business Profile API 支援，提供目前登入的 email，請他們配置私人 API 可見權限。
Google My Business API 和 My Business Account Management API 一樣嗎？
不一樣。Account Management API 偏向帳號與商家檔案管理；Google My Business API 則是舊版 v4 相關 endpoint，很多 reviews API 錯誤會指向 mybusiness.googleapis.com。串接評論時兩者很容易被混淆。
啟用 API 後還要等多久才能呼叫？
Google 錯誤訊息通常會提醒，剛啟用 API 後需要幾分鐘傳播時間。如果只是剛按 Enable，可以等幾分鐘再重試；但如果配額仍是 0 或 API 根本不可見，就要回頭處理權限與支援配置。
要提供什麼資料給 Google GBP API 支援？
建議提供登入 Cloud Console 的 email、Google Cloud Project ID、Project Number、核准信截圖、API Library 找不到 Google My Business API 的截圖，以及錯誤訊息中的 service、consumer、activationUrl。
