---
title: sheets
description: Space シートと Google Sheets を操作します。
canonical_url: https://orchestor.io/docs/space/cli/sheets
markdown_url: https://orchestor.io/docs/space/cli/sheets.md
contentType: reference
---

# 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 の間の文字列です。

```bash title="terminal"
orc connections list --workspace YOUR_WORKSPACE_ID --provider google-workspace --format json
```

*使用例*

## サブコマンド

### `columns list`

型付き列を一覧

```bash title="terminal"
orc sheets columns list [sheet-id] [tab-id] [options]
```

### `columns create`

型付き列を作成

```bash title="terminal"
orc sheets columns create [sheet-id] [tab-id] [options]
```

#### 固有のオプション

##### `--color`

Body field: color

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --color <value>
```

##### `--currency-code`

Body field: currencyCode

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --currency-code <value>
```

##### `--description`

Body field: description

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --description <value>
```

##### `--hidden`

Body field: hidden

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --hidden <value>
```

##### `--options`

Body field: options; csv

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --options <value>
```

##### `--pinned`

Body field: pinned

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --pinned <value>
```

##### `--position`

Body field: position

型: `number`。任意。

```bash title="terminal"
orc sheets columns create --position <value>
```

##### `--title`

(required) Body field: title; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --title <value>
```

##### `--type`

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

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --type <value>
```

##### `--updated-at`

(required) Body field: updated_at

型: `string`。任意。

```bash title="terminal"
orc sheets columns create --updated-at <value>
```

##### `--width`

Body field: width

型: `number`。任意。

```bash title="terminal"
orc sheets columns create --width <value>
```

### `columns update`

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

```bash title="terminal"
orc sheets columns update [sheet-id] [tab-id] [column-id] [options]
```

#### 固有のオプション

##### `--color`

Body field: color

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --color <value>
```

##### `--currency-code`

Body field: currencyCode

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --currency-code <value>
```

##### `--description`

Body field: description

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --description <value>
```

##### `--hidden`

Body field: hidden

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --hidden <value>
```

##### `--options`

Body field: options; csv

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --options <value>
```

##### `--pinned`

Body field: pinned

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --pinned <value>
```

##### `--position`

Body field: position

型: `number`。任意。

```bash title="terminal"
orc sheets columns update --position <value>
```

##### `--title`

Body field: title; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --title <value>
```

##### `--type`

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

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --type <value>
```

##### `--updated-at`

(required) Body field: updated_at

型: `string`。任意。

```bash title="terminal"
orc sheets columns update --updated-at <value>
```

##### `--width`

Body field: width

型: `number`。任意。

```bash title="terminal"
orc sheets columns update --width <value>
```

### `columns delete`

列とセル値を削除

```bash title="terminal"
orc sheets columns delete [sheet-id] [tab-id] [column-id] [options]
```

#### 固有のオプション

##### `--updated-at`

value

型: `string`。任意。

```bash title="terminal"
orc sheets columns delete --updated-at <value>
```

### `list`

List in-house Space sheets

```bash title="terminal"
orc sheets list [options]
```

### `update`

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

```bash title="terminal"
orc sheets update <sheet-id> [options]
```

#### 固有のオプション

##### `--archived`

Body field: archived

型: `string`。任意。

```bash title="terminal"
orc sheets update <sheet-id> --archived <value>
```

##### `--pinned`

Body field: pinned

型: `string`。任意。

```bash title="terminal"
orc sheets update <sheet-id> --pinned <value>
```

##### `--sort-position`

Body field: sort_position

型: `number`。任意。

```bash title="terminal"
orc sheets update <sheet-id> --sort-position <value>
```

##### `--tabs`

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

型: `string`。任意。

```bash title="terminal"
orc sheets update <sheet-id> --tabs <value>
```

##### `--title`

Body field: title; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets update <sheet-id> --title <value>
```

##### `--updated-at`

(required) Body field: updated_at

型: `string`。任意。

```bash title="terminal"
orc sheets update <sheet-id> --updated-at <value>
```

### `delete`

Delete an in-house Space sheet

```bash title="terminal"
orc sheets delete <sheet-id> [options]
```

#### 固有のオプション

##### `--updated-at`

value

型: `string`。必須。

```bash title="terminal"
orc sheets delete <sheet-id> --updated-at <value>
```

### `get`

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

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets get <id> --include-errors <value>
```

