基本操作

space folders

orc space folders は、Space のフォルダツリーを一覧・作成・更新・アーカイブするコマンドです。サイドバーのフォルダツリーと同じフォルダを扱います。

実行には認証とWorkspaceの選択が必要です。フォルダの作成・更新・アーカイブとアイテムの移動には files:write が必要です。ドキュメントとシートを移動するときは、代わりに doc:update が必要です。

使い方

terminal
orc space folders list --workspace YOUR_WORKSPACE_ID --format json

Workspace のフォルダを一覧にします。

サブコマンド

list

アーカイブされていないフォルダをすべて返します。--project-id を指定すると、最も近い親フォルダに設定されたプロジェクトが一致するフォルダだけを返します。親がアーカイブ済みでも、プロジェクトの判定には使われます。

terminal
orc space folders list [options]

固有のオプション

--project-id

value

型: string。任意。

terminal
orc space folders list --project-id <value>

create

title を指定してフォルダを作成します。parent_id で親フォルダ、project_id でプロジェクト、color と position で表示を指定できます。省略した値は、親なし・プロジェクトなし・色なし・位置0になります。

terminal
orc space folders create [options]

固有のオプション

--color

Body field: color; (use "null" or "reset" to clear); max 128 chars

型: string。任意。

terminal
orc space folders create --color <value>
--parent-id

Body field: parent_id; (use "null" or "reset" to clear)

型: string。任意。

terminal
orc space folders create --parent-id <value>
--position

Body field: position

型: number。任意。

terminal
orc space folders create --position <value>
--project-id

Body field: project_id; (use "null" or "reset" to clear)

型: string。任意。

terminal
orc space folders create --project-id <value>
--title

(required) Body field: title; max 256 chars

型: string。任意。

terminal
orc space folders create --title <value>

update

フォルダ名・色・位置・プロジェクトを変更します。parent_id を変えると別のフォルダの下へ移動し、null で最上位へ戻します。親フォルダとプロジェクトは同じWorkspaceのものに限られ、自分自身や子孫の下へ移動すると400になります。

terminal
orc space folders update <id> [options]

固有のオプション

--color

Body field: color; (use "null" or "reset" to clear); max 128 chars

型: string。任意。

terminal
orc space folders update <id> --color <value>
--parent-id

Body field: parent_id; (use "null" or "reset" to clear)

型: string。任意。

terminal
orc space folders update <id> --parent-id <value>
--position

Body field: position

型: number。任意。

terminal
orc space folders update <id> --position <value>
--project-id

Body field: project_id; (use "null" or "reset" to clear)

型: string。任意。

terminal
orc space folders update <id> --project-id <value>
--title

Body field: title; max 256 chars

型: string。任意。

terminal
orc space folders update <id> --title <value>

archive

フォルダIDを指定してアーカイブします。

terminal
orc space folders archive <id> [options]

space items folder set

ドキュメント・シート・ファイル・フォルダを、指定したフォルダへ移動します。kind は document、sheet、file、folder のいずれかです。folder_id に null を渡すとフォルダから外します。フォルダを移動するときは folders update と同じ循環チェックを行います。

terminal
orc space items folder set <kind> <id> [options]

固有のオプション

--folder-id

(required) Body field: folder_id; (use "null" or "reset" to clear)

型: string。任意。

terminal
orc space items folder set <kind> <id> --folder-id <value>

グローバルオプション

orc space folders では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。