為了向 Google 要求唯讀存取權，SaaSMaestro 需要來自 Google Cloud 專案的 OAuth 用戶端。每個工作區都有自己的用戶端，在其「資料連結」分頁上設定；一個 Google Cloud 專案就能供所有工作區使用。
請先檢查：開啟工作區的「設定 → 資料連結」並查看「Google OAuth 設定」方塊。如果顯示「已設定」或「已在 .env 中設定」，表示已經完成，你可以直接連結 Google 帳戶。
誰可以執行
你正在檢視之工作區的擁有者和管理員。由於這項變更會影響工作區中每個人登入 Google 的方式，如果你在過去 15 分鐘內沒有輸入過密碼，系統會要求你再次輸入。
逐步說明
在工作區的「資料連結」分頁上點擊「Google OAuth 設定」方塊。設定視窗會引導你完成相同的五個步驟：
- 建立或選擇 Google Cloud 專案。任何專案都可以。
- 啟用三個 API：Google Analytics Admin API、Google Analytics Data API 和 Google Search Console API。
- 設定同意畫面。如果你要連結的每個 Google 帳戶都屬於你自己的 Google Workspace，請選擇「Internal」（內部）。否則請選擇「External」（外部），並在應用程式處於測試模式期間，將你要連結的每個 Google 帳戶新增為測試使用者。
- 建立 OAuth 用戶端，類型選擇「Web application」（網頁應用程式），並新增設定視窗中顯示的重新導向 URI。請使用其「複製」按鈕，確保完全一致。
- 貼上用戶端憑證：Client ID 和 Client secret，然後點擊「儲存憑證」。
測試設定
- 測試憑證會在不登入的情況下，向 Google 驗證 Client ID 和密鑰。
- 測試登入會執行完整的 Google 登入流程，如果成功，就會將該帳戶連結到你的工作區。
用戶端密鑰以加密方式儲存。若只要變更 Client ID，請將密鑰欄位留空，系統會保留已儲存的密鑰。「移除已儲存的憑證」會將其刪除。
常見錯誤
| Google 顯示 | 處理方式 |
|---|---|
redirect_uri_mismatch | Google Cloud 中的重新導向 URI 不完全相符。請從設定視窗重新複製，包括 http 或 https 以及結尾的路徑。 |
access_denied | 同意畫面為「External」（外部）且處於測試模式，而這個 Google 帳戶不是測試使用者。請在同意畫面的測試使用者中新增此帳戶。 |
| API 未啟用 | 專案中有一個 API 尚未啟用。請啟用後等待一分鐘再試一次。 |
invalid_client | Client ID 或密鑰錯誤，或用戶端已被刪除。請貼上新的憑證。 |
下一篇：連結 Google 帳戶。