AGENT SKILL 一日工作坊 · 階梯 7

一行 gog 指令,讓 AI 動你的整個 Google

Drive 檔案、Sheet、行事曆、GSC、GA ── 申請一把金鑰、授權一次,之後全部交給 gog,一句話就動。不必寫程式。

23 頁 一把金鑰 · 全 Google 打通
今天的里程碑:從「AI 給我文字」升級成「AI 直接動我的 Google」。寫 Sheet、查 GSC、整理 Drive,用的都是你自己的帳號,不必 IT 幫忙。

這段你要做到的事

申請一把金鑰,讓 skill 寫進你的 Sheet

學習目標

用 OAuth 授權自己的 Google 帳號,讓 skill 拿到寫入 Sheet 的權限。流程親手走一遍,之後可複製到任何專案。

你會帶走

一個能把關鍵字研究結果自動寫進 Sheet 的 skill。同事開試算表就看得到,不必你口頭轉述。

里程碑感:今天第一次「AI 直接寫進我的雲端」。skill 產的東西不再只留在對話視窗,而是進了你的工作系統。

先搞懂一個詞 · CLI

命令行(CLI):打一行字它就做事

平常你用滑鼠點圖示、按按鈕,那叫圖形介面。命令行不一樣 ── 你打一行指令、按 Enter,它就做事、回你結果。下面這個黑黑的視窗就是命令行。

終端機 Terminal
$ gog calendar list ← 打一行字、按 Enter
 ✓ 工作行事曆
 ✓ 個人行事曆
$  ← 它回你結果,等你下個指令

👆 平常的 GUI(圖形介面)

開 App、點圖示、按按鈕,靠滑鼠一步步操作。

⌨️ CLI 命令行

打一行指令、按 Enter,一次把一串動作做完。黑黑的視窗別怕,它就是一個你打字、它回話的地方。

為什麼用它?一行指令能精準做完一串動作,比一直點來點去快得多。而且今天你不用自己打 ── Claude 幫你打

今天的主角工具 · gog

gog,你 Google 的遙控器(一個 CLI)

gog 就是一個專門操作 Google 的命令行工具。授權一次,之後 Claude 就用 gog 幫你動 Google,你一行指令都不用記

🎮 同一個 gog,能動你整個 Google

📄Drive 檔案上傳、下載、整理你的雲端硬碟
📊Sheet讀寫試算表儲存格今天主打
📅行事曆查行程、建立會議
🔍GSC拉關鍵字的點擊、曝光、排名今天主打
📈GA拉流量與成效數據今天主打
所以這章在幹嘛:先拿到一把 Google 金鑰、授權給 gog;今天主打把 SEO 結果寫進 Sheet、拉 GSC/GA,但同一把鑰匙,Drive、行事曆也都這樣動

先回答一個你一定會問的問題

codex、Claude Code 不是內建就能連 Google 嗎?

對,內建連接(俗稱 MCP)點一下就連上,讀信、查行事曆、抓 Drive 檔都很方便。但要它「動手寫」你的雲端,就會撞牆

🔌 內建 MCP:方便,但被框住

別人幫你包好的固定能力,不能挑 API、不能調權限。讀取沒問題,寫 Sheet 儲存格、跑 GSC/GA 常常就做不到

🚧 還有這些限制

共用授權,有額度與逾時;放進排程無人值守也常卡。換帳號、加權限,你都動不了。

🔑 自己申請金鑰 + gog:拿回控制

自己的專案,要哪些 API 自己開、權限定到最小。接到 gog 後,寫 Sheet、查 GSC、批次處理、寫進 skill,無人值守都跑得動。

一句話:內建 MCP 像租車,只能開固定路線;自己申請金鑰走 gog,是拿到自己的車鑰匙,要去哪都你決定。今天這段,就是教你拿到那把鑰匙。

先懂你等下會點的那個「允許」

什麼是 OAuth?你按一次「允許」就好

① 你按一次「允許」

授權畫面跳出來,你用自己的 Google 帳號點一次「允許」,把你勾選的權限借給 gog。

② token 幫你記住

授權完,token 就存在你電腦裡。之後不必再點,gog 直接能用,不會每次都跳授權。

③ 動的是你自己的雲端

用你自己的帳號授權,寫進去的就是你自己的 Sheet、你自己的 Drive。權限只給你勾的那幾項。

記住一句話:OAuth 就是「你授權自己的帳號給工具用」。點一次允許、token 記住、之後動的都是你自己的東西。不必 IT、不必另外的帳號。

講師大螢幕一步一步帶

OAuth 同意畫面,五步走完

1
建立專案 console.cloud.google.com → 新增專案(已經建好的人可以跳過)
2
啟用 API APIs & Services → Library → 搜尋並啟用 Google Sheets API。技術端可加:GSC API、GA Data API
3
設定同意畫面 OAuth consent screen → External → 填 app 名稱 → 加 Scopes(Sheets)→ ⚠ Test users 加自己⚠ Publish app 改 In production(免 7 天過期)
4
建立金鑰 Credentials → Create Credentials → OAuth client ID → Application type:Desktop app繁中介面叫「電腦版應用程式」,別找「桌面」)→ 下載 client_secret.json
5
交給 gog 授權 把下載的金鑰交給 gog,跑一行 gog auth → 瀏覽器點「允許」→ token 存好,之後不必再授權
看不懂沒關係 ── 接下來 9 頁,我用實際畫面一張一張帶你走這五個階段。卡住就對照螢幕上的截圖,照著點就對了。

