這段你要做到的事
申請一把金鑰,讓 skill 寫進你的 Sheet
學習目標
用 OAuth 授權自己的 Google 帳號,讓 skill 拿到寫入 Sheet 的權限。流程親手走一遍,之後可複製到任何專案。
你會帶走
一個能把關鍵字研究結果自動寫進 Sheet 的 skill。同事開試算表就看得到,不必你口頭轉述。
AGENT SKILL 一日工作坊 · 階梯 7
Drive 檔案、Sheet、行事曆、GSC、GA ── 申請一把金鑰、授權一次,之後全部交給 gog,一句話就動。不必寫程式。
這段你要做到的事
用 OAuth 授權自己的 Google 帳號,讓 skill 拿到寫入 Sheet 的權限。流程親手走一遍,之後可複製到任何專案。
一個能把關鍵字研究結果自動寫進 Sheet 的 skill。同事開試算表就看得到,不必你口頭轉述。
先搞懂一個詞 · CLI
平常你用滑鼠點圖示、按按鈕,那叫圖形介面。命令行不一樣 ── 你打一行指令、按 Enter,它就做事、回你結果。下面這個黑黑的視窗就是命令行。
開 App、點圖示、按按鈕,靠滑鼠一步步操作。
打一行指令、按 Enter,一次把一串動作做完。黑黑的視窗別怕,它就是一個你打字、它回話的地方。
今天的主角工具 · gog
gog 就是一個專門操作 Google 的命令行工具。授權一次,之後 Claude 就用 gog 幫你動 Google,你一行指令都不用記。
先回答一個你一定會問的問題
對,內建連接(俗稱 MCP)點一下就連上,讀信、查行事曆、抓 Drive 檔都很方便。但要它「動手寫」你的雲端,就會撞牆。
別人幫你包好的固定能力,不能挑 API、不能調權限。讀取沒問題,寫 Sheet 儲存格、跑 GSC/GA 常常就做不到。
共用授權,有額度與逾時;放進排程無人值守也常卡。換帳號、加權限,你都動不了。
自己的專案,要哪些 API 自己開、權限定到最小。接到 gog 後,寫 Sheet、查 GSC、批次處理、寫進 skill,無人值守都跑得動。
先懂你等下會點的那個「允許」
授權畫面跳出來,你用自己的 Google 帳號點一次「允許」,把你勾選的權限借給 gog。
授權完,token 就存在你電腦裡。之後不必再點,gog 直接能用,不會每次都跳授權。
用你自己的帳號授權,寫進去的就是你自己的 Sheet、你自己的 Drive。權限只給你勾的那幾項。
講師大螢幕一步一步帶
client_secret.json跟著畫面做 · 建專案
名稱填 gog cli,按「建立」
點左上專案選單,選剛建好的 gog cli
跟著畫面做 · 設定同意畫面
OAuth 總覽 → 藍色「開始」
應用程式名稱填 gog cli、選你的信箱,下一步
跟著畫面做 · 同意畫面 · 關鍵選擇
gmail.com 結尾的個人帳號,一律選「外部」。今天工作坊建議都用個人帳號。
公司網域的帳號才選「內部」,但有些公司 IT 會擋,卡住就改用個人帳號。
跟著畫面做 · 同意畫面 · 兩個最常忘
目標對象 →「+ Add users」填自己的信箱
發布狀態「測試」→ 按「發布應用程式」
跟著畫面做 · 建立金鑰
OAuth 總覽 →「建立 OAuth 用戶端」
類型選「電腦版應用程式」,命名後「建立」
跟著畫面做 · 建立金鑰 · 只有一次機會
這個彈窗一關,密鑰再也叫不回來。馬上點左下「下載 JSON」存好。
下載的 JSON 就是 gog 要用的憑證。放進專案資料夾,別貼進聊天視窗、別 commit 上 GitHub。
.gitignore,確保不會被存上雲端。跟著畫面做 · 啟用 API
跟著畫面做 · 交給 gog 授權
輸入開機密碼,按 Always Allow
(Mac 系統彈窗,不是釣魚)
瀏覽器自動開 Google 頁,確認帳號按「繼續」
跟著畫面做 · 交給 gog 授權 · 完成
勾選要授權給 gog 的範圍,送出
看到「You're connected」,回終端機就能用
非工程背景必卡的點
同意畫面沒把自己加進 Test users,第一次授權就被擋,顯示「你不是測試使用者」。回去補加就好。
跳出「Google 尚未驗證此應用程式」是正常的,因為這是你自己的測試 app。點「進階 → 繼續前往」即可。
金鑰等同你的 Google 密碼。用 gog auth credentials 交給 gog(下一頁),它存進系統 keyring,你不用管檔案放哪。別放桌面、別貼進聊天視窗。
把 gog 設定好
前面認識 gog 了,現在把它設定好就上工:裝起來、用金鑰授權一次、之後交給 Claude。你一行 OAuth 都不用寫。
不用自己敲指令。搜尋 gog cli,找到 GitHub 上的 openclaw/gogcli,把 repo 連結貼給 Claude:
Claude 會看 repo 說明、依你的系統幫你裝。
把剛下載的金鑰交給 gog,跑授權:
瀏覽器跳同意 → 點允許。只做這一次。--services 只授要用的(最小權限)、--timeout 拉長免得沒按完就逾時。
你不用記指令。授權好之後,直接跟 Claude 說:
Claude 在背後跑 gog 指令,你只要看結果。
你對 Claude 說這句話
把前面的成果整合進來
技術端可以多做這步
在前面 OAuth 授權的 Library 步驟,同時啟用 Google Search Console API 與 Google Analytics Data API,Scopes 也一起加進去。
「幫我把這個關鍵字最近 28 天在 GSC 的點擊數、曝光數拉進關鍵字研究表,跟現有資料合併在同一列。」
動手前必懂 · 帳號差異
最單純,今天建議用這個
可能更順,也可能被公司擋
混合班分層
做到「把 A B C 寫進 Sheet」就算達標。懂 OAuth 是怎麼回事就夠,技術細節交給會的人跑。
做完完整的關鍵字研究表寫入,再加開 GSC、GA API,把搜尋成效也拉進同一張表。目標是一張表涵蓋 AI 分析 + 真實數據。
不要硬卡,現場舉手一起弄通。當下真的弄不通,先把「AI 能寫進我的雲端」帶走,課後再補設定。