space folders
orc space folders は、Space のフォルダツリーを一覧・作成・更新・アーカイブするコマンドです。サイドバーのフォルダツリーと同じフォルダを扱います。
実行には認証とWorkspaceの選択が必要です。フォルダの作成・更新・アーカイブとアイテムの移動には files:write が必要です。ドキュメントとシートを移動するときは、代わりに doc:update が必要です。
使い方
orc space folders list --workspace YOUR_WORKSPACE_ID --format jsonWorkspace のフォルダを一覧にします。
サブコマンド
list
アーカイブされていないフォルダをすべて返します。--project-id を指定すると、最も近い親フォルダに設定されたプロジェクトが一致するフォルダだけを返します。親がアーカイブ済みでも、プロジェクトの判定には使われます。
orc space folders list [options]固有のオプション
--project-id
value
型: string。任意。
orc space folders list --project-id <value>create
title を指定してフォルダを作成します。parent_id で親フォルダ、project_id でプロジェクト、color と position で表示を指定できます。省略した値は、親なし・プロジェクトなし・色なし・位置0になります。
orc space folders create [options]固有のオプション
--color
Body field: color; (use "null" or "reset" to clear); max 128 chars
型: string。任意。
orc space folders create --color <value>--parent-id
Body field: parent_id; (use "null" or "reset" to clear)
型: string。任意。
orc space folders create --parent-id <value>--position
Body field: position
型: number。任意。
orc space folders create --position <value>--project-id
Body field: project_id; (use "null" or "reset" to clear)
型: string。任意。
orc space folders create --project-id <value>--title
(required) Body field: title; max 256 chars
型: string。任意。
orc space folders create --title <value>update
フォルダ名・色・位置・プロジェクトを変更します。parent_id を変えると別のフォルダの下へ移動し、null で最上位へ戻します。親フォルダとプロジェクトは同じWorkspaceのものに限られ、自分自身や子孫の下へ移動すると400になります。
orc space folders update <id> [options]固有のオプション
--color
Body field: color; (use "null" or "reset" to clear); max 128 chars
型: string。任意。
orc space folders update <id> --color <value>--parent-id
Body field: parent_id; (use "null" or "reset" to clear)
型: string。任意。
orc space folders update <id> --parent-id <value>--position
Body field: position
型: number。任意。
orc space folders update <id> --position <value>--project-id
Body field: project_id; (use "null" or "reset" to clear)
型: string。任意。
orc space folders update <id> --project-id <value>--title
Body field: title; max 256 chars
型: string。任意。
orc space folders update <id> --title <value>archive
フォルダIDを指定してアーカイブします。
orc space folders archive <id> [options]space items folder set
ドキュメント・シート・ファイル・フォルダを、指定したフォルダへ移動します。kind は document、sheet、file、folder のいずれかです。folder_id に null を渡すとフォルダから外します。フォルダを移動するときは folders update と同じ循環チェックを行います。
orc space items folder set <kind> <id> [options]固有のオプション
--folder-id
(required) Body field: folder_id; (use "null" or "reset" to clear)
型: string。任意。
orc space items folder set <kind> <id> --folder-id <value>グローバルオプション
orc space folders では、次のグローバルオプションを使用できます。
各オプションの詳細と使用例は、グローバルオプションを参照してください。