第10章：串接外部服務 - 金鑰、服務帳號與權限

1

為什麼要串接外部服務

你做的小工具，常常需要「借用別人家的服務」。例如想讓工具會聊天、會分析文字，就得借用一個現成的 AI 大腦（本章用的是 Google 的 Gemini）；想把資料存起來、之後還能打開看，就得借用一個現成的雲端表格（Google 試算表）。這種「把自己的工具，接上別人家服務」的動作，就叫做串接外部服務。

但別人家的服務不會讓你白白拿去用。你得先證明你有資格用，就像進健身房要先刷會員卡：門口的人不認識你，但他認得那張卡。串接的第一道功課，就是拿到並用上這張「卡」，讓對方願意放行。這一章會帶你把整套流程親手走一遍。

本章會帶你實際做出兩個能動的小工具，也認識兩種不同的後端：

版本	用哪種後端	你會做出什麼
A 簡單版	Google Apps Script	「AI 偽命理師」：使用者選星座問運勢，AI 回一段話，再把問答存進試算表。純娛樂。
B 進階版	自架伺服器（Vercel）	「英文日記評分」：上傳一份英文日記練習 PDF，AI 依文法、用字、流暢度幾個面向打分數、給改進建議，再存進表格。

兩個做的事很像，差別在「後端用哪一種」。本章會先帶你做出第一個（簡單版的偽命理師），再回頭看懂兩種後端怎麼分，接著做進階版。途中還會把一個真實專案撞過的兩道牆原汁原味搬進進階版，讓你看清楚卡關時怎麼想、怎麼一步步解開。

本章學習目標

① 親手到 Google 申請一把 Gemini API 金鑰，並真的用它叫得動 AI；
② 看懂三種「身分證件」的差別：API 金鑰（你個人的會員卡）、服務帳號（工具自己的機器人帳號）、權限共用（把表格分享給那個機器人）；
③ 自己做出並部署一個 AI 小工具，讓「填表單 → AI 處理 → 自動存進試算表」這條資料循環完整跑起來；
④ 從一個真實專案撞過的兩道牆，學會「卡住時怎麼換個做法」，並看懂常見的錯誤碼在說什麼。

先記住一個重要觀念：金鑰要藏在後端

本章會反覆強調一件事：那把 API 金鑰，絕對不能寫在使用者看得到的網頁裡。任何放進前端網頁的東西，使用者打開瀏覽器就能翻出來，等於把你的會員卡影印給全世界，別人就能拿去用、帳算在你頭上。所以正確做法是把金鑰和「叫 AI」的指令，都藏在使用者看不到的後端（本章用 Google 的 Apps Script 當這個後端）。這個「為什麼指令要藏在後端」的道理，後面會帶你一步步弄懂，現在先有印象就好。

2

三種「身分」：鑰匙、機器員工、複製鑰匙給他

串接時會碰到三個常被搞混的東西。用一間公司來比喻，一次講清楚。

① API 金鑰

一把「通行鑰匙」

一段長長的密碼字串，拿著它就能使用某個服務。像健身房給你的會員卡，刷了就能進去用設備。

本課向 Google AI 申請的 GEMINI_API_KEY 就是這種鑰匙。

② 服務帳號

一個「機器員工」

一個不會喊累、24 小時待命的機器人員工，專門幫你做雜事（例如自動把資料寫進試算表）。它有自己的「員工信箱」（一個長得像 email 的帳號）。

需要它，是因為網站要「自動」存資料，總不能每次都跳出來叫你本人登入。

③ 權限共用

把「某個櫃子的鑰匙」複製給機器員工

機器員工預設什麼都不能碰，你得明確授權。就像你請了員工，但他不會自動有你辦公室的鑰匙，得特地複製一把某個櫃子的鑰匙給他。

本課做法：把那張試算表「共用」給機器員工的信箱，給「編輯者」權限。

把試算表共用給服務帳號信箱、給編輯者權限的畫面 — 權限共用的真實畫面：把試算表共用給機器員工的信箱（drive-uploader@...iam.gserviceaccount.com），權限給「編輯者」。

一句話分清三者

API 金鑰＝你的會員卡；服務帳號＝幫你做事的機器員工；權限共用＝把某個櫃子的鑰匙複製給那位機器員工。

3

動手做 A・簡單版（Apps Script）動手做（Apps Script）：AI 偽命理師

