最新バージョン
ファイルのメタデータインスタンスのリストを取得
APIバージョン 2024.0
指定したファイルのすべてのメタデータを取得します。
リクエスト
bearer [ACCESS_TOKEN]
application/json
パスパラメータ
stringパス内必須
12345ファイルを表す一意の識別子。
ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_idは123です。
クエリパラメータ
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クライアントエラー
リクエストパラメータが無効な場合に返されます。
application/jsonクライアントエラー
ユーザーがファイルにアクセスできない場合に返されます。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://api.box.com/2.0/files/12345/metadata" \
-H "authorization: Bearer <ACCESS_TOKEN>"Node/TypeScript v10
await client.fileMetadata.getFileMetadata(file.id);Python v10
client.file_metadata.get_file_metadata(file.id).NET v10
await client.FileMetadata.GetFileMetadataAsync(fileId: file.Id);Swift v10
try await client.fileMetadata.getFileMetadata(fileId: file.id)Java v10
client.getFileMetadata().getFileMetadata(file.getId()).NET v6
await client.FileMetadata.GetFileMetadataAsync(fileId: file.Id);Node v4
await client.fileMetadata.getFileMetadata(file.id);レスポンスの例
{
"entries": [
{
"$parent": "folder_59449484661,",
"$scope": "enterprise_27335",
"$template": "marketingCollateral",
"$version": 1
}
],
"limit": 100
}