跟著畫面做 · 建專案

先建一個專案,再切換進去

① 建立新專案
Console 建立新專案

名稱填 gog cli,按「建立」

② 切換到這個專案
從專案選單切換到 gog cli

點左上專案選單,選剛建好的 gog cli

一個專案 = 一個獨立的設定空間。等一下的金鑰、API,全都掛在這個專案底下。

跟著畫面做 · 設定同意畫面

設定同意畫面,先填基本資訊

① 點「開始」
OAuth 總覽點開始

OAuth 總覽 → 藍色「開始」

② 填名稱與支援信箱
填應用程式名稱與支援信箱

應用程式名稱填 gog cli、選你的信箱,下一步

跟著畫面做 · 同意畫面 · 關鍵選擇

目標對象,個人帳號選「外部」

目標對象選外部

個人 Gmail → 外部

gmail.com 結尾的個人帳號,一律選「外部」。今天工作坊建議都用個人帳號。

公司 Workspace → 內部

公司網域的帳號才選「內部」,但有些公司 IT 會擋,卡住就改用個人帳號。

選錯會卡:個人帳號誤選「內部」,後面會建不出金鑰。記得 ── 個人選外部。

跟著畫面做 · 同意畫面 · 兩個最常忘

加自己當測試使用者,並發布應用程式

① 加測試使用者
目標對象加測試使用者

目標對象 →「+ Add users」填自己的信箱

② 發布應用程式
發布應用程式

發布狀態「測試」→ 按「發布應用程式」

這兩個最常忘:沒加測試使用者 → 第一次授權直接被擋;不發布 → 授權 7 天後過期,隔週又要重登。

跟著畫面做 · 建立金鑰

建立 OAuth 用戶端,類型選「電腦版應用程式」

① 建立 OAuth 用戶端
建立 OAuth 用戶端入口

OAuth 總覽 →「建立 OAuth 用戶端」

② 選「電腦版應用程式」
應用程式類型選電腦版應用程式

類型選「電腦版應用程式」,命名後「建立」

一定選「電腦版應用程式」(Desktop app),不要選網頁應用程式。繁中介面叫「電腦版」,別找「桌面」。

跟著畫面做 · 建立金鑰 · 只有一次機會

下載 JSON 金鑰,立刻存好

下載 JSON 金鑰彈窗

⚠ 關掉就看不到了

這個彈窗一關,密鑰再也叫不回來。馬上點左下「下載 JSON」存好。

這個檔等下交給 gog

下載的 JSON 就是 gog 要用的憑證。放進專案資料夾,別貼進聊天視窗、別 commit 上 GitHub

金鑰 = 你的 Google 密碼等級。下載後請 Claude 幫你把它加進 .gitignore,確保不會被存上雲端。

跟著畫面做 · 啟用 API

把 gog 會用到的 API 都啟用

要啟用這些 API(搜尋框打名稱 → 進頁面按「啟用」)

★ 今天主打(一定要開)
📊 Google Sheets API 寫 Sheet
🔍 Google Search Console API GSC
📈 Google Analytics Data API GA
其他(要用再開)
📄 Google Drive API Drive 檔案
📅 Google Calendar API 行事曆
✉️ Gmail API Gmail
① 上方搜尋 API
上方搜尋列搜尋 API
② 進頁面按「啟用」
API 頁面按啟用
每個 API 搜一次、按一次「啟用」。今天主打的 Sheets、GSC、GA 一定要開;其他要用再補。(這步跟建金鑰沒先後。)

跟著畫面做 · 交給 gog 授權

跑 gog 授權:鑰匙圈 + 瀏覽器同意

① Mac 鑰匙圈
Mac 鑰匙圈授權彈窗

輸入開機密碼,按 Always Allow
(Mac 系統彈窗,不是釣魚)

② 瀏覽器同意
瀏覽器 Google 同意登入頁

瀏覽器自動開 Google 頁,確認帳號按「繼續」

金鑰交給 gog 後,跑一行授權指令,就會依序跳出這兩關。不用怕,照著按就好。

跟著畫面做 · 交給 gog 授權 · 完成

勾選權限,看到 You're connected 就成功

① 勾選授權範圍
勾選授權範圍

勾選要授權給 gog 的範圍,送出

② 連線成功
gog You're connected 成功頁

看到「You're connected」,回終端機就能用

這整套設定,一次就好。之後就是後面講的:直接叫 Claude「用 gog 幫我…」,它在背後跑,你看結果。

非工程背景必卡的點

做之前,先把這三個記起來

⚠ 雷 1:忘加 Test users

同意畫面沒把自己加進 Test users,第一次授權就被擋,顯示「你不是測試使用者」。回去補加就好。