這一節我們要親手做出本章的主角：一頁簡單的表單，使用者選一個星座、再選一個想問的面向（例如愛情、財運、課業），按下「算一卦」，AI 就回你一段輕鬆的運勢解讀。重點不只是好玩：每一次的提問和 AI 的回答，都會自動記成一列，乖乖進到你的 Google 試算表裡。換句話說，你不只是「叫 AI 回話」，你還把這些對話「留了下來」，這就是串接外部服務最實用的一環。

提醒：這是「純娛樂」的小工具，不是真的算命，也不會給你醫療、投資、健康等任何實質建議。請不要在表單裡收真實生日、身分證、電話這類敏感資料，選個星座就很夠用了。

先看看做好之後，它大概長這個樣子：

🔮 AI 偽命理師

純娛樂

♈ 牡羊 ♉ 金牛 ♊ 雙子 ♋ 巨蟹愛情桃花財運課業事業

🔮 幫我算一卦

怎麼做？讓 AI 當你的程式家教

你完全不用自己會寫程式。整個過程在 VS Code 搭配 AI（Gemini、Codex、Claude Code 等都行）一起完成：你用「白話」說要什麼，AI 幫你產出程式碼、還會一步步帶你操作。第一件事，先把下面這段「開場指令」整段貼給 AI，讓它進入「耐心家教」的角色：

你是一位很有耐心的程式家教，專長是用 Google Apps Script 把 AI 和 Google 試算表串成小工具。我完全沒有程式背景，請一步一步帶我做出一個「AI 偽命理師」網頁：使用者選一個星座、一個想問的面向，AI 回一段純娛樂的運勢解讀，每次的提問和回覆都自動存進我的 Google 試算表。請一次只教一步，明確告訴我點哪裡、貼哪一段，等我說「好了」再繼續；遇到要我自己操作的雲端設定（申請 Gemini 金鑰、授權、部署上線）請放慢、用最白話的方式帶。AI 模型請選比較輕量、通常比較不塞車的款，例如 gemini-2.5-flash-lite。我們開始吧。

設定好它的角色後，整個流程大致是下面六步，AI 會帶著你跑；其中要請 AI 產出程式的兩步，把那段「白話需求」貼給它就好：

拿一把 Gemini 鑰匙

先到 Google AI Studio 按「Get API key／取得 API 金鑰」，照著步驟建立一把金鑰，這是免費的。這把金鑰就是我們前面說過「三種身分」裡的第一種：叫API 金鑰。它代表「你有資格呼叫 Gemini」，現在你親手拿到一把，先把它複製起來、等一下會用到。

免費額度夠用嗎？要付費嗎？（兩個練習都這個練習就會用到這把金鑰）

AI Studio 金鑰有免費額度，免綁信用卡，學習和課堂練習綽綽有餘（gemini-2.5-flash 大約每分鐘 10 次、每天上千次）。兩個要注意：① 太快連續呼叫會被限流，等幾秒再試即可；② 免費版 Google 可能用你送進去的內容改進它的產品、甚至有人工審閱，所以別丟真實敏感資料。什麼時候才需要付費（到後台開啟帳單）？要大量、穩定、商用，或在意隱私（付費版不會拿你的資料訓練）。本章兩個練習這個練習用免費就夠。

開一張 Google 試算表，順手打開程式編輯器

到 Google 試算表新開一張空白表，在第一列依序打上欄位標題：時間、暱稱、星座、想問、補充、AI 解讀（一格一個，共六格）。這一列就是之後資料的「表頭」。打好後，從上方選單按「擴充功能 → Apps Script」，就會跳出程式編輯器，我們的後端就住在這裡。

請 AI 幫你做「後端」

後端就是「在背後做事、使用者永遠看不到」的那段程式。把下面這段白話需求貼給 AI，請它幫你寫：

幫我做這個偽命理師的「後端」（在背後做事、使用者看不到的那部分）：收到使用者選的星座和想問的面向後，配上一段「你是一位幽默溫暖的偽命理師、純娛樂、不是真的算命」的指示，交給 Gemini 想出一段運勢解讀，再把使用者的選擇和 AI 的回覆存成我試算表的一列。

AI 寫好後，會帶你把它貼進 Apps Script，並告訴你把第一步拿到的 Gemini 金鑰貼在哪裡，照它說的做就好。