### `create`

スプレッドシートを作成

```bash title="terminal"
orc sheets create [id] [options]
```

#### 固有のオプション

##### `--locale`

Body field: locale; max 20 chars

型: `string`。任意。

```bash title="terminal"
orc sheets create --locale <value>
```

##### `--sheet-titles`

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

型: `string`。任意。

```bash title="terminal"
orc sheets create --sheet-titles <value>
```

##### `--time-zone`

Body field: time_zone; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets create --time-zone <value>
```

##### `--title`

(required) Body field: title; max 500 chars

型: `string`。任意。

```bash title="terminal"
orc sheets create --title <value>
```

### `values get`

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

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets values get <id> <spreadsheet-id> --as <value>
```

##### `--max-rows`

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

型: `number`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets values get <id> <spreadsheet-id> --sample <value>
```

##### `--tables`

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

型: `string`。任意。

```bash title="terminal"
orc sheets values get <id> <spreadsheet-id> --tables <value>
```

### `values update`

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

```bash title="terminal"
orc sheets values update <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--data`

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

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets values update <id> <spreadsheet-id> --input <value>
```

##### `--preview`

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

型: `string`。任意。

```bash title="terminal"
orc sheets values update <id> <spreadsheet-id> --preview <value>
```

### `tables create`

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

```bash title="terminal"
orc sheets tables create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--anchor`

Top-left cell of the header row.

型: `string`。任意。

```bash title="terminal"
orc sheets tables create <id> <spreadsheet-id> --anchor <value>
```

##### `--columns`

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

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets tables create <id> <spreadsheet-id> --input <value>
```

##### `--name`

(required) Body field: name; max 200 chars

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets tables create <id> <spreadsheet-id> --rows <value>
```

##### `--sheet`

(required) Existing tab title.; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets tables create <id> <spreadsheet-id> --sheet <value>
```

### `tables rows create`

テーブルに行を追加

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets tables rows create <id> <spreadsheet-id> <table-id> --rows <value>
```

### `tabs create`

タブを追加

```bash title="terminal"
orc sheets tabs create <id> [spreadsheet-id] [options]
```

#### 固有のオプション

##### `--columns`

Body field: columns

型: `number`。任意。

```bash title="terminal"
orc sheets tabs create <id> --columns <value>
```

##### `--index`

Zero-based position. Defaults to the end.

型: `number`。任意。

```bash title="terminal"
orc sheets tabs create <id> --index <value>
```

##### `--rows`

Body field: rows

型: `number`。任意。

```bash title="terminal"
orc sheets tabs create <id> --rows <value>
```

##### `--title`

(required) Body field: title; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets tabs create <id> --title <value>
```

##### `--before-tab-id`

Body field: before_tab_id; max 256 chars

型: `string`。任意。

```bash title="terminal"
orc sheets tabs create <id> --before-tab-id <value>
```

##### `--updated-at`

(required) Body field: updated_at

型: `string`。任意。

```bash title="terminal"
orc sheets tabs create <id> --updated-at <value>
```

### `tabs update`

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

```bash title="terminal"
orc sheets tabs update <id> [spreadsheet-id] [tab] [options]
```

#### 固有のオプション

##### `--frozen-columns`

Columns to freeze; 0 unfreezes.

型: `number`。任意。

```bash title="terminal"
orc sheets tabs update <id> --frozen-columns <value>
```

##### `--frozen-rows`

Rows to freeze; 0 unfreezes.

型: `number`。任意。

```bash title="terminal"
orc sheets tabs update <id> --frozen-rows <value>
```

##### `--hidden`

Body field: hidden

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --hidden <value>
```

##### `--index`

Destination zero-based position.

型: `number`。任意。

```bash title="terminal"
orc sheets tabs update <id> --index <value>
```

##### `--title`

Body field: title; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --title <value>
```

##### `--deleted`

Body field: deleted

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --deleted <value>
```

##### `--position`

Body field: position

型: `number`。任意。

```bash title="terminal"
orc sheets tabs update <id> --position <value>
```

##### `--sort`

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

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --sort <value>
```

##### `--updated-at`

(required) Body field: updated_at

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --updated-at <value>
```

##### `--sort-column`