⚠ 雷 2:「未驗證應用程式」警告

跳出「Google 尚未驗證此應用程式」是正常的,因為這是你自己的測試 app。點「進階 → 繼續前往」即可。

⚠ 雷 3:金鑰交給 gog 保管

金鑰等同你的 Google 密碼。用 gog auth credentials 交給 gog(下一頁),它存進系統 keyring,你不用管檔案放哪。別放桌面、別貼進聊天視窗。

記住這句話:遇到 403 或「授權被擋」,九成是忘了加 Test users,或那支 API 還沒在 Library 啟用。先查這兩個,再問我。

把 gog 設定好

三步,把 gog 設定好

前面認識 gog 了,現在把它設定好就上工:裝起來、用金鑰授權一次、之後交給 Claude。你一行 OAuth 都不用寫。

① 裝起來(交給 AI)

不用自己敲指令。搜尋 gog cli,找到 GitHub 上的 openclaw/gogcli,把 repo 連結貼給 Claude:

gog cli GitHub repo openclaw/gogcli
「幫我裝 gog:
github.com/openclaw/gogcli」

Claude 會看 repo 說明、依你的系統幫你裝。

② 授權一次

把剛下載的金鑰交給 gog,跑授權:

gog auth credentials
 你的金鑰.json
gog auth add 你@gmail
 --services sheets,drive
 --timeout=300s

瀏覽器跳同意 → 點允許。只做這一次。
--services 只授要用的(最小權限)、--timeout 拉長免得沒按完就逾時。

③ 之後交給 Claude

你不用記指令。授權好之後,直接跟 Claude 說:

「用 gog 把這些寫進我的 Sheet」

Claude 在背後跑 gog 指令,你只要看結果。

為什麼用 gog:它包掉所有 OAuth 與 token 的麻煩。授權那一次,之後寫 Sheet 都是一句話的事。

你對 Claude 說這句話

先讓 AI 寫三個字,確認授權成功

# 貼進 Claude Code 的對話框,把 Sheet 網址換成你自己的 我已經用 gog 授權好我的 Google 帳號了。 我有一個自己的 Google Sheet(網址貼上)。 幫我用 gog 把 A、B、C 三個字 寫進這個 Sheet 的第一欄
預期結果:Sheet 第一欄出現 A、B、C。這是今天最重要的里程碑。第一次 AI 寫進了你的雲端。

把前面的成果整合進來

把關鍵字研究結果,直接整理進 Sheet

# 把這段貼給 Claude Code 用 gog 把前面 keyword-cleaner 跟 serp-checker 的結果, 連同搜尋意圖摘要,整理成一張表, 寫進我的 Google Sheet「關鍵字研究」。 每一列是一個關鍵字,欄位有: - 關鍵字 - 意圖分類(資訊型 / 商業型 / 導覽型 / 交易型) - 前三名網址 - 搜尋意圖摘要
預期產出:一張雲端關鍵字研究表,傳連結給同事就馬上看得到。不必口頭轉述,不必手動整理格式。

技術端可以多做這步

把 GSC / GA 數據,也拉進同一張 Sheet

第一步:開 API

在前面 OAuth 授權的 Library 步驟,同時啟用 Google Search Console APIGoogle Analytics Data API,Scopes 也一起加進去。

第二步:告訴 Claude

「幫我把這個關鍵字最近 28 天在 GSC 的點擊數、曝光數拉進關鍵字研究表,跟現有資料合併在同一列。」

最終效果:一張表同時有 AI 分析的意圖分類,也有 GSC 的真實點擊數與排名。研究數據 + 成效數據合一,不必兩處切換。

動手前必懂 · 帳號差異

個人 Gmail 和公司帳號,授權畫面不一樣

個人 Google 帳號(gmail.com)

最單純,今天建議用這個

· 同意畫面選 External
· 要把自己加進 Test users
· 會跳「未驗證應用程式」警告,正常,點繼續就好
· 金鑰你一定建得了,沒有人擋你

公司帳號(Google Workspace)

可能更順,也可能被公司擋

· 可能可選 Internal:免加 Test users、不跳未驗證警告
· 但有些公司 IT 把「建立 OAuth 應用程式」鎖起來
· 卡在建金鑰那步 = 公司政策擋的,不是你做錯
工作坊建議:個人 Google 帳號跑今天的練習,零組織限制、最單純。公司帳號被擋的同學現場舉手,一起看,不用硬解。

混合班分層

每個人的達標線,長得不一樣

行銷端

做到「把 A B C 寫進 Sheet」就算達標。懂 OAuth 是怎麼回事就夠,技術細節交給會的人跑。

技術端

做完完整的關鍵字研究表寫入,再加開 GSC、GA API,把搜尋成效也拉進同一張表。目標是一張表涵蓋 AI 分析 + 真實數據。

卡在授權

不要硬卡,現場舉手一起弄通。當下真的弄不通,先把「AI 能寫進我的雲端」帶走,課後再補設定。

關鍵原則:這段的核心是「AI 可以寫進我的雲端」。設定卡住沒關係,把這個概念帶走,今天就達標了。