請 AI 幫你做「前端表單」

前端就是使用者看到、會操作的那一頁。把下面這段白話需求貼給 AI，它會幫你做好、也會教你貼到哪裡（在 Apps Script 新增一個網頁檔）：

幫我做這個偽命理師的「表單頁」（使用者看到、會操作的那一頁）：標題「🔮 AI 偽命理師」、底下小字「純娛樂，不是真的算命」；讓使用者選一個星座、選一個想問的面向（今日運勢、愛情、課業事業、財運、人際、健康），可以填暱稱和補充一句話，再按一個「幫我算一卦」的大按鈕；按下去就把使用者的選擇送給剛剛那段後端，再把 AI 回的運勢顯示出來。配色用青綠色，可愛一點。

照 AI 的指示，把它做好的內容貼進那個網頁檔、存檔就好。

部署成 Web App

按右上角的「部署 → 新增部署作業」，類型選「網頁應用程式」；「執行身分」選「我」，「誰可以存取」選「任何人」，然後按部署。第一次部署會跳出要你「授權」的畫面，甚至會警告「Google 尚未驗證這個應用程式」，這是完全正常的（因為這支程式是你自己寫的、還沒送 Google 審查）：按「進階 → 前往（不安全）→ 允許」就好。完成後系統會給你一個網址，把它複製起來。

開那個網址，玩一次看看

把剛剛拿到的網址貼到瀏覽器打開：選一個星座、選一個想問的面向，按「算一卦」，AI 就會回你一段運勢解讀。接著回頭看你的 Google 試算表，會發現多出了一列，裡面正是你的提問加上 AI 的回答。到這裡，從「使用者輸入」到「AI 回應」再到「資料留存」的完整資料循環，就整個跑起來了。

★ 為什麼「命理師指令」和金鑰要藏在後端？

玩的人只看到一台漂亮的命理機：選星座、按按鈕、得到解讀。他看不到、也改不了背後那串「咒語」，也就是你交代給 AI 的那段「人設指示」（叫它扮演偽命理師的那段話），更拿不到你的 Gemini 金鑰，因為這兩樣東西都放在 Apps Script，而 Apps Script 是「後端」，跑在 Google 的伺服器上，不會送到使用者的瀏覽器裡。這裡其實一口氣講清楚了兩件重要的事：第一，前端（使用者看得到的表單）和後端（在伺服器上偷偷執行的程式）的分工，這在第 8 章有完整說明；第二，為什麼金鑰、密碼這類祕密一定要放後端、不能放前端，這在第 14 章會深入談。把祕密藏好，是串接外部服務最基本、也最重要的安全觀念。

4

兩種後端怎麼選：Apps Script vs 自架伺服器

上一節我們做的那位「偽命理師」，背後的後端是用 Google 的 Apps Script。但後端不是只有這一種。另一種選擇，是「自己架一台伺服器」，例如把它放在 Vercel 上面。兩種都能當你網頁背後的後端，幫你叫 AI、存資料、做運算。差別在於：能做到的能力多寡，以及設定起來的麻煩度。這一節先帶你看懂兩者的差異，之後挑題目時心裡才有底。

比較項目	Apps Script	自架伺服器（Vercel）
一句話定位	Google 的自動化小工具，最省事。	需要完整能力與規模時的正規後端。
適合做的事	搬資料、叫 API、把結果寫進 Google 試算表或文件、UI 簡單的小應用。	要用各種程式套件（例如解析 PDF、處理圖片）、複雜運算、完整框架、自訂網域、大流量、接 Google 以外的服務。
要不要服務帳號	不用，以你本人的身分跑。	要用「服務帳號」（一組給程式專用的身分）。
設定麻煩度	低，貼上程式、按發佈就能用。	高一些，但換來更強的能力。
本章用哪個練習	偽命理師（簡單版）。	英文日記評分（進階版）。

一句話判準

挑後端時，先問自己一個問題：「我的後端，要不要用到 Google 以外的程式套件，或處理檔案、圖片？」

不用：選 Apps Script，最省事。
要：選 自架伺服器（Vercel）。先想清楚要做什麼，再決定用哪種後端。

AI 加值：高還是低？

同樣是接 AI，題目挑得好不好，差很多。這裡教你一個選題的眼光，看「AI 加值」是高還是低。