In-house sheet tab: sort-column

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --sort-column <value>
```

##### `--sort-direction`

In-house sheet tab: sort-direction

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --sort-direction <value>
```

##### `--clear-sort`

In-house sheet tab: clear-sort

型: `boolean`。任意。

```bash title="terminal"
orc sheets tabs update <id> --clear-sort
```

##### `--filter-column`

In-house sheet tab: filter-column

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --filter-column <value>
```

##### `--filter-value`

In-house sheet tab: filter-value

型: `string`。任意。

```bash title="terminal"
orc sheets tabs update <id> --filter-value <value>
```

##### `--clear-filter`

In-house sheet tab: clear-filter

型: `boolean`。任意。

```bash title="terminal"
orc sheets tabs update <id> --clear-filter
```

### `tabs delete`

タブを削除

```bash title="terminal"
orc sheets tabs delete <id> [spreadsheet-id] [tab] [options]
```

#### 固有のオプション

##### `--updated-at`

value

型: `string`。任意。

```bash title="terminal"
orc sheets tabs delete <id> --updated-at <value>
```

### `tabs copies create`

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

```bash title="terminal"
orc sheets tabs copies create <id> <spreadsheet-id> <tab> [options]
```

#### 固有のオプション

##### `--destination-spreadsheet-id`

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

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets tabs copies create <id> <spreadsheet-id> <tab> --title <value>
```

### `dimensions create`

行・列を挿入

```bash title="terminal"
orc sheets dimensions create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--after`

Body field: after

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions create <id> <spreadsheet-id> --after <value>
```

##### `--count`

Body field: count

型: `number`。任意。

```bash title="terminal"
orc sheets dimensions create <id> <spreadsheet-id> --count <value>
```

##### `--dimension`

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

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets dimensions create <id> <spreadsheet-id> --start <value>
```

##### `--tab`

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

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions create <id> <spreadsheet-id> --tab <value>
```

### `dimensions update`

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

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--auto-resize`

Fit to content.

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --auto-resize <value>
```

##### `--dimension`

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

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --dimension <value>
```

##### `--end`

(required) Body field: end

型: `number`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --end <value>
```

##### `--hidden`

Body field: hidden

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --hidden <value>
```

##### `--size`

Row height or column width in pixels.

型: `number`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --size <value>
```

##### `--start`

(required) Body field: start

型: `number`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --start <value>
```

##### `--tab`

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

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions update <id> <spreadsheet-id> --tab <value>
```

### `dimensions delete`

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

```bash title="terminal"
orc sheets dimensions delete <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--dimension`

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

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions delete <id> <spreadsheet-id> --dimension <value>
```

##### `--end`

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

型: `number`。任意。

```bash title="terminal"
orc sheets dimensions delete <id> <spreadsheet-id> --end <value>
```

##### `--start`

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

型: `number`。任意。

```bash title="terminal"
orc sheets dimensions delete <id> <spreadsheet-id> --start <value>
```

##### `--tab`

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

型: `string`。任意。

```bash title="terminal"
orc sheets dimensions delete <id> <spreadsheet-id> --tab <value>
```

### `values create`

範囲の後ろに行を追記

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets values create <id> <spreadsheet-id> --range <value>
```

##### `--values`

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

型: `string`。任意。

```bash title="terminal"
orc sheets values create <id> <spreadsheet-id> --values <value>
```

### `values delete`

範囲の値をクリア

```bash title="terminal"
orc sheets values delete <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--ranges`

(required) Body field: ranges; csv

型: `string`。任意。

```bash title="terminal"
orc sheets values delete <id> <spreadsheet-id> --ranges <value>
```

### `formats update`

書式・数値形式を設定

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets formats update <id> <spreadsheet-id> --field-mask <value>
```

##### `--number-format`

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

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets formats update <id> <spreadsheet-id> --range <value>
```

### `merges create`

セルを結合

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets merges create <id> <spreadsheet-id> --range <value>
```

##### `--type`

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

型: `string`。任意。

```bash title="terminal"
orc sheets merges create <id> <spreadsheet-id> --type <value>
```

### `merges delete`

セルの結合を解除

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets merges delete <id> <spreadsheet-id> --range <value>
```

### `ranges copies create`

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

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets ranges copies create <id> <spreadsheet-id> --source <value>
```

##### `--transpose`

Body field: transpose

型: `string`。任意。

