sheets
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 の間の文字列です。
orc connections list --workspace YOUR_WORKSPACE_ID --provider google-workspace --format json使用例
サブコマンド
get
タブ・テーブル・列型などの構造を取得
orc sheets get <id> [spreadsheet-id] [options]固有のオプション
--include-errors
Also scan every tab for error cells (#REF!, #N/A, #DIV/0!, #VALUE!, #NAME?, #NUM!, #ERROR!).; enum: true|false
型: string。任意。
orc sheets get <id> --include-errors <value>create
スプレッドシートを作成
orc sheets create [id] [options]固有のオプション
--locale
Body field: locale; max 20 chars
型: string。任意。
orc sheets create --locale <value>--sheet-titles
Tab titles to create. Defaults to one Google-named tab.; csv
型: string。任意。
orc sheets create --sheet-titles <value>--time-zone
Body field: time_zone; max 100 chars
型: string。任意。
orc sheets create --time-zone <value>--title
(required) Body field: title; max 500 chars
型: string。任意。
orc sheets create --title <value>values get
複数の範囲とテーブル列の値を取得
orc sheets values get <id> <spreadsheet-id> [options]固有のオプション
--as
rows returns typed 2D values; csv returns one compact CSV string per range for reading.; enum: rows|csv
型: string。任意。
orc sheets values get <id> <spreadsheet-id> --as <value>--max-rows
Row cap per range or table. truncated reports when rows were cut.
型: number。任意。
orc sheets values get <id> <spreadsheet-id> --max-rows <value>--ranges
A1 ranges to read. On the CLI, pass several as comma-separated values.; csv
型: string。任意。
orc sheets values get <id> <spreadsheet-id> --ranges <value>--render
unformatted returns exact numbers; formatted returns displayed text; formula returns formulas instead of results.; enum: unformatted|formatted|formula
型: string。任意。
orc sheets values get <id> <spreadsheet-id> --render <value>--sample
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。任意。
orc sheets values get <id> <spreadsheet-id> --sample <value>--tables
Body field: tables; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets values get <id> <spreadsheet-id> --tables <value>values update
複数の範囲に値を書き込む(preview で差分確認)
orc sheets values update <id> <spreadsheet-id> [options]固有のオプション
--data
(required) Body field: data; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets values update <id> <spreadsheet-id> --data <value>--input
raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered
型: string。任意。
orc sheets values update <id> <spreadsheet-id> --input <value>--preview
Read the target cells and return the before/after diff without writing.
型: string。任意。
orc sheets values update <id> <spreadsheet-id> --preview <value>tables create
型付きのネイティブテーブルを作成
orc sheets tables create <id> <spreadsheet-id> [options]固有のオプション
--anchor
Top-left cell of the header row.
型: string。任意。
orc sheets tables create <id> <spreadsheet-id> --anchor <value>--columns
(required) Body field: columns; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets tables create <id> <spreadsheet-id> --columns <value>--input
raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered
型: string。任意。
orc sheets tables create <id> <spreadsheet-id> --input <value>--name
(required) Body field: name; max 200 chars
型: string。任意。
orc sheets tables create <id> <spreadsheet-id> --name <value>--rows
Rows as arrays in column order, or objects keyed by column name. Missing keys become empty cells; unknown keys are rejected.; csv
型: string。任意。
orc sheets tables create <id> <spreadsheet-id> --rows <value>--sheet
(required) Existing tab title.; max 100 chars
型: string。任意。
orc sheets tables create <id> <spreadsheet-id> --sheet <value>tables rows create
テーブルに行を追加
orc sheets tables rows create <id> <spreadsheet-id> <table-id> [options]固有のオプション
--input
raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered
型: string。任意。
orc sheets tables rows create <id> <spreadsheet-id> <table-id> --input <value>--rows
(required) Rows as arrays in column order, or objects keyed by column name. Missing keys become empty cells; unknown keys are rejected.; csv
型: string。任意。
orc sheets tables rows create <id> <spreadsheet-id> <table-id> --rows <value>tabs create
タブを追加
orc sheets tabs create <id> [spreadsheet-id] [options]固有のオプション
--columns
Body field: columns
型: number。任意。
orc sheets tabs create <id> --columns <value>--index
Zero-based position. Defaults to the end.
型: number。任意。
orc sheets tabs create <id> --index <value>--rows
Body field: rows
型: number。任意。
orc sheets tabs create <id> --rows <value>--title
(required) Body field: title; max 100 chars
型: string。任意。
orc sheets tabs create <id> --title <value>tabs update
タブの名前・位置・表示・固定を変更
orc sheets tabs update <id> [spreadsheet-id] [tab] [options]固有のオプション
--frozen-columns
Columns to freeze; 0 unfreezes.
型: number。任意。
orc sheets tabs update <id> --frozen-columns <value>--frozen-rows
Rows to freeze; 0 unfreezes.
型: number。任意。
orc sheets tabs update <id> --frozen-rows <value>Body field: hidden
型: string。任意。
orc sheets tabs update <id> --hidden <value>--index
Destination zero-based position.
型: number。任意。
orc sheets tabs update <id> --index <value>--title
Body field: title; max 100 chars
型: string。任意。
orc sheets tabs update <id> --title <value>tabs delete
タブを削除
orc sheets tabs delete <id> [spreadsheet-id] [tab] [options]tabs copies create
タブを複製(別のスプレッドシートへのコピーも可)
orc sheets tabs copies create <id> <spreadsheet-id> <tab> [options]固有のオプション
--destination-spreadsheet-id
Copy into another spreadsheet (Sheets copyTo). Defaults to this spreadsheet.
型: string。任意。
orc sheets tabs copies create <id> <spreadsheet-id> <tab> --destination-spreadsheet-id <value>--index
Zero-based position for an in-spreadsheet copy. Defaults to right after the source.
型: number。任意。
orc sheets tabs copies create <id> <spreadsheet-id> <tab> --index <value>--title
Title of the copy. Defaults to the Google "Copy of" name.; max 100 chars
型: string。任意。
orc sheets tabs copies create <id> <spreadsheet-id> <tab> --title <value>dimensions create
行・列を挿入
orc sheets dimensions create <id> <spreadsheet-id> [options]固有のオプション
--after
Body field: after
型: string。任意。
orc sheets dimensions create <id> <spreadsheet-id> --after <value>--count
Body field: count
型: number。任意。
orc sheets dimensions create <id> <spreadsheet-id> --count <value>--dimension
(required) Body field: dimension; enum: rows|columns
型: string。任意。
orc sheets dimensions create <id> <spreadsheet-id> --dimension <value>--inherit-from-before
Inherit formatting from the row/column before. Defaults to true with after, false otherwise.
型: string。任意。
orc sheets dimensions create <id> <spreadsheet-id> --inherit-from-before <value>--start
(required) 1-based row or column number to insert before (or after with after=true). For columns, 1=A.
型: number。任意。
orc sheets dimensions create <id> <spreadsheet-id> --start <value>--tab
(required) Tab title or numeric sheet ID.; max 100 chars
型: string。任意。
orc sheets dimensions create <id> <spreadsheet-id> --tab <value>dimensions update
行・列のサイズ変更・自動調整・非表示
orc sheets dimensions update <id> <spreadsheet-id> [options]固有のオプション
--auto-resize
Fit to content.
型: string。任意。
orc sheets dimensions update <id> <spreadsheet-id> --auto-resize <value>--dimension
(required) Body field: dimension; enum: rows|columns
型: string。任意。
orc sheets dimensions update <id> <spreadsheet-id> --dimension <value>--end
(required) Body field: end
型: number。任意。
orc sheets dimensions update <id> <spreadsheet-id> --end <value>Body field: hidden
型: string。任意。
orc sheets dimensions update <id> <spreadsheet-id> --hidden <value>--size
Row height or column width in pixels.
型: number。任意。
orc sheets dimensions update <id> <spreadsheet-id> --size <value>--start
(required) Body field: start
型: number。任意。
orc sheets dimensions update <id> <spreadsheet-id> --start <value>--tab
(required) Tab title or numeric sheet ID.; max 100 chars
型: string。任意。
orc sheets dimensions update <id> <spreadsheet-id> --tab <value>dimensions delete
行・列を削除(交差するテーブルを詰め直す)
orc sheets dimensions delete <id> <spreadsheet-id> [options]固有のオプション
--dimension
(required) Body field: dimension; enum: rows|columns
型: string。任意。
orc sheets dimensions delete <id> <spreadsheet-id> --dimension <value>--end
(required) Last 1-based row/column to delete (inclusive).
型: number。任意。
orc sheets dimensions delete <id> <spreadsheet-id> --end <value>--start
(required) First 1-based row/column to delete (inclusive).
型: number。任意。
orc sheets dimensions delete <id> <spreadsheet-id> --start <value>--tab
(required) Tab title or numeric sheet ID.; max 100 chars
型: string。任意。
orc sheets dimensions delete <id> <spreadsheet-id> --tab <value>values create
範囲の後ろに行を追記
orc sheets values create <id> <spreadsheet-id> [options]固有のオプション
--input
raw stores values as given. user_entered parses values like the Sheets UI, including formulas starting with "=".; enum: raw|user_entered
型: string。任意。
orc sheets values create <id> <spreadsheet-id> --input <value>--insert
insert_rows adds new rows; overwrite writes into existing empty rows.; enum: insert_rows|overwrite
型: string。任意。
orc sheets values create <id> <spreadsheet-id> --insert <value>--range
(required) Range whose table-like data the rows follow, e.g. Log!A:D or a named range.; max 500 chars
型: string。任意。
orc sheets values create <id> <spreadsheet-id> --range <value>--values
(required) Body field: values; JSON array of arrays (use --stdin for large resources)
型: string。任意。
orc sheets values create <id> <spreadsheet-id> --values <value>values delete
範囲の値をクリア
orc sheets values delete <id> <spreadsheet-id> [options]固有のオプション
--ranges
(required) Body field: ranges; csv
型: string。任意。
orc sheets values delete <id> <spreadsheet-id> --ranges <value>formats update
書式・数値形式を設定
orc sheets formats update <id> <spreadsheet-id> [options]固有のオプション
--cell-format
Sheets API CellFormat, e.g. {"textFormat":{"bold":true},"backgroundColorStyle":{...}}. Run orc sheets schemas get CellFormat.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets formats update <id> <spreadsheet-id> --cell-format <value>--field-mask
Field mask; textFormat.bold and userEnteredFormat.textFormat.bold are both accepted. Defaults to the keys you send.; max 1000 chars
型: string。任意。
orc sheets formats update <id> <spreadsheet-id> --field-mask <value>--number-format
Body field: number_format; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets formats update <id> <spreadsheet-id> --number-format <value>--range
(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars
型: string。任意。
orc sheets formats update <id> <spreadsheet-id> --range <value>merges create
セルを結合
orc sheets merges create <id> <spreadsheet-id> [options]固有のオプション
--range
(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars
型: string。任意。
orc sheets merges create <id> <spreadsheet-id> --range <value>--type
Body field: type; enum: all|columns|rows
型: string。任意。
orc sheets merges create <id> <spreadsheet-id> --type <value>merges delete
セルの結合を解除
orc sheets merges delete <id> <spreadsheet-id> [options]固有のオプション
--range
(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars
型: string。任意。
orc sheets merges delete <id> <spreadsheet-id> --range <value>ranges copies create
範囲をコピー(数式を延ばす)
orc sheets ranges copies create <id> <spreadsheet-id> [options]固有のオプション
--destination
(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。任意。
orc sheets ranges copies create <id> <spreadsheet-id> --destination <value>--paste-type
Body field: paste_type; enum: normal|values|format|formula|no_borders|data_validation|conditional_formatting
型: string。任意。
orc sheets ranges copies create <id> <spreadsheet-id> --paste-type <value>--source
(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars
型: string。任意。
orc sheets ranges copies create <id> <spreadsheet-id> --source <value>--transpose
Body field: transpose
型: string。任意。
orc sheets ranges copies create <id> <spreadsheet-id> --transpose <value>ranges moves create
範囲を移動
orc sheets ranges moves create <id> <spreadsheet-id> [options]固有のオプション
--destination
(required) Top-left cell of the destination, e.g. Sheet1!D1.; max 500 chars
型: string。任意。
orc sheets ranges moves create <id> <spreadsheet-id> --destination <value>--paste-type
Body field: paste_type; enum: normal|values|format|formula|no_borders|data_validation|conditional_formatting
型: string。任意。
orc sheets ranges moves create <id> <spreadsheet-id> --paste-type <value>--source
(required) A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars
型: string。任意。
orc sheets ranges moves create <id> <spreadsheet-id> --source <value>ranges sorts create
範囲を並べ替え
orc sheets ranges sorts create <id> <spreadsheet-id> [options]固有のオプション
--range
(required) Range to sort, without the header row, e.g. Data!A2:F200.; max 500 chars
型: string。任意。
orc sheets ranges sorts create <id> <spreadsheet-id> --range <value>--sort
(required) Body field: sort; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets ranges sorts create <id> <spreadsheet-id> --sort <value>replacements create
検索して置換
orc sheets replacements create <id> <spreadsheet-id> [options]固有のオプション
--find
(required) Body field: find; max 10000 chars
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --find <value>--include-formulas
Also search inside formulas.
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --include-formulas <value>--match-case
Body field: match_case
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --match-case <value>--match-entire-cell
Body field: match_entire_cell
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --match-entire-cell <value>--range
Limit to one range.; max 500 chars
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --range <value>--regex
Body field: regex
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --regex <value>--replacement
(required) Body field: replacement; max 10000 chars
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --replacement <value>--tab
Limit to one tab (title or sheet ID).; max 100 chars
型: string。任意。
orc sheets replacements create <id> <spreadsheet-id> --tab <value>named-ranges list
名前付き範囲を一覧
orc sheets named-ranges list <id> <spreadsheet-id> [options]named-ranges create
名前付き範囲を作成
orc sheets named-ranges create <id> <spreadsheet-id> [options]固有のオプション
--name
(required) Body field: name; max 250 chars
型: string。任意。
orc sheets named-ranges create <id> <spreadsheet-id> --name <value>--range
(required) A1 range with a sheet name, e.g. Sheet1!A1:B2 or Sheet1!A:C.; max 500 chars
型: string。任意。
orc sheets named-ranges create <id> <spreadsheet-id> --range <value>named-ranges update
名前付き範囲を変更
orc sheets named-ranges update <id> <spreadsheet-id> <named-range> [options]固有のオプション
--name
Body field: name; max 250 chars
型: string。任意。
orc sheets named-ranges update <id> <spreadsheet-id> <named-range> --name <value>--range
A1 range with a sheet name (Sheet1!A1:B2) or a named range name.; max 500 chars
型: string。任意。
orc sheets named-ranges update <id> <spreadsheet-id> <named-range> --range <value>named-ranges delete
名前付き範囲を削除
orc sheets named-ranges delete <id> <spreadsheet-id> <named-range> [options]validations update
入力規則を設定(プルダウン・チェックボックス・条件)
orc sheets validations update <id> <spreadsheet-id> [options]固有のオプション
--condition-type
(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。任意。
orc sheets validations update <id> <spreadsheet-id> --condition-type <value>--filtered-rows-included
Also apply to filtered rows; needed for table-managed dropdown columns.
型: string。任意。
orc sheets validations update <id> <spreadsheet-id> --filtered-rows-included <value>--input-message
Body field: input_message; max 1000 chars
型: string。任意。
orc sheets validations update <id> <spreadsheet-id> --input-message <value>--range
(required) A1 range with a sheet name (Sheet1!A2:A) or a named range name.; max 500 chars
型: string。任意。
orc sheets validations update <id> <spreadsheet-id> --range <value>--show-custom-ui
Show the dropdown or checkbox UI where supported.
型: string。任意。
orc sheets validations update <id> <spreadsheet-id> --show-custom-ui <value>--strict
Reject invalid input instead of showing a warning.
型: string。任意。
orc sheets validations update <id> <spreadsheet-id> --strict <value>--values
Condition values: the list items, the bounds, or one value. ONE_OF_RANGE takes a range; CUSTOM_FORMULA a formula starting with =.; csv
型: string。任意。
orc sheets validations update <id> <spreadsheet-id> --values <value>validations delete
入力規則を解除
orc sheets validations delete <id> <spreadsheet-id> [options]固有のオプション
--filtered-rows-included
Body field: filtered_rows_included
型: string。任意。
orc sheets validations delete <id> <spreadsheet-id> --filtered-rows-included <value>--range
(required) A1 range with a sheet name (Sheet1!A2:A) or a named range name.; max 500 chars
型: string。任意。
orc sheets validations delete <id> <spreadsheet-id> --range <value>conditional-formats list
条件付き書式を一覧
orc sheets conditional-formats list <id> <spreadsheet-id> [options]固有のオプション
--tab
Only this tab (title or sheet ID).; max 100 chars
型: string。任意。
orc sheets conditional-formats list <id> <spreadsheet-id> --tab <value>conditional-formats create
条件付き書式を追加
orc sheets conditional-formats create <id> <spreadsheet-id> [options]固有のオプション
--cell-format
CellFormat applied when the rule matches, e.g. {"backgroundColorStyle":{"rgbColor":{"red":1}}}.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets conditional-formats create <id> <spreadsheet-id> --cell-format <value>--expression
Comparison value, or a formula starting with = for custom_formula.; max 10000 chars
型: string。任意。
orc sheets conditional-formats create <id> <spreadsheet-id> --expression <value>--gradient-rule
Sheets GradientRule for a color scale instead of type/expression.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets conditional-formats create <id> <spreadsheet-id> --gradient-rule <value>--index
Priority position; 0 is evaluated first.
型: number。任意。
orc sheets conditional-formats create <id> <spreadsheet-id> --index <value>--range
(required) A1 range with a sheet name (Sheet1!A2:A) or a named range name.; max 500 chars
型: string。任意。
orc sheets conditional-formats create <id> <spreadsheet-id> --range <value>--type
Body field: type; enum: text_eq|text_contains|text_starts_with|text_ends_with|number_eq|number_gt|number_gte|number_lt|number_lte|blank|not_blank|custom_formula
型: string。任意。
orc sheets conditional-formats create <id> <spreadsheet-id> --type <value>conditional-formats delete
条件付き書式を削除
orc sheets conditional-formats delete <id> <spreadsheet-id> [options]固有のオプション
--all
Body field: all
型: string。任意。
orc sheets conditional-formats delete <id> <spreadsheet-id> --all <value>--index
Body field: index
型: number。任意。
orc sheets conditional-formats delete <id> <spreadsheet-id> --index <value>--tab
(required) Tab title or numeric sheet ID.; max 100 chars
型: string。任意。
orc sheets conditional-formats delete <id> <spreadsheet-id> --tab <value>filters update
フィルタを設定
orc sheets filters update <id> <spreadsheet-id> [options]固有のオプション
--criteria
Sheets FilterSpec objects, e.g. [{"columnIndex":2,"filterCriteria":{"condition":{"type":"NUMBER_GREATER","values":[{"userEnteredValue":"100"}]}}}].; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets filters update <id> <spreadsheet-id> --criteria <value>--range
(required) A1 range with a sheet name (Sheet1!A2:A) or a named range name.; max 500 chars
型: string。任意。
orc sheets filters update <id> <spreadsheet-id> --range <value>--replace
Replace an existing filter on the tab.
型: string。任意。
orc sheets filters update <id> <spreadsheet-id> --replace <value>filters delete
フィルタを解除
orc sheets filters delete <id> <spreadsheet-id> [options]固有のオプション
--tab
(required) Tab title or numeric sheet ID.; max 100 chars
型: string。任意。
orc sheets filters delete <id> <spreadsheet-id> --tab <value>bandings list
交互色を一覧
orc sheets bandings list <id> <spreadsheet-id> [options]固有のオプション
--tab
Only this tab (title or sheet ID).; max 100 chars
型: string。任意。
orc sheets bandings list <id> <spreadsheet-id> --tab <value>bandings create
交互色を追加
orc sheets bandings create <id> <spreadsheet-id> [options]固有のオプション
--column-properties
Body field: column_properties; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets bandings create <id> <spreadsheet-id> --column-properties <value>--range
(required) A1 range with a sheet name (Sheet1!A2:A) or a named range name.; max 500 chars
型: string。任意。
orc sheets bandings create <id> <spreadsheet-id> --range <value>--row-properties
Sheets BandingProperties for row colors. Defaults to light blue header and alternating rows.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets bandings create <id> <spreadsheet-id> --row-properties <value>bandings delete
交互色を削除
orc sheets bandings delete <id> <spreadsheet-id> [options]固有のオプション
--banded-range-id
Body field: banded_range_id
型: number。任意。
orc sheets bandings delete <id> <spreadsheet-id> --banded-range-id <value>--tab
Remove all banding on this tab.; max 100 chars
型: string。任意。
orc sheets bandings delete <id> <spreadsheet-id> --tab <value>charts list
グラフを一覧
orc sheets charts list <id> <spreadsheet-id> [options]charts create
グラフを作成
orc sheets charts create <id> <spreadsheet-id> [options]固有のオプション
--anchor
Top-left cell, e.g. E2.
型: string。任意。
orc sheets charts create <id> <spreadsheet-id> --anchor <value>--height
Body field: height
型: number。任意。
orc sheets charts create <id> <spreadsheet-id> --height <value>--spec
(required) Sheets ChartSpec, or an EmbeddedChart with spec and position. Run orc sheets schemas get ChartSpec.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets charts create <id> <spreadsheet-id> --spec <value>--tab
Tab to place the chart on. Without tab and anchor, the spec position (or a new tab) is used.; max 100 chars
型: string。任意。
orc sheets charts create <id> <spreadsheet-id> --tab <value>--width
Body field: width
型: number。任意。
orc sheets charts create <id> <spreadsheet-id> --width <value>charts update
グラフを変更
orc sheets charts update <id> <spreadsheet-id> <chart-id> [options]固有のオプション
--spec
(required) Replacement ChartSpec (or an EmbeddedChart wrapping one).; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets charts update <id> <spreadsheet-id> <chart-id> --spec <value>charts delete
グラフを削除
orc sheets charts delete <id> <spreadsheet-id> <chart-id> [options]tables update
テーブルの名前・範囲を変更
orc sheets tables update <id> <spreadsheet-id> <table-id> [options]固有のオプション
--name
Body field: name; max 200 chars
型: string。任意。
orc sheets tables update <id> <spreadsheet-id> <table-id> --name <value>--range
New A1 range including the header row.; max 500 chars
型: string。任意。
orc sheets tables update <id> <spreadsheet-id> <table-id> --range <value>tables delete
テーブルを削除(範囲のセルも削除)
orc sheets tables delete <id> <spreadsheet-id> <table-id> [options]固有のオプション
--discard-data
Must be true: deleting a table also deletes every cell in its range.; enum: true|false
型: string。任意。
orc sheets tables delete <id> <spreadsheet-id> <table-id> --discard-data <value>links list
リンクを一覧
orc sheets links list <id> <spreadsheet-id> [options]固有のオプション
--range
A1 range with a sheet name (Sheet1!A1:D20) or a named range name.; max 500 chars
型: string。必須。
orc sheets links list <id> <spreadsheet-id> --range <value>links update
リンクを設定(複数リンクも可)
orc sheets links update <id> <spreadsheet-id> [options]固有のオプション
--cells
(required) Body field: cells; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets links update <id> <spreadsheet-id> --cells <value>notes list
メモを一覧
orc sheets notes list <id> <spreadsheet-id> [options]固有のオプション
--range
A1 range with a sheet name (Sheet1!A1:D20) or a named range name.; max 500 chars
型: string。必須。
orc sheets notes list <id> <spreadsheet-id> --range <value>notes update
メモを設定・削除
orc sheets notes update <id> <spreadsheet-id> [options]固有のオプション
--note
(required) Note text; an empty string clears notes.; max 50000 chars
型: string。任意。
orc sheets notes update <id> <spreadsheet-id> --note <value>--range
(required) Cell or range with a sheet name, or a named range name.; max 500 chars
型: string。任意。
orc sheets notes update <id> <spreadsheet-id> --range <value>files list
スプレッドシートを一覧・名前検索
orc sheets files list <id> [options]固有のオプション
--query
Only spreadsheets whose name contains this text.; max 200 chars
型: string。任意。
orc sheets files list <id> --query <value>exports get
XLSX・PDF・CSV などに書き出し
orc sheets exports get <export-id> [options]copies create
スプレッドシート全体をコピー
orc sheets copies create <id> <spreadsheet-id> [options]固有のオプション
--name
Name of the copy. Defaults to "Copy of …".; max 500 chars
型: string。任意。
orc sheets copies create <id> <spreadsheet-id> --name <value>--parent-folder-id
Drive folder for the copy. Defaults to the source folder.
型: string。任意。
orc sheets copies create <id> <spreadsheet-id> --parent-folder-id <value>api get
読み取り専用の Sheets API メソッドを呼ぶ
orc sheets api get <id> [options]固有のオプション
--body
Request body for methods that take one, in the Discovery request schema.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets api get <id> --body <value>--method
(required) Read-only Discovery method id, for example spreadsheets.values.batchGet.; enum: spreadsheets.developerMetadata.get|spreadsheets.developerMetadata.search|spreadsheets.get|spreadsheets.getByDataFilter|spreadsheets.values.batchGet|spreadsheets.values.batchGetByDataFilter|spreadsheets.values.get
型: string。任意。
orc sheets api get <id> --method <value>--params
Path and query parameters by Discovery name, for example {"spreadsheetId":"…","ranges":["A1:B2"]}. Run orc sheets schemas get <method> for the list.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets api get <id> --params <value>api update
変更する Sheets API メソッドを呼ぶ
orc sheets api update <id> [options]固有のオプション
--body
Request body for methods that take one, in the Discovery request schema.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets api update <id> --body <value>--method
(required) Mutating Discovery method id, for example spreadsheets.values.append.; enum: spreadsheets.batchUpdate|spreadsheets.create|spreadsheets.sheets.copyTo|spreadsheets.values.append|spreadsheets.values.batchClear|spreadsheets.values.batchClearByDataFilter|spreadsheets.values.batchUpdate|spreadsheets.values.batchUpdateByDataFilter|spreadsheets.values.clear|spreadsheets.values.update
型: string。任意。
orc sheets api update <id> --method <value>--params
Path and query parameters by Discovery name, for example {"spreadsheetId":"…","ranges":["A1:B2"]}. Run orc sheets schemas get <method> for the list.; (JSON object, e.g. '{"custom_id":"x"}')
型: string。任意。
orc sheets api update <id> --params <value>batch-requests create
batchUpdate リクエストをまとめて適用
orc sheets batch-requests create <id> <spreadsheet-id> [options]固有のオプション
--include-spreadsheet-in-response
Body field: include_spreadsheet_in_response
型: string。任意。
orc sheets batch-requests create <id> <spreadsheet-id> --include-spreadsheet-in-response <value>--requests
(required) batchUpdate requests, each an object with exactly one request type key such as {"addChart":{…}}. Run orc sheets schemas list for the types.; JSON array of objects (use --stdin for large resources)
型: string。任意。
orc sheets batch-requests create <id> <spreadsheet-id> --requests <value>--response-include-grid-data
Body field: response_include_grid_data
型: string。任意。
orc sheets batch-requests create <id> <spreadsheet-id> --response-include-grid-data <value>--response-ranges
Body field: response_ranges; csv
型: string。任意。
orc sheets batch-requests create <id> <spreadsheet-id> --response-ranges <value>schemas list
使えるメソッドとリクエスト型を一覧
orc sheets schemas list [options]schemas get
メソッド・リクエスト型・型定義を取得
orc sheets schemas get <name> [options]使用例
構造を確認する
orc sheets get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --format json構造を確認する
範囲とテーブル列を読む
以下の JSON を read.json に保存します。render は unformatted(正確な数値)、formatted(表示値)、formula(数式)から選べます。
orc sheets values get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < read.json範囲とテーブル列を読む
{
"ranges": ["Metrics!A1:A3"],
"tables": [{ "table": "Weekly", "columns": ["week", "sessions"] }],
"render": "unformatted",
"max_rows": 500
}変更差分を確認してから書き込む
write.json の preview を true にして差分を確認し、問題がなければ false にして実行します。null はセルを変更せず、空文字はセルを空にします。数式を書く場合は input を user_entered にします。
orc sheets values update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < write.json変更差分を確認してから書き込む
{
"data": [{ "range": "Metrics!C3:C4", "values": [[1200], ["=SUM(C2:C3)"]] }],
"input": "user_entered",
"preview": true
}型付きテーブルを作成する
ヘッダー・行・テーブル化を 1 回の原子的なバッチで実行します。日付は ISO 形式(YYYY-MM-DD)で渡せます。型に合わない値は送信前に拒否します。
orc sheets tables create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < table.json型付きテーブルを作成する
{
"name": "Weekly",
"sheet": "Metrics",
"anchor": "A1",
"columns": [
{ "name": "week", "type": "date" },
{ "name": "channel", "type": "text" },
{ "name": "sessions", "type": "number" }
],
"rows": [{ "week": "2026-09-28", "channel": "organic", "sessions": 1200 }]
}テーブルに行を追加する
テーブルはテーブル ID または名前で指定します。存在しない列名は拒否します。
echo '{"rows":[{"week":"2026-10-05","channel":"organic","sessions":1350}]}' | orc sheets tables rows create YOUR_CONNECTION_ID SPREADSHEET_ID Weekly --workspace YOUR_WORKSPACE_ID --stdin --format jsonテーブルに行を追加する
タブを用意する
orc sheets tabs create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --title Weekly --format json
orc sheets tabs update YOUR_CONNECTION_ID SPREADSHEET_ID Weekly --workspace YOUR_WORKSPACE_ID --frozen-rows 1 --index 0 --format json
orc sheets tabs copies create YOUR_CONNECTION_ID SPREADSHEET_ID Weekly --workspace YOUR_WORKSPACE_ID --title 'Weekly (Oct)' --format jsonタブを用意する
行・列を操作する
削除結果の resized_tables に、範囲を詰め直したネイティブテーブルが返ります。
orc sheets dimensions create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --tab Weekly --dimension rows --start 2 --count 3 --format json
orc sheets dimensions delete YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --tab Weekly --dimension rows --start 2 --end 4 --format json
orc sheets dimensions update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --tab Weekly --dimension columns --start 1 --end 5 --auto-resize true --format json行・列を操作する
範囲に行を追記する・クリアする
ネイティブテーブルへの追記は tables rows create を使います。
echo '{"range":"Log!A:C","values":[["2026-10-06","organic",1350]]}' | orc sheets values create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json
orc sheets values delete YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --ranges 'Log!A2:C100' --format json範囲に行を追記する・クリアする
書式と結合を整える
--cell-format には Sheets API の CellFormat を渡します。型は orc sheets schemas get CellFormat で確認できます。
orc sheets formats update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!A1:F1' --cell-format '{"textFormat":{"bold":true}}' --format json
orc sheets formats update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!C2:C' --number-format '{"type":"currency","pattern":"$#,##0"}' --format json
orc sheets merges create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!A1:F1' --format json書式と結合を整える
数式を下へ延ばす・並べ替える・置換する
並べ替えの範囲には見出し行を含めません。置換の結果には変更した件数が返ります。
orc sheets ranges copies create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --source 'Weekly!E2:E2' --destination 'Weekly!E3:E200' --paste-type formula --format json
echo '{"range":"Weekly!A2:F200","sort":[{"column":"C","order":"desc"}]}' | orc sheets ranges sorts create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json
orc sheets replacements create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --find Organic --replacement SEO --tab Weekly --format json数式を下へ延ばす・並べ替える・置換する
名前付き範囲を使う
作成した名前は、ほかのコマンドの範囲指定にもそのまま使えます。
orc sheets named-ranges create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --name Totals --range 'Weekly!A1:F1' --format json
orc sheets named-ranges list YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --format json名前付き範囲を使う
入力規則と条件付き書式を設定する
orc sheets validations update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!B2:B' --condition-type ONE_OF_LIST --values organic,paid,referral --format json
echo '{"range":"Weekly!C2:C","type":"number_gt","expression":"1000","cell_format":{"textFormat":{"bold":true}}}' | orc sheets conditional-formats create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json入力規則と条件付き書式を設定する
フィルタ・交互色・グラフを付ける
グラフは Sheets API の ChartSpec を渡し、tab と anchor で配置します。型は orc sheets schemas get ChartSpec で確認できます。
orc sheets filters update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!A1:F200' --format json
orc sheets bandings create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!A1:F200' --format json
orc sheets charts create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < chart.jsonフィルタ・交互色・グラフを付ける
{
"tab": "Weekly",
"anchor": "H2",
"spec": {
"title": "Weekly sessions",
"basicChart": {
"chartType": "LINE",
"legendPosition": "BOTTOM_LEGEND",
"domains": [{ "domain": { "sourceRange": { "sources": [{ "sheetId": 0, "startRowIndex": 0, "endRowIndex": 200, "startColumnIndex": 0, "endColumnIndex": 1 }] } } }],
"series": [{ "series": { "sourceRange": { "sources": [{ "sheetId": 0, "startRowIndex": 0, "endRowIndex": 200, "startColumnIndex": 2, "endColumnIndex": 3 }] } } }],
"headerCount": 1
}
}
}リンクとメモを付ける
runs を使うと 1 つのセルに複数のリンクを入れられます。メモを空文字にすると消えます。
echo '{"cells":[{"cell":"Weekly!A2","url":"https://example.com/report","text":"Report"},{"cell":"Weekly!B2","runs":[{"text":"Source A","uri":"https://a.example"},{"text":" / "},{"text":"Source B","uri":"https://b.example"}]}]}' | orc sheets links update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json
orc sheets notes update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!C2:C50' --note 'Source: GA4, 2026-10-06' --format json
orc sheets links list YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --range 'Weekly!A1:F50' --format jsonリンクとメモを付ける
エージェント向けに読む
--readonly は書き込みを送信前に止め、--wrap-untrusted はセルの値などを外部テキストの目印で囲みます。
orc sheets get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --include-errors true --readonly --format json
echo '{"tables":[{"table":"Weekly"}],"as":"csv","max_rows":200,"sample":"head_and_tail"}' | orc sheets values get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --readonly --wrap-untrusted --format jsonエージェント向けに読む
スプレッドシートを探す・書き出す・コピーする
exports get はファイルをそのまま返します。--output を付けると保存先と大きさを JSON で表示します。
orc sheets files list YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --query KPI --format json
orc sheets exports get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --file-format xlsx --output kpi.xlsx
orc sheets copies create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --name 'KPI (2026-10)' --format jsonスプレッドシートを探す・書き出す・コピーする
全メソッドに直接アクセスする
schemas get でパラメータを確認してから呼びます。--params はパスとクエリのパラメータ、--body はリクエスト本文です。
orc sheets schemas get spreadsheets.values.batchGet --workspace YOUR_WORKSPACE_ID --format json
orc sheets api get YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --method spreadsheets.values.batchGet --params '{"spreadsheetId":"SPREADSHEET_ID","ranges":["Metrics!A1:D20"],"valueRenderOption":"FORMULA"}' --format json全メソッドに直接アクセスする
batchUpdate リクエストを実行する
リクエストはすべて検証されてから、まとめて適用されます(一部だけ適用されることはありません)。型は orc sheets schemas list と orc sheets schemas get addProtectedRange で確認できます。
orc sheets batch-requests create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < requests.jsonbatchUpdate リクエストを実行する
{
"requests": [
{ "updateSheetProperties": { "properties": { "sheetId": 0, "gridProperties": { "frozenRowCount": 1 } }, "fields": "gridProperties.frozenRowCount" } },
{ "addProtectedRange": { "protectedRange": { "range": { "sheetId": 0, "startRowIndex": 0, "endRowIndex": 1 }, "warningOnly": true } } }
]
}新しいスプレッドシートを作成する
orc sheets create YOUR_CONNECTION_ID --workspace YOUR_WORKSPACE_ID --title 'AI visibility report' --sheet-titles Summary,Weekly --format json新しいスプレッドシートを作成する
必要な権限
Settings → 連携 で Google Workspace を接続します。読み書きの接続(既定)は spreadsheets・documents を必須、drive.file を任意で求めます。読み取り専用(orc connect-sessions create --provider google-workspace --access-mode read_only)は spreadsheets.readonly・documents.readonly を求め、Drive アクセスは求めません。両モードで userinfo.email・openid も任意で求めます。Drive 操作はアプリで使用するファイルに限られます。既存の Google Sheets 接続も引き続き使えます。対象のスプレッドシートは、接続した Google アカウントと共有されている必要があります。Orchestor ではログインとアクセス可能な Workspace が必要です。
グローバルオプション
orc sheets では、次のグローバルオプションを使用できます。
各オプションの詳細と使用例は、グローバルオプションを参照してください。