低 AI 值：AI 其實只是代替你打字。也就是純萃取，例如從收據裡抓出金額和日期，傳統程式其實也做得到，AI 只是順手。

高 AI 值：AI 真的幫你動腦。例如把零散的內容整理成一套架構、判斷該給幾分並說出理由、把散落各處的資訊合成一份好用的紀錄。

結論很簡單：題目越偏向後者，越值得用 AI。等一下做進階版的英文日記評分時，你會親手感受到這種「幫你動腦」的高加值。

5

動手做 B・進階版（Vercel）：英文日記寫作評分（上傳 PDF）

這一版要做的，是讓使用者「上傳一份英文日記練習的 PDF」，系統把裡面的文字抽出來，交給 Gemini 依文法、用字、流暢度幾個面向打分數並給改進建議，最後把結果存進你的 Google 試算表。為什麼這次一定要用伺服器，而不能像偽命理師那樣靠 Apps Script？因為這次多了一個關鍵動作：解析使用者上傳的檔案。Apps Script 對「拆開一份 PDF、把文字一個字一個字挖出來」這件事很弱，這正是該換成伺服器的時機。簡單說，要處理檔案、要藏金鑰、要比較久的運算，就交給伺服器。這一段是進階選讀，如果你只想先做出一個能動的成品，做完 Track A 的偽命理師就已經很棒了，這段可以日後有興趣再回來練。

（這段固定，每次都貼）

你是一位很有耐心的程式家教，請記得我完全沒有程式背景。請用下面的方式帶我：
一次只教一步，每一步等我做完、回報結果，你再教下一步。
我最怕「做到最後才發現不能用」。所以請盡量讓我每完成一小段，就能馬上親眼看到它真的會動，有問題早點抓出來，不要全部做完才一起測。
請優先選最穩、最不容易出錯、之後最好維護的做法，不用追求最新最酷的技術。哪裡比較容易踩雷，請先提醒我。
如果這個東西最後要放到網路上，請先放一個最簡單的版本上去、確認真的打得開，之後我們再慢慢加功能。
遇到要我自己到雲端後台操作的設定（申請金鑰、授權、部署等），請放慢、用最白話帶我，告訴我點哪個按鈕、會看到什麼畫面。
一出錯，請把真正的錯誤原因用白話講給我聽，並告訴我接下來具體該做什麼，不要只說「發生錯誤」。
每次改完，請明確告訴我「去哪個網址、按哪個鍵、應該會看到什麼」，讓我自己驗證。

（這段換成你的專案）

我想做的是：使用者上傳一份英文日記 PDF，伺服器把 PDF 文字抽出來，交給 Gemini 依「文法、用字、流暢度」幾個面向打分數並寫一段改進建議，再把結果存成我 Google 試算表的一列，最後部署到 Vercel。所有金鑰都放在後端的環境變數裡，絕對不要寫死在程式碼、也不要出現在前端網頁。請先把專案建好、讓我能在自己電腦上跑起來測試，再教我接下一步。

把上面兩段一起貼給 AI（固定那段＋你的專案那段），它就會幫你把專案建好、在你自己電腦上跑起來。確認跑得動之後，接著做下面幾步，把它接上雲端、正式上線：

申請一個「服務帳號」（你的機器員工）並下載金鑰檔

服務帳號可以想成一位不會睡覺的機器員工，它有自己的一個信箱地址，專門代替你去存取 Google 的服務。請 AI 帶你到 Google Cloud 的後台，一步步點到「建立服務帳號」，建立後下載它的金鑰檔（一個 JSON 檔），這個檔案等於它的識別證，先好好收著，等部署時要用。

把你的試算表「共用」給服務帳號的信箱，給「編輯者」

機器員工有了識別證，還要你開門讓它進來。打開你要存資料的那份 Google 試算表，點右上角「共用」，把上一步那個服務帳號的信箱地址貼進去，權限選「編輯者」。這一步就是前面講過的三種身分裡的「權限共用」：你決定誰能動你的東西、能動到什麼程度。沒做這一步，等一下它會被擋在門外。

啟用會用到的 Google API

Google 把每一項服務都當成一道要先打開的開關，預設是關著的。這次會用到 Google Sheets（試算表）相關的 API，請 AI 帶你到 Google Cloud 後台把它「啟用」。如果忘了開，等一下上傳時系統會直接報錯，下面第二道牆就會遇到，別擔心，到時候照著做即可。