```bash title="terminal"
orc sheets ranges copies create <id> <spreadsheet-id> --transpose <value>
```

### `ranges moves create`

範囲を移動

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets ranges moves create <id> <spreadsheet-id> --source <value>
```

### `ranges sorts create`

範囲を並べ替え

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets ranges sorts create <id> <spreadsheet-id> --sort <value>
```

### `replacements create`

検索して置換

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--find`

(required) Body field: find; max 10000 chars

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --find <value>
```

##### `--include-formulas`

Also search inside formulas.

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --include-formulas <value>
```

##### `--match-case`

Body field: match_case

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --match-case <value>
```

##### `--match-entire-cell`

Body field: match_entire_cell

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --match-entire-cell <value>
```

##### `--range`

Limit to one range.; max 500 chars

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --range <value>
```

##### `--regex`

Body field: regex

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --regex <value>
```

##### `--replacement`

(required) Body field: replacement; max 10000 chars

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --replacement <value>
```

##### `--tab`

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

型: `string`。任意。

```bash title="terminal"
orc sheets replacements create <id> <spreadsheet-id> --tab <value>
```

### `named-ranges list`

名前付き範囲を一覧

```bash title="terminal"
orc sheets named-ranges list <id> <spreadsheet-id> [options]
```

### `named-ranges create`

名前付き範囲を作成

```bash title="terminal"
orc sheets named-ranges create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--name`

(required) Body field: name; max 250 chars

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets named-ranges create <id> <spreadsheet-id> --range <value>
```

### `named-ranges update`

名前付き範囲を変更

```bash title="terminal"
orc sheets named-ranges update <id> <spreadsheet-id> <named-range> [options]
```

#### 固有のオプション

##### `--name`

Body field: name; max 250 chars

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets named-ranges update <id> <spreadsheet-id> <named-range> --range <value>
```

### `named-ranges delete`

名前付き範囲を削除

```bash title="terminal"
orc sheets named-ranges delete <id> <spreadsheet-id> <named-range> [options]
```

### `validations update`

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

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets validations update <id> <spreadsheet-id> --filtered-rows-included <value>
```

##### `--input-message`

Body field: input_message; max 1000 chars

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets validations update <id> <spreadsheet-id> --range <value>
```

##### `--show-custom-ui`

Show the dropdown or checkbox UI where supported.

型: `string`。任意。

```bash title="terminal"
orc sheets validations update <id> <spreadsheet-id> --show-custom-ui <value>
```

##### `--strict`

Reject invalid input instead of showing a warning.

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets validations update <id> <spreadsheet-id> --values <value>
```

### `validations delete`

入力規則を解除

```bash title="terminal"
orc sheets validations delete <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--filtered-rows-included`

Body field: filtered_rows_included

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets validations delete <id> <spreadsheet-id> --range <value>
```

### `conditional-formats list`

条件付き書式を一覧

```bash title="terminal"
orc sheets conditional-formats list <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--tab`

Only this tab (title or sheet ID).; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets conditional-formats list <id> <spreadsheet-id> --tab <value>
```

### `conditional-formats create`

条件付き書式を追加

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets conditional-formats create <id> <spreadsheet-id> --gradient-rule <value>
```

##### `--index`

Priority position; 0 is evaluated first.

型: `number`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets conditional-formats create <id> <spreadsheet-id> --type <value>
```

### `conditional-formats delete`

条件付き書式を削除

```bash title="terminal"
orc sheets conditional-formats delete <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--all`

Body field: all

型: `string`。任意。

```bash title="terminal"
orc sheets conditional-formats delete <id> <spreadsheet-id> --all <value>
```

##### `--index`

Body field: index

型: `number`。任意。

```bash title="terminal"
orc sheets conditional-formats delete <id> <spreadsheet-id> --index <value>
```

##### `--tab`

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

型: `string`。任意。

```bash title="terminal"
orc sheets conditional-formats delete <id> <spreadsheet-id> --tab <value>
```

### `filters update`

フィルタを設定

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets filters update <id> <spreadsheet-id> --range <value>
```

##### `--replace`

Replace an existing filter on the tab.

型: `string`。任意。

```bash title="terminal"
orc sheets filters update <id> <spreadsheet-id> --replace <value>
```

### `filters delete`

フィルタを解除

