最新バージョン
フォルダのメタデータインスタンスのリストを取得
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で表されます。
レスポンス
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())Java v4
BoxFolder file = new BoxFolder(api, "id");
Iterable<Metadata> metadataList = folder.getAllMetadata();
for (Metadata metadata : metadataList) {
// Do something with the metadata.
}Python v3
folder_metadata = client.folder(folder_id='22222').get_all_metadata()
for instance in folder_metadata:
if 'foo' in instance:
print(f'Metadata instance {instance["id"]} has value "{instance["foo"]}" for foo').NET v5
BoxMetadataTemplateCollection<Dictionary<string, object>> metadataInstances = await client.MetadataManager
.GetAllFolderMetadataTemplatesAsync(folderId: "11111");Node v3
client.folders.getAllMetadata('11111')
.then(metadata => {
/* metadata -> {
entries:
[ { currentDocumentStage: 'Init',
'$type': 'documentFlow-452b4c9d-c3ad-4ac7-b1ad-9d5192f2fc5f',
'$parent': 'folder_11111',
'$id': '50ba0dba-0f89-4395-b867-3e057c1f6ed9',
'$version': 4,
'$typeVersion': 2,
needsApprovalFrom: 'Smith',
'$template': 'documentFlow',
'$scope': 'enterprise_12345' },
{ '$type': 'productInfo-9d7b6993-b09e-4e52-b197-e42f0ea995b9',
'$parent': 'folder_11111',
'$id': '15d1014a-06c2-47ad-9916-014eab456194',
'$version': 2,
'$typeVersion': 1,
skuNumber: 45334223,
description: 'Watch',
'$template': 'productInfo',
'$scope': 'enterprise_12345' },
{ Popularity: '25',
'$type': 'properties',
'$parent': 'folder_11111',
'$id': 'b6f36cbc-fc7a-4eda-8889-130f350cc057',
'$version': 0,
'$typeVersion': 2,
'$template': 'properties',
'$scope': 'global' } ],
limit: 100 }
*/
});レスポンスの例
{
"entries": [
{
"$parent": "folder_59449484661,",
"$scope": "enterprise_27335",
"$template": "marketingCollateral",
"$version": 1
}
],
"limit": 100
}