Sheet 限制、權限與私有執行

單次 read_range 最多 10,000 cells、1,000 rows、100 columns；update_cells 最多 5,000 cells；append_rows 最多 500 rows，且總計不得超過 5,000 cells。大資料要用明確 A1 視窗分讀；寫入依相關上限分批，每批都串接回傳的新 version。

一本 workbook 最多 50 sheets；每 sheet 最多 50,000 rows、1,000 columns；全簿最多 500,000 non-empty cells，serialized 大小最多 5 MB。超出時 mutation 回 invalid_arguments，不要原樣重試。每 user 在所有 Sheet Actions 間另共用 60 秒滑動視窗 60 calls；rate_limited 會附 retry metadata，應等待視窗，不可立刻重試轟炸。

讀取權是 Agent 對 workbook 的 grant 與觸發使用者可見性之交集；使用者須為 workbook owner、space owner 或 space member。Mutation 另需 Agent write grant，可來自直接授權或 space-document write grant。Agent 只有 read 時，mutation 回 permission_denied: agent has read-only access to this workbook；應請使用者調整該 Agent 的 workbook 授權，不要改試其他寫法。

完全沒有存取權時，runtime 故意回 resource_not_found: workbook not found，不區分不存在與無權；不得推斷或揭露更多。Runtime 分別驗證包含 sheet:create、sheet:read、sheet:write、sheet:delete、sheet:export、sheet:version:read、sheet:version:write 的 scopes，knowledge card 不授予任何 scope。所有 Sheet Actions 都是 allow_in_public: false，不能在 public conversation 執行；registry 權限、confirmation、redaction、quota、audit 與 typed errors 永遠為準。

Related actions

arinova.sheet.create_workbook, arinova.sheet.get_workbook_summary, arinova.sheet.read_range, arinova.sheet.update_cells, arinova.sheet.append_rows, arinova.sheet.list_versions, arinova.sheet.restore_version

Also known as

sheet limits, workbook quota, rate limited, read only, permission denied, resource not found, 試算表限制, 唯讀授權, 權限不足

---

Machine-readable Markdown · Knowledge index