n8n 怎麼連上你的 Gmail 跟 Drive？Google OAuth 設定 20 分鐘搞定

n8n 要代替你操作 Gmail、Drive、Sheets 這些 Google 服務，不能像一般 API 那樣貼一串 Key 就好。Google 強制要求走 OAuth 授權：你要「親自同意」讓 n8n 動你的東西。

這篇教你在 Google Cloud 跟 n8n 之間設好一把 OAuth 鑰匙。設一次，之後 Drive、Gmail、Sheets、Calendar 全通。全程圖解，20 分鐘內搞定。

一、為什麼不能直接輸入 API Key？

因為你要 n8n 去動「你的」 Drive、Gmail、Sheets 資料。Google 不能光憑一串密碼就把你的東西交給 n8n，它要你「親自授權」。

差別像這樣：

類型	API Key	OAuth 2.0
比喻	房子的鑰匙（給誰就能進去）	飯店的房卡（本人去櫃台辦理、授權給特定人、可隨時撤銷）
適用場景	公開資料（查天氣、翻譯）	會碰到你個人資料的服務（Gmail、Drive、Sheets）
安全性	低（拿到就能用）	高（要本人按同意、可隨時收回）

Drive 跟 Gmail 這種會碰到個人資料的，Google 強制要走 OAuth，沒得選。

二、先搞懂三方關係

整套 OAuth 就是三個角色在互動：

角色	你（資料主人）	n8n（仲介）	Google（資料保管者）
做什麼	Gmail / Drive / Sheets 都是你的，你說了算	想代表你去存取 Google 資料做自動化	手上有你的資料，只認你授權給誰

所以我們要做的事：到 Google 那邊登記一個叫 n8n 的「應用程式」（PART 1-3 在 GCP 做），然後在 n8n 用這個身份去敲 Google 的門（PART 4 在 n8n 做）。中間 Google 會跳視窗問你「你真的要授權 n8n 嗎？」按同意，n8n 才能用。

三、流程總覽

階段	做什麼	在哪裡做	花多久
PART 1	建專案 + 啟用你需要的 Google API	Google Cloud Console	5 分鐘
PART 2	設 OAuth 同意畫面（Google 強制順序）	Google Cloud Console	5 分鐘
PART 3	建 OAuth 用戶端，拿到 ID + Secret	Google Cloud Console	3 分鐘
PART 4	n8n ↔ GCP 來回接線，按授權	n8n + GCP 交叉操作	5 分鐘

💡

PART 1-3 只做一次。之後想加 Gmail、Sheets、Calendar，只要重複 PART 1 的「啟用 API」+ PART 4 的「建憑證」就好。全部確認能跑之後，記得回 PART 2 步驟 3 處把 App 發布成正式版，避免 7 天斷線。

四、PART 1：建專案 + 啟用你需要的 API

步驟 1｜登入 Google Cloud，建一個專案

目的：Google Cloud 用「專案」分裝你的東西。建一個專門給 n8n 用的專案，未來所有 n8n 相關設定集中在這裡。

去 console.cloud.google.com，用你常用的 Google 帳號登入

第一次登入：選國家 Taiwan、勾同意條款、按同意並繼續

畫面頂端中央點「選取專案」按鈕

跳出視窗右上角點新增專案

專案名稱填 n8n-001（或你喜歡的名字），按建立

✅ 成功標誌：畫面頂端顯示你取的專案名稱（如 n8n-001）。

💡

第一次用 Google Cloud 可能要綁信用卡。Drive、Gmail、Sheets 這三個 API 在免費額度內通常不產生費用。建議進 GCP 左側選單「帳單 → 預算與快訊」設一個 NT$0 的預算警示，一花到錢就會通知你。

⚠️

建議用個人 Gmail 而不是學校或公司帳號。學校和公司帳號常被組織政策擋，會導致後面步驟過不了。

步驟 2｜啟用你需要的 Google API

目的：Google Cloud 預設什麼 API 都沒開。要用哪個服務，就要去找到那個 API 的開關按啟用。

常用的 Google 服務對應 API：

你想在 n8n 用的服務	要啟用的 API 名稱	搜尋關鍵字
Google Drive（雲端硬碟）	Google Drive API	`drive`
Gmail（收發信）	Gmail API	`gmail`
Google Sheets（試算表）	Google Sheets API	`sheets`
Google Calendar（日曆）	Google Calendar API	`calendar`

專案建立完成，頂端顯示 n8n-001 與右上角搜尋放大鏡

以 Drive 為例（其他服務同一個操作，只是換搜尋關鍵字）：