途中會撞的兩道牆（這段是精華）

卡關很正常，真正有用的能力是讀懂錯誤、換個想法。下面這兩道牆，是當初做另一個「規格書評分網站」時真實撞到、並截下畫面的；你現在做的英文日記評分一樣用 Vercel、服務帳號和試算表，會撞到一模一樣的牆，原理完全通用。我們一步步看當下是怎麼想、怎麼解開的。

第一道牆：服務帳號沒有倉庫

跳出的訊息

一開始想得很周到：使用者上傳的原始 PDF，順手「備份一份到 Google 雲端硬碟」。結果一執行就失敗，跳出這段：

Service Accounts do not have storage quota.（服務帳號沒有儲存空間配額。）

真相：服務帳號這位機器員工自己沒有倉庫，它不能用自己的名義新建檔案，這是 Google 的規定，不是你哪裡設錯了。所以解法不是去查設定，而是換個想法：不要叫一個沒有倉庫的人去蓋新倉庫。改成由你本人先建好那份試算表（算成你的倉庫），再請服務帳號幫你「寫一列進去」就成功了。關鍵原理一句話：檔案的擁有者是誰，決定它算在誰的倉庫。新建檔案需要自己有空間，但寫進你已經建好、又共用給它的檔案，只需要編輯權限。

失敗的做法

叫服務帳號自己去「新建」一份檔案或備份到雲端硬碟。它沒有倉庫，做不到，直接報「沒有配額」。

成功的做法

你本人先建好試算表，把它共用給服務帳號（編輯者），再請服務帳號「寫一列進去」。它只是借用你的倉庫，不必自己蓋。

服務帳號沒有儲存空間配額的錯誤訊息 — 上圖：當時跳出的「沒有配額」錯誤。下圖：把試算表共用給服務帳號信箱、給編輯權限的畫面。

把試算表共用給服務帳號信箱並給編輯權限 — 上圖：當時跳出的「沒有配額」錯誤。下圖：把試算表共用給服務帳號信箱、給編輯權限的畫面。

第二道牆：API 還沒被啟用（403）

跳出的訊息

改用試算表後再上傳，又跳出一段：

403 - Google Sheets API has not been used in project ... or it is disabled.

怎麼讀這串字：4 開頭的錯誤碼，代表問題出在你這邊（是你少做了一個設定，不是 Google 壞掉了），這類錯誤碼的速查在第 11 章會教。意思就是：剛剛那道「Google Sheets API」開關還沒打開。最貼心的是，Google 在這段訊息裡直接附了一個網址，點進去按「啟用」，等一兩分鐘讓設定生效，再上傳一次就成功了。

部署到 Vercel：幾個指令把網站推上線

現在把 Google Cloud 後台先收起來，回到你自己電腦的終端機。剛剛那兩道牆先記在心裡：它們要等網站上線、真的上傳 PDF 時才會遇到，遇到照上面做就好。這一步先把網站推上線，照下面四小步走：

① 裝一次 Vercel 的指令工具（裝過就不用再裝）：

npm i -g vercel

② 在專案資料夾打 vercel，它會帶你登入、幫專案取名，接下來它問什麼，一路按 Enter 用預設值就好：

vercel

③ 先別急著發佈，去把兩把金鑰交給 Vercel 保管。金鑰不能寫進程式碼（會被看到），要放在 Vercel 的「環境變數」裡。切到瀏覽器，打開 vercel.com 的後台，點進你剛取名的專案，進 Settings 裡的 Environment Variables，把兩把鑰匙照程式裡用的名字填進去：一把是動手做 A 第①步申請的 Gemini 金鑰，另一把是本節第①步下載的服務帳號金鑰檔（整份 JSON 的內容）。

④ 回到終端機，正式上線：

vercel --prod

跑完它會在最後一行印出一個 xxx.vercel.app 的網址，那就是你的正式網站。之後每次改完程式，再打一次 vercel --prod 就是更新。

上傳一份 PDF 測試，看試算表是否多了一列

先別管以後的更新，現在就趁熱驗收：把剛剛終端機最後一行印出的網址複製起來、貼到瀏覽器打開，上傳一份 PDF，等系統處理完，再回頭打開你的 Google 試算表。如果最底下多了一列，裡面有分數和建議，就代表整條路打通了：上傳，抽文字，AI 評分，寫進試算表，全部串起來了。

