最新バージョン
フォルダのメタデータインスタンスのリストを取得
APIバージョン 2024.0
指定したフォルダのすべてのメタデータを取得します。これは、IDが0のルートフォルダでは使用できません。
リクエスト
bearer [ACCESS_TOKEN]
application/json
パスパラメータ
stringパス内必須
12345フォルダを表す一意の識別子。
フォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/folder/123の場合、folder_idは123です。
Boxアカウントのルートフォルダは常にID 0で表されます。
クエリパラメータ
stringクエリ内省略可能
hydratedTaxonomy field values are returned in API view by default, meaning the value is represented with a taxonomy node identifier. To retrieve the Hydrated view, where taxonomy values are represented with the full taxonomy node information, set this parameter to hydrated. This is the only supported value for this parameter.
レスポンス
application/jsonメタデータインスタンス
フォルダに関連付けられたすべてのメタデータを返します。
このAPIはページネーションをサポートしていないため、常にフォルダに関連付けられたすべてのメタデータを返します。
application/jsonクライアントエラー
リクエストパラメータが無効な場合に返されます。
forbidden- この操作はルートフォルダで許可されていません。
application/jsonクライアントエラー
ユーザーがフォルダにアクセスできない場合に返されます。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://api.box.com/2.0/folders/4353455/metadata" \
-H "authorization: Bearer <ACCESS_TOKEN>"Node/TypeScript v10
await client.folderMetadata.getFolderMetadata(folder.id);Python v10
client.folder_metadata.get_folder_metadata(folder.id).NET v10
await client.FolderMetadata.GetFolderMetadataAsync(folderId: folder.Id);Swift v10
try await client.folderMetadata.getFolderMetadata(folderId: folder.id)Java v10
client.getFolderMetadata().getFolderMetadata(folder.getId()).NET v6
await client.FolderMetadata.GetFolderMetadataAsync(folderId: folder.Id);Node v4
await client.folderMetadata.getFolderMetadata(folder.id);レスポンスの例
{
"entries": [
{
"$parent": "folder_59449484661,",
"$scope": "enterprise_27335",
"$template": "marketingCollateral",
"$version": 1
}
],
"limit": 100
}