スプレッドシートエージェントの安全な運用

Spreadsheet agentの破壊範囲はセル値だけでなく、式、書式、結合、hidden sheet、protected range、参照、再計算へ及ぶため、書込みを細粒度に監査・rollback可能にする必要がある。

application / implementation / interoperability / security / audit

Sheets APIが値・書式・sheet単位・batch atomicity/protected rangeをどこまで表現するか。APIの機能存在を、agentの式安全性・意味正確性へ外挿できるか。

• source class: official API overview; exact title: Google Sheets API Overview; author/org: Google for Developers; canonical URL: https://developers.google.com/workspace/sheets/api/guides/concepts publication/update/access: current page accessed 2026-09-13 JST; version/release/tag/commit/API revision/model ID: Sheets API; supporting locator: lines 55-80（read/write cell values、formatting、multiple Sheets、stable spreadsheetId/sheetId、cells/ranges）; evidence label: VERIFIED_SPEC + PRODUCT_VOLATILE; relation: support / limit.
• source class: official API reference/guidance; exact title: Method: spreadsheets.batchUpdate / Update spreadsheets; author/org: Google for Developers; canonical URLs: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate and https://developers.google.com/workspace/sheets/api/guides/batchupdate publication/update/access: reference last updated 2026-07-23 UTC / accessed 2026-09-13 JST; version/release/tag/commit/API revision/model ID: Sheets API v4; supporting locator: batchUpdate page lines 316-321（validation、all-or-nothing failure、atomic application with collaborator caveat）; guide lines 55-68, 81-109, 131-135（formats, protected ranges, cell updates, field masks）; evidence label: VERIFIED_SPEC + PRODUCT_VOLATILE; relation: support / limit.

Sheets APIは値・書式・複数sheet・rangeを操作対象として表現し、v4 batchUpdateはrequest validationと、失敗時に他requestを適用しないこと、updatesを一緒に適用するatomicityを記載する。ただし、同ページはcollaborator changesにより最終状態が完全に要求どおりとは限らないとも明記する。したがって、APIのatomic batchはagentの式意味正確性、hidden/merged/参照破壊、再計算後の業務正解を保証しない。

APIは複数のmutationを扱えるが、各spreadsheetの現行設定、calculation engine、外部data source、named/protected range権限、同時編集、locale/date parsingは別リスク。field mask無し・広すぎるrange・formula/value混同・部分成功と見なすretryがfailure envelope。

OAuth scope、file/share権限、protected range、Workspace管理、API quota、spreadsheetId/sheetId、同時編集者を確認する必要がある。実ファイル書込み・認証済みtenant試験は未実施。

read-only discovery→cell/range diff→formula/value/format separate proposal→human approval→small batchUpdate→readback/rollback候補という段階設計。実装・rollback試験未実施。

synthetic workbookでformula preservation、hidden/merged sheet、format/number/date、named/protected range、cross-sheet reference、recalc result、concurrent editを個別fixture化し、before/after snapshotとsemantic assertionsを比較する。

SECURITY/PRIVACY: real PIIを使わずsynthetic workbook、minimum OAuth scope。AUDIT: spreadsheetId/sheetId/range, pre/post hash, request JSON, actor/approval, revision/readback. COST: API calls、readback、human review。OPERABILITY: mutation budget、protected ranges、dry-run、abort-on-diffを設ける。

「Sheets API v4はセル値・書式・保護範囲などを操作でき、batchUpdateはrequest検証と一括適用を提供する。ただし、同時編集の影響があり、APIのatomicityは式の意味正確性、再計算結果、業務上の正しさを保証しない。」

本文ではAPI機能表とagent safety controlを分け、read/write/format/protected/batch/rollback/readbackを別列にする。Google Sheets以外のExcel/LibreOffice/provider-specific workbookは別採集する。

Google Sheetsのlocale/recalc/外部data sourceごとの再現性、protected rangeとagent委譲の境界、同時編集時のreadback、他spreadsheet providerとの互換性。

batchUpdate成功レスポンスだけで意味的正解・不可逆破壊なしと判定しない。広いrangeの自動書込みや無条件retryを行わない。 UNIT_CLOSE_STATUS: INDIVIDUAL_BOUNDED_CLOSE / EVIDENCE_RECORDED / UNKNOWN_PRESERVED

---