​

sheets

orc sheets tabs update sht_... TAB_ID --sort-column COL --sort-direction asc|desc は単一列のソート、--filter-column COL --filter-value V は単一列の部分一致フィルターを保存します。COL は列IDまたは一意な列タイトルです。--clear-sort と --clear-filter で解除します。同じ設定の指定と解除は併用できません。未知・削除済みの列は API で400となります。省略した設定は保持され、更新後のシート全体を返します。--updated-at の省略時は現在値を取得し、古い値は409となり再試行しません。Google 接続ではこれらのフラグは unsupported_by_backend です。フィルター値はログや dry-run 診断に出しません。

orc sheets rows list|create|update|delete sht_... TAB_ID [ROW_ID] は社内シート専用です。Google 接続 ID は unsupported_by_backend になります。rows list は保存順の cursor ページングで、--limit は既定100・最大1000、--cursor は前の応答の next_cursor です。応答は data、next_cursor、シートの updated_at を含みます。--as csv、--max-rows、--sample head_and_tail はそのページを CSV 化・間引きします。--readonly と --wrap-untrusted は Google の値取得と同じ共通処理を使います。--page-all は全ページを NDJSON で読み、--as csv とは併用できません。

書き込みは --stdin の JSON から1回の原子的な batch を送ります。create は { "values": { "COLUMN_ID": "text" }, "before_row_id": "ROW_ID" }（挿入位置は省略可）、update は ROW_ID と { "values": { "COLUMN_ID": null } }、delete は ROW_ID または { "row_id": "ROW_ID" } を渡します。どの書き込みコマンドでも { "operations": [{ "op": "create", "values": {} }, { "op": "update", "row_id": "ROW_ID", "values": {} }, { "op": "delete", "row_id": "OTHER_ROW_ID" }] } で混在バッチを送れます。行IDはサーバーが発行します。--preview は保存せず { preview: true, changes: [{ row_id, column_id, before, after }], created, deleted } を返し、created と deleted は行IDの配列です。実書き込みはシート全体を返します。--updated-at を省略するとCLIが現在値を取得します。古い値は409、未知のシート・タブ・行は404です。

キーは列IDまたは一意な列タイトルです。曖昧・未知の列と型不一致はバッチ全体を400で拒否し、row_ref、column_id、reason を返します。number / currency は有限数値、date は有効な YYYY-MM-DD、url は絶対 HTTP(S) URL、email はメール形式、checkbox は真偽値、select は選択肢内の文字列、multi-select は選択肢内の文字列配列、text / image は文字列が必要です。自動変換しません。update は指定セルのみ変更し、null はセルのキーを消します。未知の行を作る upsert は行いません。書き込みは冪等ではありません。結果が不明なときは再送前に読み直してください。

orc sheets columns list/create/update/delete sht_... TAB_ID [COLUMN_ID] は社内シート専用です。Google 接続 ID とスプレッドシート ID を渡すと unsupported_by_backend になります。作成は --title と --type が必須です。型は text、number、currency、date、url、email、image、checkbox、select、multi-select の10種類です。--options A,B は select / multi-select のみ、--currency-code JPY は currency のみで、大文字3文字の ISO 4217 形式です。--description、--color、--pinned true/false、--hidden true/false、0始まりの --position を設定できます。列IDはサーバーが発行し、書き込みは更新後のシート全体を返します。--updated-at を省略するとCLIが現在値を取得します。古い値は409、未知のシート・タブ・列は404です。自動再試行しません。

列の削除は定義と全行の値を消し、参照するソートとフィルターを解除します。型変更は互換値だけを残し、それ以外はセルのキーを削除します。text は値を文字列化し配列をカンマと空白で連結します。number / currency は有限数値と有限数値に変換できる空でない文字列を保持します。checkbox は真偽値、true/false の文字列、1/0 の値と文字列を変換します。date は有効な YYYY-MM-DD、url / image は HTTP(S) URL、email はメール形式の文字列だけを保持します。select は選択肢内の文字列または単一要素配列を保持し、multi-select は文字列を配列にし、選択肢外の要素を取り除きます。選択肢の編集にも同じ規則を適用します。

