如何取得我的 Google 商業 API
你有做到以下這些嗎?
- 前往 Google 商家檔案 API 請求表單。
- 填寫申請表。Google 需要知道你為什麼想要存取 API。
- 等待核准。 一旦你的專案被列入白名單,你將收到一封電子郵件。在此核准之前,你無法在 n8n 中進行 API 呼叫。
這只是第一階段。核准後,請設定你的專案以進入第二階段:
-
建立專案:
- 前往 Google Cloud Console。
- 建立一個新專案(例如「n8n-Business-Automation」)。
-
啟用 API:
- 前往 API 和服務 > 程式庫。
- 搜尋並啟用以下項目:
Google Business Profile Management APIMy Business Business Information APIMy Business Account Management API
-
設定 OAuth 同意畫面:
- 前往 API 和服務 > OAuth 同意畫面。
- 選擇 外部(除非你有 Google Workspace 組織且只想供內部使用)。
- 填寫必要的應用程式名稱和開發者電子郵件。
- 範圍: 新增商家檔案 API 所需的範圍(通常在 API 文件中找到,例如
https://www.googleapis.com/auth/business.manage)。 - 測試使用者: 當你的應用程式處於「測試」模式時,你必須將自己的 Google 電子郵件地址新增為測試使用者,否則你會收到「403 存取被拒」錯誤。
-
建立憑證:
- 前往 API 和服務 > 憑證。
- 按一下 建立憑證 → OAuth 用戶端 ID。
- 應用程式類型:網頁應用程式。
- 授權的重新導向 URI: 這很關鍵。前往你的 n8n 實例,開啟 Google 商家檔案節點,建立新憑證,並複製 n8n 提供的 OAuth 重新導向網址。將該網址貼在此處。
- 按一下 建立 並複製你的 用戶端 ID 和 用戶端密鑰。
連接到 n8n:
- 開啟你的 n8n 工作流程。
- 新增 Google 商家檔案節點。
- 在憑證區段中,選擇「建立新憑證」。
- 貼上你從 Google Cloud Console 取得的用戶端 ID 和用戶端密鑰。
- 按一下使用 Google 登入。
- 將出現一個彈出視窗。選擇你的帳戶並按一下「繼續」(你可能會看到應用程式未經驗證的警告;按一下「進階」 → 「前往 [你的應用程式名稱](不安全)」以繼續)。
- 授權後,n8n 中的狀態應變更為已連線。
1. 先檢查你是否符合資格
Google 要求你管理的商家檔案必須經過驗證且保持活躍 60 天以上,才能申請。如果你的商家檔案還不滿 60 天,申請會被拒絕。
2. 建立 Google Cloud 專案
進入 Google Cloud 控制台,點擊「建立專案」,輸入專案名稱後建立。使用獨立的新專案而不是現有的沙箱環境,這樣核准流程和配額管理會更清楚。
3. 提交存取權限申請
透過 GBP API 聯絡表單申請 Business Profile API 的存取權限,然後等待核准。核准不是立即進行的,通常需要數天到幾週的時間,如果表單中沒有清楚說明你要開發什麼功能以及為什麼需要這些 API,很容易被拒絕。
4. 核准後啟用 API
Google 在 2022 年將舊的單一「My Business API」拆分成八個目的明確的 API。這些 API 涵蓋帳戶管理、商家資訊、評論、貼文和成效數據等功能。在 Cloud 控制台的「API 函式庫」中,只啟用你實際需要的 API,而不是全部八個,啟用的 API 越少,日後如果需要更多存取權限時,審核流程會更順利。
5. 設定 OAuth 2.0 認證
由於這些 API 會存取私密的商家資料,你需要設定 OAuth 2.0 用戶端 ID:進入 Cloud 控制台的「認證」,點擊「建立認證」→「OAuth 用戶端 ID」,然後保存用戶端 ID 和用戶端密鑰。你的自動化工具會使用這些資訊進行身份驗證。
對於 Google 商家資料,重要的是 API 存取不只是一般的 Google 登入。通常需要兩者:
1. 可以存取商家資料位置的 Google 帳戶。
2. 為 Google Cloud 專案核准的 Google 商家資料 API 存取權限。
實際的步驟是:
- 建立或選擇 Google Cloud 專案。
- 啟用相關的商家資料 API。
- 設定 OAuth 同意畫面和認證資訊。
- 如果您的專案還沒有存取權限,請提交 Google 商家資料 API 存取請求。
- 核准後,在 n8n 中重新連接 OAuth 認證資訊。
在 n8n 中,我會先建立一個唯讀測試工作流程,以擷取位置/評論資料並將結果寫入表格或試算表。一旦運作正常,再加入 AI 草稿步驟。對於公開評論回覆,在發佈任何內容之前,請保留人工核准步驟。