```bash title="terminal"
orc sheets filters delete <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--tab`

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

型: `string`。任意。

```bash title="terminal"
orc sheets filters delete <id> <spreadsheet-id> --tab <value>
```

### `bandings list`

交互色を一覧

```bash title="terminal"
orc sheets bandings list <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--tab`

Only this tab (title or sheet ID).; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets bandings list <id> <spreadsheet-id> --tab <value>
```

### `bandings create`

交互色を追加

```bash title="terminal"
orc sheets bandings create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--column-properties`

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

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets bandings create <id> <spreadsheet-id> --row-properties <value>
```

### `bandings delete`

交互色を削除

```bash title="terminal"
orc sheets bandings delete <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--banded-range-id`

Body field: banded_range_id

型: `number`。任意。

```bash title="terminal"
orc sheets bandings delete <id> <spreadsheet-id> --banded-range-id <value>
```

##### `--tab`

Remove all banding on this tab.; max 100 chars

型: `string`。任意。

```bash title="terminal"
orc sheets bandings delete <id> <spreadsheet-id> --tab <value>
```

### `charts list`

グラフを一覧

```bash title="terminal"
orc sheets charts list <id> <spreadsheet-id> [options]
```

### `charts create`

グラフを作成

```bash title="terminal"
orc sheets charts create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--anchor`

Top-left cell, e.g. E2.

型: `string`。任意。

```bash title="terminal"
orc sheets charts create <id> <spreadsheet-id> --anchor <value>
```

##### `--height`

Body field: height

型: `number`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets charts create <id> <spreadsheet-id> --tab <value>
```

##### `--width`

Body field: width

型: `number`。任意。

```bash title="terminal"
orc sheets charts create <id> <spreadsheet-id> --width <value>
```

### `charts update`

グラフを変更

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets charts update <id> <spreadsheet-id> <chart-id> --spec <value>
```

### `charts delete`

グラフを削除

```bash title="terminal"
orc sheets charts delete <id> <spreadsheet-id> <chart-id> [options]
```

### `tables update`

テーブルの名前・範囲を変更

```bash title="terminal"
orc sheets tables update <id> <spreadsheet-id> <table-id> [options]
```

#### 固有のオプション

##### `--name`

Body field: name; max 200 chars

型: `string`。任意。

```bash title="terminal"
orc sheets tables update <id> <spreadsheet-id> <table-id> --name <value>
```

##### `--range`

New A1 range including the header row.; max 500 chars

型: `string`。任意。

```bash title="terminal"
orc sheets tables update <id> <spreadsheet-id> <table-id> --range <value>
```

### `tables delete`

テーブルを削除（範囲のセルも削除）

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets tables delete <id> <spreadsheet-id> <table-id> --discard-data <value>
```

### `links list`

リンクを一覧

```bash title="terminal"
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`。必須。

```bash title="terminal"
orc sheets links list <id> <spreadsheet-id> --range <value>
```

### `links update`

リンクを設定（複数リンクも可）

```bash title="terminal"
orc sheets links update <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--cells`

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

型: `string`。任意。

```bash title="terminal"
orc sheets links update <id> <spreadsheet-id> --cells <value>
```

### `notes list`

メモを一覧

```bash title="terminal"
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`。必須。

```bash title="terminal"
orc sheets notes list <id> <spreadsheet-id> --range <value>
```

### `notes update`

メモを設定・削除

```bash title="terminal"
orc sheets notes update <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--note`

(required) Note text; an empty string clears notes.; max 50000 chars

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets notes update <id> <spreadsheet-id> --range <value>
```

### `files list`

スプレッドシートを一覧・名前検索

```bash title="terminal"
orc sheets files list <id> [options]
```

#### 固有のオプション

##### `--query`

Only spreadsheets whose name contains this text.; max 200 chars

型: `string`。任意。

```bash title="terminal"
orc sheets files list <id> --query <value>
```

### `exports get`

XLSX・PDF・CSV などに書き出し

```bash title="terminal"
orc sheets exports get <export-id> [options]
```

### `copies create`

スプレッドシート全体をコピー

```bash title="terminal"
orc sheets copies create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--name`

Name of the copy. Defaults to "Copy of …".; max 500 chars

型: `string`。任意。

```bash title="terminal"
orc sheets copies create <id> <spreadsheet-id> --name <value>
```