頁面頂端右邊找放大鏡圖示（搜尋按鈕），點它

搜尋列輸入 drive

結果第一筆是 Google Drive API（旁邊寫 Marketplace），點它

進到產品詳細資料頁，按啟用

重複以上動作，分別搜 gmail、sheets、calendar，把你需要的 API 全部啟用

✅ 成功標誌：每個 API 按完啟用後，看到「已啟用 API」或進入該 API 管理頁面。

💡

啟用是一次性動作。同一個專案下，一個 API 啟用過就永遠是開的，不用重複操作。

五、PART 2：設 OAuth 同意畫面

⚠️

這段是 Google 強制的順序：必須先設好同意畫面，才能建用戶端。沒設就沒視窗可跳，整套 OAuth 走不通。

步驟 1｜進到「OAuth 同意畫面」設定

目的：找到 OAuth 同意畫面設定的入口。

左上角點漢堡選單（三條橫線），找 API 和服務，子選單點憑證

左側選單點「OAuth 同意畫面」

第一次進去會出現「Google Auth Platform」歡迎畫面，按引導開始設定

✅ 成功標誌：看到引導流程的第一頁（要你填應用程式資訊）。

💡

2024 年底 Google 把這塊整理成「Google Auth Platform」獨立功能區，左側選單分成品牌、目標對象、用戶端等好幾頁。第一次進去 Google 會用引導流程帶你設好，跟著按就好。

步驟 2｜填應用程式資訊 + 目標對象選「外部」

目的：告訴 Google 這個 App 叫什麼、誰能用。

第一頁「應用程式資訊」：名稱填 n8n，使用者支援電子郵件選你的 Gmail。按下一步

第二頁「目標對象」：選外部（個人帳號只有這個選項）。按下一步

第三頁「聯絡資訊」：開發人員電子郵件填你的 Gmail。按下一步

最後一頁勾「我同意 Google API 服務條款」，按建立

✅ 成功標誌：跳回 Google Auth Platform 主畫面，左側出現「總覽 / 品牌 / 目標對象 / 用戶端」分頁。

💡

「內部」要有付費 Google Workspace 帳號才能選，個人 Gmail 看不到這個選項。個人用一律選「外部」。

步驟 3｜加測試使用者（不加會被擋）

Google Auth Platform 目標對象頁，測試使用者區的 Add users 按鈕

目的：剛建的 App 是「測試」狀態，只有列在「測試使用者」清單裡的帳號才能授權。你一定要把自己加進去。

左側選單點「目標對象」

頁面捲到下面找「測試使用者」區，按 + Add users

輸入你自己的 Gmail（就是你要被 n8n 代理存取的那個帳號）

按儲存

✅ 成功標誌：你的 Gmail 出現在測試使用者清單中。

💡

Testing 狀態有一個坑：Google 會讓你的授權每 7 天自動過期，n8n 的自動化會靜默斷線，你得回去重新按一次授權。

長期使用的解法：回 Google Auth Platform 左側選單「發布應用程式」，按下去改成正式版（In Production）。個人自用通常不需通過 Google 審核，只是授權時會多一個「未驗證」警告畫面。（如果你的授權範圍涉及 Gmail 完整存取等敏感權限，Google 可能會要求額外驗證，一般 Drive + Sheets 不會。）發布後回 n8n 把原本的憑證斷開再重新授權（點憑證 → 斷開連線 → 重新 Sign in with Google），這樣拿到的新 Token 才不受 7 天限制。不用刪掉重建，同一組 Client ID 跟 Secret 繼續用就好。

六、PART 3：建立 OAuth 用戶端

步驟 1｜按「建立 OAuth 用戶端」

Google Auth Platform 總覽頁，標示「建立 OAuth 用戶端」按鈕

目的：建用戶端就是建一張「應用程式身份證」，建好後會拿到 ID 跟 Secret 兩串字。

Google Auth Platform 左側選單點總覽

頁面中央找到「建立 OAuth 用戶端」按鈕，點它

✅ 成功標誌：跳出「建立 OAuth 用戶端 ID」表單頁面。

步驟 2｜選「網頁應用程式」，名稱填 n8n

目的：n8n 是跑在瀏覽器裡的網頁應用，授權完 Google 要把你導回 n8n 的網址，只有選「網頁應用程式」才支援這個機制。

應用程式類型下拉選 網頁應用程式

名稱填 n8n

「已授權的 JavaScript 來源」留空

「已授權的重新導向 URI」先留空（下一段從 n8n 拿）

按建立