orc sheets list/create/get/update/delete は Workspace に保存した社内 Space シートを操作します。create --title 名前 は接続 ID なしで作成し、get/update/delete sht_... は社内シートを選びます。update と delete は直前の応答の updated_at を --updated-at に渡します。古い値なら 409 となり変更されません。update は --title、--pinned true/false、--sort-position、--archived true/false に対応します。新規シートには空のタブが一つあります。社内シートには Google 接続は不要です。

orc sheets tabs create sht_... --title 名前 は空のタブを追加します。tabs update sht_... TAB_ID は --title、--index（非表示・削除済みを含む全タブの0始まりの位置）、--hidden true/false、--deleted true/false に対応します。tabs delete sht_... TAB_ID --yes は論理削除し、tabs update ... --deleted false で復元します。非表示のタブを復元して表示するには --hidden false も指定します。表示中かつ未削除のタブを最低1つ残す必要があります。作成時は --before-tab-id TAB_ID または --index で挿入位置を選べます。タブIDはサーバーが発行し、全操作が更新後のシートを返します。--updated-at を省略するとCLIがGETで現在の値を取得します。古い値は409となり、自動再試行しません。--dry-run でも値や挿入位置の解決にGETを使いますが書き込みません。Google専用の固定行・列やグリッドサイズのフラグは社内シートでは unsupported_by_backend エラーになります。

Google の get CONNECTION_ID SPREADSHEET_ID と create CONNECTION_ID --title 名前 は従来通りです。以下の Google コマンドは、接続した Google アカウントのスプレッドシートを操作します。エージェントが座標を推測しなくて済むように、操作を「構造を知る → 必要な値だけ読む → 変更を確認する → 書き込む」の順で使えるよう設計しています。

get はセル本体を読まずに、タブ、ネイティブテーブル（名前・範囲・列名・列型）、名前付き範囲を返します。values get は複数の A1 範囲とテーブル列を 1 回の Google リクエストで読み、テーブルは名前で指定して必要な列だけを返します。values update は preview を指定すると書き込まずに変更されるセルの前後差分を返します。tables create は型付きのネイティブテーブルを作成し、tables rows create はテーブルの内側（フッターより上）に行を追加します。

タブ・行列・範囲の日常操作は名前付きコマンドで行えます。tabs create/update/delete と tabs copies create はタブの追加・名前変更・並べ替え・固定・削除・複製、dimensions create/update/delete は行・列の挿入・サイズ変更・削除、values create/delete は範囲への行の追記とクリアです。行・列の削除は交差するネイティブテーブルの範囲も同じ処理で詰め直し、テーブルが空になる削除は拒否します。位置は 1 始まりで、タブは名前か数値の sheet ID で指定します。

書式・結合・範囲操作も名前付きコマンドで行えます。formats update は書式と数値形式、merges create/delete はセルの結合と解除、ranges copies create はコピー（コピー先を広く取ると元の範囲を繰り返し貼り、数式を下や右へ延ばせます）、ranges moves create は移動、ranges sorts create は並べ替え、replacements create は検索と置換、named-ranges list/create/update/delete は名前付き範囲の管理です。範囲はシート名付きの A1 表記（Sheet1!A1:B2）か、名前付き範囲の名前で指定します。

入力規則・条件付き書式・フィルタ・交互色・グラフ・テーブルも名前付きコマンドで扱えます。validations update/delete はプルダウンやチェックボックスなどの入力規則、conditional-formats list/create/delete は条件付き書式、filters update/delete はフィルタ（既存のフィルタを置き換えるには replace が必要）、bandings list/create/delete は交互色、charts list/create/update/delete はグラフ、tables update/delete はテーブルの変更と削除です。テーブルの削除は範囲内のセルもすべて消えるため、discard_data=true を指定したときだけ実行します。

セルのリンクとメモも扱えます。links list/update はリンクの一覧と設定（1 つのセルに複数のリンクも可）、notes list/update はメモの一覧と設定です。