##### `--parent-folder-id`

Drive folder for the copy. Defaults to the source folder.

型: `string`。任意。

```bash title="terminal"
orc sheets copies create <id> <spreadsheet-id> --parent-folder-id <value>
```

### `api get`

読み取り専用の Sheets API メソッドを呼ぶ

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets api get <id> --params <value>
```

### `api update`

変更する Sheets API メソッドを呼ぶ

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets api update <id> --params <value>
```

### `batch-requests create`

batchUpdate リクエストをまとめて適用

```bash title="terminal"
orc sheets batch-requests create <id> <spreadsheet-id> [options]
```

#### 固有のオプション

##### `--include-spreadsheet-in-response`

Body field: include_spreadsheet_in_response

型: `string`。任意。

```bash title="terminal"
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`。任意。

```bash title="terminal"
orc sheets batch-requests create <id> <spreadsheet-id> --requests <value>
```

##### `--response-include-grid-data`

Body field: response_include_grid_data

型: `string`。任意。

```bash title="terminal"
orc sheets batch-requests create <id> <spreadsheet-id> --response-include-grid-data <value>
```

##### `--response-ranges`

Body field: response_ranges; csv

型: `string`。任意。

```bash title="terminal"
orc sheets batch-requests create <id> <spreadsheet-id> --response-ranges <value>
```

### `schemas list`

使えるメソッドとリクエスト型を一覧

```bash title="terminal"
orc sheets schemas list [options]
```

### `schemas get`

メソッド・リクエスト型・型定義を取得

```bash title="terminal"
orc sheets schemas get <name> [options]
```

## 使用例

### Space シートのソートとフィルター

```bash title="terminal"
orc sheets tabs update sht_SHEET_ID TAB_ID --sort-column Name --sort-direction asc --filter-column Name --filter-value Task --workspace YOUR_WORKSPACE_ID --format json
orc sheets tabs update sht_SHEET_ID TAB_ID --clear-sort --clear-filter --workspace YOUR_WORKSPACE_ID --format json
```

*Space シートのソートとフィルター*

### Space シートの行を読み書き

```bash title="terminal"
echo '{"values":{"COLUMN_ID":"Task"}}' | orc sheets rows create sht_SHEET_ID TAB_ID --stdin --preview --workspace YOUR_WORKSPACE_ID --format json
echo '{"values":{"COLUMN_ID":"Task"}}' | orc sheets rows create sht_SHEET_ID TAB_ID --stdin --workspace YOUR_WORKSPACE_ID --format json
orc sheets rows list sht_SHEET_ID TAB_ID --as csv --max-rows 10 --sample head_and_tail --wrap-untrusted --readonly --workspace YOUR_WORKSPACE_ID --format json
echo '{"values":{"COLUMN_ID":null}}' | orc sheets rows update sht_SHEET_ID TAB_ID ROW_ID --stdin --preview --workspace YOUR_WORKSPACE_ID --format json
orc sheets rows delete sht_SHEET_ID TAB_ID ROW_ID --yes --workspace YOUR_WORKSPACE_ID --format json
```

*Space シートの行を読み書き*

### Space シートの型付き列を管理

```bash title="terminal"
orc sheets columns create sht_SHEET_ID TAB_ID --title Price --type currency --currency-code JPY --workspace YOUR_WORKSPACE_ID --format json
orc sheets columns list sht_SHEET_ID TAB_ID --workspace YOUR_WORKSPACE_ID --format json
orc sheets columns update sht_SHEET_ID TAB_ID COLUMN_ID --title Amount --position 0 --pinned true --hidden false --workspace YOUR_WORKSPACE_ID --format json
orc sheets columns delete sht_SHEET_ID TAB_ID COLUMN_ID --yes --workspace YOUR_WORKSPACE_ID --format json
```

*Space シートの型付き列を管理*

### Space シートのタブを管理

```bash title="terminal"
orc sheets tabs create sht_SHEET_ID --title Tasks --workspace YOUR_WORKSPACE_ID --format json
orc sheets tabs update sht_SHEET_ID TAB_ID --title Backlog --index 0 --hidden true --workspace YOUR_WORKSPACE_ID --format json
orc sheets tabs update sht_SHEET_ID TAB_ID --hidden false --workspace YOUR_WORKSPACE_ID --format json
orc sheets tabs delete sht_SHEET_ID TAB_ID --yes --workspace YOUR_WORKSPACE_ID --format json
orc sheets tabs update sht_SHEET_ID TAB_ID --deleted false --workspace YOUR_WORKSPACE_ID --format json
```

