フォルダを更新
フォルダを更新します。フォルダの移動、共有リンクの作成、コラボレーションの更新といった目的にも使用できます。
リクエスト
パスパラメータ
0フォルダを表す一意の識別子。
フォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/folder/123の場合、folder_idは123です。
Boxアカウントのルートフォルダは常にID 0で表されます。
クエリパラメータ
id,type,name応答に含める属性のカンマ区切りリスト。このパラメータを使用すると、標準の応答には通常含まれないフィールドをリクエストできます。
このパラメータを指定すると、明示的に指定しない限り標準フィールドは応答に含まれず、リクエストしたフィールドのほかには、簡易版レプリゼンテーションのフィールドしか返されないことに注意してください。
リクエスト本文
trueフォルダの所有者ではないユーザーが そのフォルダに新しいコラボレータを招待できるかどうかを指定します。
trueこのフォルダの所有者ではないコラボレータが このフォルダのその他のコラボレータを 表示できないように制限します。
この制限を有効にした場合は、所有者ではないユーザーが新しいコラボレータを 招待することも制限されます。
このフィールドをfalseに設定する場合は、
can_non_owners_invite_collaboratorsも
falseに設定する必要もあります(まだ設定されていない場合)。
このフォルダをメンバーとして追加するコレクションの配列。現時点では、favoritesコレクションのみがサポートされています。
コレクションのIDを取得するには、すべてのコレクションのリストを取得エンドポイントを使用します。
空の配列[]またはnullを渡すと、すべてのコレクションからこのフォルダが削除されます。
11446498このオブジェクトの一意の識別子
fileこのオブジェクトのタイプ
Legal contracts for the new ACME deal256このフォルダの説明(省略可)
このオブジェクトを設定するとアップロードメールアドレスが有効になります。
ユーザーはこのメールアドレスを使用することにより、メールを介して フォルダにファイルを直接アップロードできます。
値をnullに設定するとアップロードメールアドレスは無効になります。
openこのパラメータが設定されている場合、 ユーザーは、このフォルダに対して自動的に作成されたメールアドレスに メールでファイルを送信できます。
メールアドレスを作成するには、フォルダを作成するとき、または更新するときに このプロパティを設定します。
collaboratorsに設定すると、コラボレータの登録済み
メールアドレスからのメールのみが受け入れられます。
これには、ユーザーが登録しているすべてのメールエイリアスも含まれます。
openに設定すると、どのメールアドレスからのメールでも
受け入れられます。
次の値のいずれか1つ: open,collaborators
trueこのフォルダへの招待を社内のユーザーのみに限定するかどうかを指定します。既存のコラボレーションには影響しません。
New Folderこのフォルダの新しい名前(省略可)。
このフォルダの親フォルダ。フォルダを移動したり、ごみ箱からフォルダを復元したりするときに使用します。
0新しい親フォルダのID
syncedフォルダをユーザーのデバイスに同期する必要があるかどうかを指定します。 これはBox Sync(廃止済み)で使用され、Box Driveでは 使用されません。
次の値のいずれか1つ: synced,not_synced,partially_synced
["approved"]この項目のタグ。これらのタグは Boxウェブアプリおよびモバイルアプリで項目の横に表示されます。
タグを追加または削除するには、項目の現在のタグを取得して 変更してから、このフィールドを更新します。
タグの数は、1項目あたり100個までに制限され、一意のタグは会社あたり10,000個までに 制限されます。
リクエストヘッダー
1変更を加える前にこの項目が最近変更されていないことを確認します。
その項目の最後に認識されたetag値をこのヘッダーに渡すと、それ以降に項目が変更されている場合、エンドポイントは412 Precondition Failedを返して失敗します。
レスポンス
更新されたフォルダのフォルダオブジェクトを返します
使用可能なすべてのフィールドがデフォルトで返されるとは限りません。特定のフィールドを明示的にリクエストするには、fieldsクエリパラメータを使用します。
この呼び出しは同期的に復帰します。これは、すべての子孫に大量の項目が含まれているフォルダを移動する場合にも当てはまります。つまり、非常に大きいフォルダの場合は、この呼び出しが復帰するまでに数分または数時間かかる場合があります。
一部のパラメータが指定されていないか無効な場合はエラーを返します。
bad_request- パラメータが指定されていないか誤っている場合に返されます。このエラーは、アクセスタイプがopenの共有リンクにパスワードが設定されている場合にも発生します。item_name_too_long- フォルダ名が長すぎる場合に返されます。item_name_invalid- フォルダ名に無効な文字が含まれている場合に返されます。
ユーザーにこのアクションを実行するためのアクセス権限がない場合はエラーを返します。
access_denied_insufficient_permissions: ユーザーにフォルダまたは親フォルダへのアクセス権限がない場合に返されます。insufficient_scope: アプリケーションにフォルダを更新するための適切なスコープがない場合に返されます。Boxに保存されているすべてのファイルとフォルダに対して読み取りと書き込みを行えるようにアプリケーションが設定されていることを確認してください。forbidden: ユーザーが他のユーザーに対してこのアクションを実行することが許可されていない場合に返されます。これには、アクセスレベルがcompanyに設定されている共有リンクを無料アカウントで作成するアクションも含まれます。
フォルダまたは親フォルダが見つからないか、 認証済みユーザーがどちらのフォルダにも アクセスできない場合はエラーを返します。
not_found- 認証済みユーザーがフォルダまたは親フォルダにアクセスできない場合に 返されます。
-
operation_blocked_temporary: 別の移動、コピー、削除、 または復元操作が進行中であるために宛先フォルダまたは元のフォルダが ロックされている場合に返されます。操作は後で再試行することができます。
item_name_in_use: この名前のフォルダがすでに親フォルダに存在している場合に 返されます。
If-Matchヘッダーがフォルダの現在のetag値と一致しない場合はエラーを返します。これは、フォルダが前回リクエストされたときから変更されていることを示します。
操作の処理時間が60秒を超えるとエラーを返します。 この応答が返された後も 操作は続行されます。
予期しないクライアントエラー。
リクエストの例
curl -X PUT https://api.box.com/2.0/folders/4353455 \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Content-Type: application/json" '
-d '{
"name": "New folder name"
}'var requestParams = new BoxFolderRequest()
{
Id = "11111",
Name = "My Documents (2017)"
};
BoxFolder updatedFolder = await client.FoldersManager.UpdateInformationAsync(requestParams);BoxFolder folder = new BoxFolder(api, "id");
BoxFolder.Info info = folder.new Info();
info.setName("New Name");
folder.updateInfo(info);updated_folder = client.folder(folder_id='22222').update_info({
'name': '[ARCHIVED] Planning documents',
'description': 'Old planning documents',
})
print('Folder updated!')client.folders.update('11111', {name: 'Pictures from 2017'})
.then(updatedFolder => {
/* updatedFolder -> {
type: 'folder',
id: '11111',
sequence_id: '1',
etag: '1',
name: 'Pictures from 2017',
created_at: '2012-12-12T10:53:43-08:00',
modified_at: '2012-12-12T11:15:04-08:00',
description: 'Some pictures I took',
size: 629644,
path_collection:
{ total_count: 1,
entries:
[ { type: 'folder',
id: '0',
sequence_id: null,
etag: null,
name: 'All Files' } ] },
created_by:
{ type: 'user',
id: '22222',
name: 'Example User'
login: 'user@example.com' },
modified_by:
{ type: 'user',
id: '22222',
name: 'Example User',
login: 'user@example.com' },
owned_by:
{ type: 'user',
id: '22222',
name: 'Example User',
login: 'user@example.com' },
shared_link: null,
parent:
{ type: 'folder',
id: '0',
sequence_id: null,
etag: null,
name: 'All Files' },
item_status: 'active',
item_collection:
{ total_count: 1,
entries:
[ { type: 'file',
id: '33333',
sequence_id: '3',
etag: '3',
sha1: '134b65991ed521fcfe4724b7d814ab8ded5185dc',
name: 'tigers.jpeg' } ],
offset: 0,
limit: 100 } }
*/
});レスポンスの例
{}