エージェントが読むための出力も用意しています。get --include-errors true は構造と一緒に #REF! などのエラーセルを返し、values get の as: csv は範囲ごとに 1 つの CSV 文字列を返します。行数が max_rows を超えるときは、sample: head_and_tail で先頭と末尾を残せます。書き込ませたくない場合は共通オプションの --readonly、取得した内容を AI モデルに読ませる場合は --wrap-untrusted を使います。

Drive の権限を使う操作もあります。files list はスプレッドシートの一覧と名前検索、exports get は XLSX・PDF・CSV・TSV・ODS への書き出し（--output で保存。CSV と TSV は最初のタブのみ）、copies create はスプレッドシート全体のコピーです。Drive の権限なしで接続していた場合は、接続し直すよう案内されます。

名前付きコマンドで足りない操作は、Google Sheets API v4 の全メソッドと全 batchUpdate リクエストに直接届く汎用の入口で扱えます。api get は読み取り専用のメソッド、api update は変更するメソッド、batch-requests create は書式・グラフ・フィルタ・保護範囲などの batchUpdate リクエストを実行します。使えるメソッド・リクエスト型・型定義は schemas list と schemas get で確認できます。対象は固定した Discovery の版に載るものだけで、それ以外は送信前に拒否します。

書き込みは冪等ではありません。タイムアウトなどで結果が不明な場合は、再送する前に対象範囲を読み直してください。行の追加は upsert ではありません。

接続 ID を確認します。スプレッドシート ID は URL の /d/ と /edit の間の文字列です。

使用例

型付き列を一覧

型付き列を作成

Body field: color

型: string。任意。

Body field: currencyCode

型: string。任意。

Body field: description

型: string。任意。

Body field: hidden

型: string。任意。

Body field: options; csv

型: string。任意。

Body field: pinned

型: string。任意。

Body field: position

型: number。任意。

(required) Body field: title; max 100 chars

型: string。任意。

(required) Body field: type; enum: text|number|currency|url|domain|date|timestamp|email|image|checkbox|select|multi-select

型: string。任意。

(required) Body field: updated_at

型: string。任意。

Body field: width

型: number。任意。

列の属性・型・順序を更新

Body field: color

型: string。任意。

Body field: currencyCode

型: string。任意。

Body field: description

型: string。任意。

Body field: hidden

型: string。任意。

Body field: options; csv

型: string。任意。

Body field: pinned

型: string。任意。

Body field: position

型: number。任意。

Body field: title; max 100 chars

型: string。任意。

Body field: type; enum: text|number|currency|url|domain|date|timestamp|email|image|checkbox|select|multi-select

型: string。任意。

(required) Body field: updated_at

型: string。任意。

Body field: width

型: number。任意。

列とセル値を削除

value

型: string。任意。

List in-house Space sheets

Rename, pin, order, archive or edit an in-house Space sheet

Body field: archived

型: string。任意。

Body field: pinned

型: string。任意。

Body field: sort_position

型: number。任意。

Body field: tabs; JSON array of objects (use --stdin for large resources)

型: string。任意。

Body field: title; max 100 chars

型: string。任意。

(required) Body field: updated_at

型: string。任意。

Delete an in-house Space sheet

value

型: string。必須。

タブ・テーブル・列型などの構造を取得