*Space シートのタブを管理*

### Space シートを作成・一覧

```bash title="terminal"
orc sheets create --title Plan --workspace YOUR_WORKSPACE_ID --format json
orc sheets list --workspace YOUR_WORKSPACE_ID --format json
```

*Space シートを作成・一覧*

### Space シートを取得・更新・削除

```bash title="terminal"
orc sheets get sht_SHEET_ID --workspace YOUR_WORKSPACE_ID --format json
orc sheets update sht_SHEET_ID --title Plan --pinned true --sort-position 0 --archived false --updated-at LAST_UPDATED_AT --workspace YOUR_WORKSPACE_ID --format json
orc sheets delete sht_SHEET_ID --updated-at LAST_UPDATED_AT --yes --workspace YOUR_WORKSPACE_ID --format json
```

*Space シートを取得・更新・削除*

### 構造を確認する

```bash title="terminal"
orc sheets get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --format json
```

*構造を確認する*

### 範囲とテーブル列を読む

以下の JSON を read.json に保存します。`render` は `unformatted`（正確な数値）、`formatted`（表示値）、`formula`（数式）から選べます。

```bash title="terminal"
orc sheets values get YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < read.json
```

*範囲とテーブル列を読む*

```json title="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` にします。

```bash title="terminal"
orc sheets values update YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < write.json
```

*変更差分を確認してから書き込む*

```json title="write.json"
{
  "data": [{ "range": "Metrics!C3:C4", "values": [[1200], ["=SUM(C2:C3)"]] }],
  "input": "user_entered",
  "preview": true
}
```

### 型付きテーブルを作成する

ヘッダー・行・テーブル化を 1 回の原子的なバッチで実行します。日付は ISO 形式（YYYY-MM-DD）で渡せます。型に合わない値は送信前に拒否します。

```bash title="terminal"
orc sheets tables create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < table.json
```

*型付きテーブルを作成する*

```json title="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 または名前で指定します。存在しない列名は拒否します。

```bash title="terminal"
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
```

*テーブルに行を追加する*

### タブを用意する

```bash title="terminal"
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` に、範囲を詰め直したネイティブテーブルが返ります。

```bash title="terminal"
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` を使います。

```bash title="terminal"
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` で確認できます。

```bash title="terminal"
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
```

*書式と結合を整える*

### 数式を下へ延ばす・並べ替える・置換する

並べ替えの範囲には見出し行を含めません。置換の結果には変更した件数が返ります。

```bash title="terminal"
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
```

*数式を下へ延ばす・並べ替える・置換する*

### 名前付き範囲を使う

作成した名前は、ほかのコマンドの範囲指定にもそのまま使えます。

```bash title="terminal"
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
```

*名前付き範囲を使う*

### 入力規則と条件付き書式を設定する

```bash title="terminal"
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` で確認できます。

```bash title="terminal"
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
```

*フィルタ・交互色・グラフを付ける*

```json title="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 つのセルに複数のリンクを入れられます。メモを空文字にすると消えます。

```bash title="terminal"
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` はセルの値などを外部テキストの目印で囲みます。

```bash title="terminal"
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 で表示します。

```bash title="terminal"
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` はリクエスト本文です。

```bash title="terminal"
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` で確認できます。

```bash title="terminal"
orc sheets batch-requests create YOUR_CONNECTION_ID SPREADSHEET_ID --workspace YOUR_WORKSPACE_ID --stdin --format json < requests.json
```

*batchUpdate リクエストを実行する*

```json title="requests.json"
{
  "requests": [
    { "updateSheetProperties": { "properties": { "sheetId": 0, "gridProperties": { "frozenRowCount": 1 } }, "fields": "gridProperties.frozenRowCount" } },
    { "addProtectedRange": { "protectedRange": { "range": { "sheetId": 0, "startRowIndex": 0, "endRowIndex": 1 }, "warningOnly": true } } }
  ]
}
```

### 新しいスプレッドシートを作成する

```bash title="terminal"
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` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--cursor`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

[Documentation index](https://orchestor.io/docs/llms.txt)