換成別的用途（骨架不動，只改給 AI 的指示和欄位）

和 Track A 偽命理師一樣，這個骨架是通用的：上傳東西，交給 AI，存進試算表。要換主題，你不必重做網站，只要改「給 AI 的那段指示」和「試算表要記哪幾欄」就好。但換之前先想一件事：這個任務值不值得用 AI。判斷標準是「AI 的加值高不高」，AI 真正強的是整理、判斷、合成這類動腦的事；如果只是把字原封不動抓出來打字，那是純萃取，加值很低，傳統程式就能做，殺雞用牛刀。

三個高加值、很值得用 AI 的例子：

手寫筆記、上課拍的照片，整理成有架構的重點：AI 要先讀懂潦草的字，再幫你重組成大綱，這是兩層動腦，加值很高。
名片加上你補一句話，整理成日後好搜尋的人脈紀錄：把名片資訊和你當下的脈絡（在哪認識、聊了什麼）合成一筆好檢索的記憶，這是 AI 才做得漂亮的合成。
履歷或學生作業，給結構化摘要或回饋：需要 AI 判斷、評點，和這次的英文日記評分其實是同一路的事。

一個加值低的反例：把收據上的金額和日期抓出來記帳。這是純萃取，固定欄位、沒有判斷空間，傳統程式就能穩穩做完，不必動用 AI。

再補一個小知識：照片可以直接丟給 Gemini。Gemini 是多模態的，能同時「看圖上的字」又「理解內容」，所以拍照那種任務不用你另外去寫一套 OCR（文字辨識）。反過來，如果是打字產生的 PDF，照前面的做法先把文字抽出來再交給 AI 就好。一句話收尾：骨架完全不動，你只是換一段給 AI 的指示和幾個欄位，就能長出一個全新的小工具，這正是 Track A 偽命理師換主題時的同一招。

課堂練習時請別上傳真實的敏感資料，例如病歷、身分證、別人的個資。用講義裡的範例檔，或自己的上課筆記來練就很夠了，先養成「資料會送到外面」的警覺心，比做出成品更重要。

6

把資料真的寫進試算表：一個自動循環

跨過兩道牆後，「把結果存進試算表」這件事就通了。把它拉高一層看，其實是一個很實用的資料循環：資料進來、AI 處理、結果存回。這個循環是許多自動化工具的骨架。

資料進來 → AI 處理 → 結果存回試算表 ⤴

要讓 Google 試算表「自己會動」，最常見的免費工具是 Google Apps ScriptApps Script 是 Google 內建、免費的自動化腳本工具，掛在試算表上，可以讓表格自動接收資料、寄信、串接其他 Google 服務，不必另外架伺服器。，它掛在試算表上、免費，能讓表格自動接收外部送來的資料並寫成一列。

你其實已經做過這件事了

本課的「隨堂測驗成績上傳」用的就是這套：你的瀏覽器把成績送出 → Apps Script 接住 → 寫進「成績」試算表的一列。和本章「英文日記評分結果存回試算表」是同一個原理，差別只在送進去的內容不同。看懂這章，你就懂了那條成績是怎麼跑進表格的。

選修附錄 · 資料庫循環系統完整實作（Form + Sheets + Apps Script + Gemini API）

想親手做一個「資料進來 → AI 自動分類 → 結果存回、還會寄通知信」的完整自動化系統（以請假出勤系統為例，含壓力測試與長期監控），可以參考這份完整實作附錄。屬於進階選修，不影響主線進度。

進入選修附錄

本章重點回顧

你親手做了一個 AI 偽命理師：到 AI Studio 拿 Gemini 金鑰、用 Apps Script 串接 Gemini 與試算表、部署成 Web App，跑通「填表單 → AI 處理 → 自動存表」的完整資料循環。
祕密藏後端：API 金鑰和那串「命理師指令」都放在 Apps Script（後端），使用者看不到也改不了；放前端會被看光、被盜用。
串接＝證明你有資格用別人家的服務。 會碰到三種身分：API 金鑰（會員卡）、服務帳號（機器員工）、權限共用（複製櫃子鑰匙給機器員工）。
第一道牆：服務帳號「沒有配額（倉庫）」，無法自己新建檔案，這是 Google 的規定，不是你設錯。
轉念心法：卡住時換個做法。關鍵原理是「檔案擁有者是誰」，由你本人先建表、再請機器員工幫你寫進去，就成功。
第二道牆：403 是「功能沒啟用」。記得「4 開頭看自己」，並善用訊息裡附的網址。
資料循環：資料進來 → AI 處理 → 存回試算表，和你做過的成績上傳是同一套原理。