Also scan every tab for error cells (#REF!, #N/A, #DIV/0!, #VALUE!, #NAME?, #NUM!, #ERROR!).; enum: true|false

型: string。任意。

スプレッドシートを作成

Body field: locale; max 20 chars

型: string。任意。

Tab titles to create. Defaults to one Google-named tab.; csv

型: string。任意。

Body field: time_zone; max 100 chars

型: string。任意。

(required) Body field: title; max 500 chars

型: string。任意。

複数の範囲とテーブル列の値を取得

rows returns typed 2D values; csv returns one compact CSV string per range for reading.; enum: rows|csv

型: string。任意。

Row cap per range or table. truncated reports when rows were cut.

型: number。任意。

A1 ranges to read. On the CLI, pass several as comma-separated values.; csv

型: string。任意。

unformatted returns exact numbers; formatted returns displayed text; formula returns formulas instead of results.; enum: unformatted|formatted|formula

型: string。任意。

When rows exceed max_rows: head keeps the first rows; head_and_tail keeps the first and last halves.; enum: head|head_and_tail

型: string。任意。

Body field: tables; JSON array of objects (use --stdin for large resources)

型: string。任意。

複数の範囲に値を書き込む（preview で差分確認）

(required) Body field: data; JSON array of objects (use --stdin for large resources)

型: string。任意。

raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered

型: string。任意。

Read the target cells and return the before/after diff without writing.

型: string。任意。

型付きのネイティブテーブルを作成

Top-left cell of the header row.

型: string。任意。

(required) Body field: columns; JSON array of objects (use --stdin for large resources)

型: string。任意。

raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered

型: string。任意。

(required) Body field: name; max 200 chars

型: string。任意。

Rows as arrays in column order, or objects keyed by column name. Missing keys become empty cells; unknown keys are rejected.; csv

型: string。任意。

(required) Existing tab title.; max 100 chars

型: string。任意。

テーブルに行を追加

raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered

型: string。任意。

(required) Rows as arrays in column order, or objects keyed by column name. Missing keys become empty cells; unknown keys are rejected.; csv

型: string。任意。

タブを追加

Body field: columns

型: number。任意。

Zero-based position. Defaults to the end.

型: number。任意。

Body field: rows

型: number。任意。

(required) Body field: title; max 100 chars

型: string。任意。

Body field: before_tab_id; max 256 chars

型: string。任意。

(required) Body field: updated_at

型: string。任意。

タブの名前・位置・表示・固定を変更

Columns to freeze; 0 unfreezes.

型: number。任意。

Rows to freeze; 0 unfreezes.

型: number。任意。

Body field: hidden

型: string。任意。

Destination zero-based position.

型: number。任意。

Body field: title; max 100 chars

型: string。任意。

Body field: deleted

型: string。任意。

Body field: position

型: number。任意。

Body field: sort; (JSON object, e.g. '{"custom_id":"x"}'); (use "null" or "reset" to clear)

型: string。任意。

(required) Body field: updated_at

型: string。任意。

In-house sheet tab: sort-column

型: string。任意。

In-house sheet tab: sort-direction

型: string。任意。

In-house sheet tab: clear-sort

型: boolean。任意。

In-house sheet tab: filter-column

型: string。任意。

In-house sheet tab: filter-value

型: string。任意。

In-house sheet tab: clear-filter

型: boolean。任意。

タブを削除

value

型: string。任意。

タブを複製（別のスプレッドシートへのコピーも可）

Copy into another spreadsheet (Sheets copyTo). Defaults to this spreadsheet.

型: string。任意。

Zero-based position for an in-spreadsheet copy. Defaults to right after the source.

型: number。任意。

Title of the copy. Defaults to the Google "Copy of" name.; max 100 chars

型: string。任意。

行・列を挿入

Body field: after

型: string。任意。

Body field: count

型: number。任意。

(required) Body field: dimension; enum: rows|columns

型: string。任意。

Inherit formatting from the row/column before. Defaults to true with after, false otherwise.

型: string。任意。

(required) 1-based row or column number to insert before (or after with after=true). For columns, 1=A.

型: number。任意。

(required) Tab title or numeric sheet ID.; max 100 chars

型: string。任意。

行・列のサイズ変更・自動調整・非表示

Fit to content.

型: string。任意。

(required) Body field: dimension; enum: rows|columns

型: string。任意。

(required) Body field: end

型: number。任意。

Body field: hidden

型: string。任意。

Row height or column width in pixels.

型: number。任意。

(required) Body field: start

型: number。任意。

(required) Tab title or numeric sheet ID.; max 100 chars

型: string。任意。

行・列を削除（交差するテーブルを詰め直す）

(required) Body field: dimension; enum: rows|columns

型: string。任意。

(required) Last 1-based row/column to delete (inclusive).

型: number。任意。

(required) First 1-based row/column to delete (inclusive).

型: number。任意。

(required) Tab title or numeric sheet ID.; max 100 chars

型: string。任意。

範囲の後ろに行を追記

raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered

型: string。任意。

insert_rows adds new rows; overwrite writes into existing empty rows.; enum: insert_rows|overwrite

型: string。任意。

(required) Range whose table-like data the rows follow, e.g. Log!A:D or a named range.; max 500 chars

型: string。任意。

(required) Body field: values; JSON array of arrays (use --stdin for large resources)

型: string。任意。

範囲の値をクリア

(required) Body field: ranges; csv

型: string。任意。

書式・数値形式を設定

Sheets API CellFormat, e.g. {"textFormat":{"bold":true},"backgroundColorStyle":{...}}. Run orc sheets schemas get CellFormat.; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

Field mask; textFormat.bold and userEnteredFormat.textFormat.bold are both accepted. Defaults to the keys you send.; max 1000 chars

型: string。任意。

Body field: number_format; (JSON object, e.g. '{"custom_id":"x"}')

型: string。任意。

(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars

型: string。任意。

セルを結合

(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars

型: string。任意。

Body field: type; enum: all|columns|rows

型: string。任意。

セルの結合を解除

(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars

型: string。任意。

範囲をコピー（数式を延ばす）

(required) Destination range. A destination larger than the source tiles the source, filling formulas down or across with relative references adjusted.; max 500 chars

型: string。任意。

Body field: paste_type; enum: normal|values|format|formula|no_borders|data_validation|conditional_formatting

型: string。任意。

(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars

型: string。任意。

Body field: transpose

型: string。任意。

範囲を移動

(required) Top-left cell of the destination, e.g. Sheet1!D1.; max 500 chars

型: string。任意。

Body field: paste_type; enum: normal|values|format|formula|no_borders|data_validation|conditional_formatting

型: string。任意。

(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars

型: string。任意。

範囲を並べ替え

(required) Range to sort, without the header row, e.g. Data!A2:F200.; max 500 chars

型: string。任意。

(required) Body field: sort; JSON array of objects (use --stdin for large resources)

型: string。任意。

検索して置換

(required) Body field: find; max 10000 chars

型: string。任意。

Also search inside formulas.

型: string。任意。

Body field: match_case

型: string。任意。

Body field: match_entire_cell

型: string。任意。

Limit to one range.; max 500 chars

型: string。任意。

Body field: regex

型: string。任意。

(required) Body field: replacement; max 10000 chars

型: string。任意。

Limit to one tab (title or sheet ID).; max 100 chars

型: string。任意。

名前付き範囲を一覧

名前付き範囲を作成

(required) Body field: name; max 250 chars

型: string。任意。

(required) A1 range with a sheet name, e.g. Sheet1!A1:B2 or Sheet1!A:C.; max 500 chars

型: string。任意。

名前付き範囲を変更

Body field: name; max 250 chars

型: string。任意。

A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars

型: string。任意。

名前付き範囲を削除

入力規則を設定（プルダウン・チェックボックス・条件）

(required) ONE_OF_LIST makes a dropdown; BOOLEAN a checkbox.; enum: ONE_OF_LIST|ONE_OF_RANGE|BOOLEAN|NUMBER_BETWEEN|NUMBER_NOT_BETWEEN|NUMBER_GREATER|NUMBER_GREATER_THAN_EQ|NUMBER_LESS|NUMBER_LESS_THAN_EQ|NUMBER_EQ|NUMBER_NOT_EQ|TEXT_CONTAINS|TEXT_NOT_CONTAINS|TEXT_EQ|TEXT_IS_EMAIL|TEXT_IS_URL|DATE_EQ|DATE_BEFORE|DATE_AFTER|DATE_ON_OR_BEFORE|DATE_ON_OR_AFTER|DATE_BETWEEN|DATE_NOT_BETWEEN|DATE_IS_VALID|CUSTOM_FORMULA

型: string。任意。

Also apply to filtered rows; needed for table-managed dropdown columns.

型: string。任意。

Body field: input_message; max 1000 chars

型: string。任意。

(required) A1 range with a sheet name (Sheet1!A2:A) or a named range name.; max 500 chars

型: string。任意。