Agent Skill 一日工作坊 · 階梯 7

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

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

23 頁一把金鑰 · 全 Google 打通OAuth 寫回 Sheet

這段你要做到的事

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

01 / 學習目標

把 OAuth 授權親手走一遍

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

02 / 你會帶走

一個能寫進雲端的 skill

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

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

先搞懂一個詞 · CLI

命令行（CLI）：打一行字它就做事

終端機 Terminal

$ gog calendar list 　← 打一行字、按 Enter

　✓ 工作行事曆

　✓ 個人行事曆

$ ▏　← 它回你結果，等下個指令

平常的 GUI

圖形介面。開 App、點圖示、按按鈕，靠滑鼠一步步操作。

CLI 命令行

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

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

今天的主角工具 · gog

gog，你 Google 的遙控器

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

服務	能做的事	今天
Drive	上傳、下載、整理你的雲端硬碟檔案
Sheet	讀寫試算表儲存格	主打
Calendar	查行程、建立會議
GSC	拉關鍵字的點擊、曝光、排名	主打
GA	拉流量與成效數據	主打

所以這章在幹嘛：先拿到一把 Google 金鑰、授權給 gog。今天主打把 SEO 結果寫進 Sheet、拉 GSC／GA，但同一把鑰匙，Drive、行事曆也都這樣動。

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

不是內建就能連 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 → OAuth client ID → 類型選電腦版應用程式（繁中介面叫「電腦版」，別找「桌面」）→ 下載 client_secret.json
5 交給 gog	把金鑰交給 gog，跑一行 gog auth → 瀏覽器點「允許」→ token 存好，之後不必再授權

看不懂沒關係。接下來 9 頁，我用實際畫面一張一張帶你走這五個階段。卡住就對照螢幕上的截圖，照著點就對了。

跟著畫面做 · 建專案

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

① 建立新專案

名稱填 gog cli，按「建立」

② 切換到這個專案

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

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

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

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

① 點「開始」

OAuth 總覽 → 藍色「開始」

② 填名稱與支援信箱

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

進到 OAuth 總覽點「開始」會跳四步精靈。第一步「應用程式資訊」沒什麼陷阱，照填就好。

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

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

同意畫面 → 目標對象

個人 Gmail → 外部

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

公司 Workspace → 內部

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

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

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

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

① 加測試使用者

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

② 發布應用程式

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

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

跟著畫面做 · 建立金鑰

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

① 建立 OAuth 用戶端

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

② 選「電腦版應用程式」

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

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

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

下載 JSON 金鑰，立刻存好

建立完成 → 下載 JSON 彈窗

關掉就看不到了

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

別貼進聊天視窗、別 commit

下載的 JSON 就是 gog 要用的憑證。放進專案資料夾，不要貼進對話、不要上 GitHub。

✓

請 Claude 加進 .gitignore

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

金鑰＝你的 Google 密碼等級。這個 JSON 檔等一下就是交給 gog 的憑證。

跟著畫面做 · 啟用 API

把 gog 會用到的 API 都啟用

今天主打 · 一定要開	用途
Google Sheets API	寫 Sheet
Search Console API	GSC
Analytics Data API	GA
Drive API	要用再開
Calendar API	要用再開
Gmail API	要用再開

① 上方搜尋 API

② 進頁面按「啟用」

每個 API 搜一次、按一次「啟用」。今天主打的 Sheets、GSC、GA 一定要開；其他要用再補。這步跟建金鑰沒先後。

跟著畫面做 · 交給 gog 授權

跑 gog 授權：鑰匙圈＋瀏覽器同意

① Mac 鑰匙圈

輸入開機密碼，按 Always Allow（Mac 系統彈窗，不是釣魚）

② 瀏覽器同意

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

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

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

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

① 勾選授權範圍

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

② 連線成功

看到「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，貼 repo 給 Claude

找到 GitHub 上的 openclaw/gogcli，把連結貼給 Claude，它依你的系統幫你裝。

② 授權一次

把金鑰交給 gog，跑授權

gog auth add 你@gmail --services sheets,drive --timeout=300s

瀏覽器跳同意，點允許，只做這一次。--services 只授要用的、--timeout 拉長免逾時。

③ 之後交給 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 API 與 Google 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

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

技術端

研究表＋ GSC／GA

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

卡在授權

現場舉手，先帶概念走

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

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