← 返回索引

SKILL-011: Google Sheets 讀寫

適用場景

透過 API 讀取/寫入/格式化 Google Sheets。

前置條件

Google Cloud 已啟用 Sheets API
試算表已分享給 agend-bot@storearcadecount.iam.gserviceaccount.com（編輯者）
憑證路徑：/root/.agend/credentials/google-service-account.json

能力

功能	方法
讀取全部	`worksheet.get_all_values()`
寫入單格	`worksheet.update_acell('A1', '值')`
批量寫入	`worksheet.update(range_name, values)`
設定顏色	`worksheet.format('A1:D1', {...})`
新增分頁	`sh.add_worksheet(title, rows, cols)`

限制

無法建立新的試算表（配額限制）
無法上傳檔案到 Google Drive
用戶需先建立 Sheet 並分享

涉及機器人

機器人	角色
gsheet-bot	專門的 Sheet 操作
spec-reader	也具備 Sheet 寫入能力
general	也可直接操作