跳出視窗顯示用戶端 ID 跟用戶端密鑰，先別關視窗

✅ 成功標誌：看到「OAuth 用戶端已建立」彈窗，裡面有兩串長字串。

⚠️

「重新導向 URI」現在留空是正常的。那個網址要從 n8n 拿，接下來 PART 4 教你怎麼拿。

七、PART 4：在 n8n 跟 GCP 之間來回接線

這段是幫 n8n 跟 Google 互相認識、牽線：n8n 給 GCP 一個網址（讓 Google 知道授權完把人送回哪），GCP 給 n8n 兩串字（ID + Secret，讓 n8n 證明自己是合法的）。雙方都填完對方的資料，才會通。

步驟 1｜在 n8n 建 Google Drive OAuth2 憑證，拿 Redirect URL

n8n Credentials 頁，標示右上角 Create credential 按鈕

n8n 新增憑證視窗，搜尋 drive 並選取 Google Drive OAuth2 API

n8n 憑證頁，標出名稱、OAuth Redirect URL、Client ID、Client Secret 四個欄位

目的：先在 n8n 這邊開一個憑證頁面，拿到它自動產生的 Redirect URL。

打開 n8n（http://localhost:5678）

左側選單點 Credentials，右上角按紅色 Create credential

搜尋列輸入 drive，點 Google Drive OAuth2 API

上面幫憑證命名（例如 我的 Google Drive）

看到欄位 OAuth Redirect URL，右邊有複製按鈕，複製這個 URL

✅ 成功標誌：剪貼簿裡有一串像 http://localhost:5678/rest/oauth2-credential/callback 的網址。

⚠️

n8n 視窗先別關。等一下還要回來貼 ID 跟 Secret。直接開新分頁去 GCP。

步驟 2｜回 GCP，把 Redirect URL 貼到用戶端

GCP 編輯用戶端頁，將 n8n 的 Redirect URL 貼到「已授權的重新導向 URI」

目的：Google 收到這個 URL 後，才知道授權完成要把使用者送回 n8n。沒填會報 redirect_uri_mismatch 錯誤。

切回 Google Auth Platform，左側點用戶端

點剛建的 n8n 用戶端名稱進去編輯

找到「已授權的重新導向 URI」區塊，按 + 新增 URI

把從 n8n 複製的網址貼進去

按儲存

✅ 成功標誌：URI 欄位顯示你貼的 localhost 網址，頁面沒有報錯。

💡

同一個頁面右上角可以看到用戶端 ID 跟用戶端密鑰，下一步要複製這兩串。

步驟 3｜回 n8n，貼上用戶端 ID 跟密鑰

圖中 Client ID / Client Secret 欄位就是貼這兩串的位置（不需另外拖一張）

目的：用戶端 ID 是 n8n 的「身份證號碼」，密鑰是「密碼」。Google 認得這兩串，才把授權當合法。

從 GCP 複製用戶端 ID，貼到 n8n 的 Client ID 欄位

從 GCP 複製用戶端密鑰，貼到 n8n 的 Client Secret 欄位

✅ 成功標誌：n8n 憑證頁面三個欄位都有值（Redirect URL 是自動的、ID 跟 Secret 是你貼的）。

⚠️

用戶端密鑰跟密碼一樣，不要外流、不要 push 到 GitHub。萬一外流就回 GCP 重新產生。

步驟 4｜按授權，看到 Connected 就成功

目的：所有資料填好後，按授權讓 Google 跳出同意視窗。按同意，n8n 才真正拿到操作權限。

n8n 按 Sign in with Google 後跳出 Google 授權視窗，勾選全選

在 n8n 憑證頁面按 Sign in with Google

選你在「測試使用者」加的那個 Google 帳號

看到「Google 尚未驗證這個應用程式」警告，按進階，再按前往 n8n（不安全）

看到權限範圍清單，測試階段先勾全選，按繼續

視窗關閉，回到 n8n。憑證標題出現綠色 Connected 字樣

按 Save 儲存

✅ 成功標誌：綠色 Connected 字樣出現。

⚠️

「未驗證應用程式」警告是正常的。 因為這是你自己的 App，不會通過 Google 正式審查。個人用按進階繼續就好。

💡

真接通驗收（30 秒）： 別只看到 Connected 就跑掉。馬上做一次小測試：新建一個 workflow → 拖一個 Google Drive 節點 → Credential 欄選你剛建的憑證 → Operation 選 Search → 按 Execute step。看到回傳你 Drive 裡的檔案列表，才算真接通。如果報 insufficient permission，回步驟 4 重做授權，記得勾全選。