---
{
  "id": "platform.sheet.limits-and-permissions",
  "topic": "sheet",
  "title": "Sheet 限制、權限與私有執行",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Sheet calls 有固定的單次、workbook 大小、速率、Agent grant、使用者可見性、scope 與私有 surface 邊界。",
  "content": "單次 `read_range` 最多 10,000 cells、1,000 rows、100 columns；`update_cells` 最多 5,000 cells；`append_rows` 最多 500 rows，且總計不得超過 5,000 cells。大資料要用明確 A1 視窗分讀；寫入依相關上限分批，每批都串接回傳的新 version。\n\n一本 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，應等待視窗，不可立刻重試轟炸。\n\n讀取權是 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 授權，不要改試其他寫法。\n\n完全沒有存取權時，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 永遠為準。\n",
  "aliases": [
    "sheet limits",
    "workbook quota",
    "rate limited",
    "read only",
    "permission denied",
    "resource not found",
    "試算表限制",
    "唯讀授權",
    "權限不足"
  ],
  "tags": [
    "sheet",
    "limits",
    "permissions",
    "safety"
  ],
  "relatedActions": [
    "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"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/sheet/limits-and-permissions/"
}
---

單次 `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 永遠為準。