課堂活動 · 幫一個情境設計三種身分

想一個「要自動把資料寫進你 Google 試算表」的情境（報名表、課堂簽到、實驗數據回收）。
寫下這個情境裡的三種身分：誰是 API 金鑰、誰是機器員工、要把哪張表的鑰匙複製給它。
再想一次「第一道牆」的教訓：如果機器員工要新建檔案會失敗，你會怎麼改設計？

7

想一想

下面幾題沒有標準作文，重點是讓你把「為什麼這樣選」說清楚。試著用自己的話講一遍，再看參考解答對照。

反思題

偽命理師（用 Apps Script 做的那版）和英文日記評分（用 Vercel 做的那版），明明都只是「把結果存進 Google 試算表」，為什麼只有 Vercel 那版會撞到「服務帳號沒配額」和「403」這兩道牆，Apps Script 版卻不會？
你想做一個工具，把上課拍的白板照片自動整理成筆記。後端你會選 Apps Script 還是 Vercel？為什麼？
同樣是「上傳檔案給 AI」，哪一種比較值得用 AI、哪一種其實傳統程式就能做？
假如你想把「偽命理師」改成「AI 意見回饋箱」，外觀和資料循環都不必動，你其實只要改哪一段？

看參考解答

第一題：同樣存試算表，為什麼只有 Vercel 版撞牆

關鍵在「程式是用誰的身分、走哪條路去碰 Google」。Apps Script 那版（偽命理師）掛在你自己的 Google 帳號底下跑，等於是你本人在操作，用的是 Google 內建、已經接好的存取方式，不需要另外申請服務帳號，也不用你自己去後台把 API 開關打開，路本來就是通的，所以不會卡配額、也不會被擋。Vercel 那版不一樣：程式跑在外面的伺服器上，沒有「你的身分」可借用，只能拿一個服務帳號當機器人去敲 Google 的門，而且要你自己先把對應的 API 打開、設定權限，只要有一處沒做好，就會看到那兩種典型錯誤。一句話：不是存試算表難，而是誰去存、有沒有事先把通道開好的差別。

第二題：白板照片整理成筆記，選哪個後端

先看它要做哪些事：要「處理圖片」、要「讓 AI 看圖讀字」。一旦牽涉到讀檔案、跑比較吃力的處理、或要用額外套件，通常偏向選 Vercel 這種有完整伺服器能力的方案。但這題可以討論：如果流程是「先把照片交給 AI，AI 回你整理好的純文字，你只是要把文字存進試算表」，那 Apps Script 也能勝任。真正的判準不是「照片就一定要 Vercel」，而是我到底要不要在後端自己處理檔案、要不要裝額外套件。能講出這個判準，比選哪一個更重要。

第三題：同樣上傳檔案給 AI，哪種值得用 AI

標準是「這件事 AI 有沒有幫上真正的忙」。值得用 AI 的，是需要理解、判斷、重新組織的任務：把雜亂內容整理成架構、看懂後歸納重點、合成一段通順摘要，這些靠死規則寫不出來，是高加值。不值得特地用 AI 的，是位置固定、照抄就好的任務：第幾欄一定是金額、第幾欄一定是日期，照抓就好，傳統程式又快又穩又便宜。簡單記：需要動腦的交給 AI，純搬運的交給傳統程式。

第四題：想換用途，只要改哪一段

只要改那串藏在後端、給 AI 的角色指令就好。想做「AI 意見回饋箱」，就把指令從「你是一位命理師」改成「你是一位親切的意見整理助手，請把使用者的回饋摘要成三個重點」。網頁外觀、資料循環的三步、串接 Gemini 的方式通通不必動。這和兩道牆的「轉念」是同一種智慧：卡住時不要硬鑽原本的路，而是退一步問「我真正要的是什麼」。

8

隨堂測驗：檢查你的串接判斷力

答對加 20 分，答錯倒扣 10 分。

第 1 / 5 題目前得分：0