Box Developerドキュメントの新しいベータ版サイトがまもなくリリースされる予定です。最新の開発者向けガイド、APIリファレンス、AI搭載の検索により、Boxを使用した迅速な開発をサポートします。更新情報については今しばらくお待ちください。
最新バージョン
ファイルに分類を追加
APIバージョン 2024.0
追加する分類のラベルを指定することで、ファイルに分類を追加します。
このAPIは、/files/:id//enterprise_12345/securityClassification-6VMVochwUWoのように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。
レスポンス
application/json分類
ファイルに適用された分類テンプレートインスタンスを返します。
application/jsonクライアントエラー
リクエスト本文が無効な場合にエラーを返します。
schema_validation_failed- リクエスト本文に、存在しないフィールドか、値またはタイプが期待されるフィールドタイプと一致しないフィールドの値が含まれています。たとえば、enumまたはmultiSelectフィールドに不明なオプションが指定されている場合があります。
application/jsonクライアントエラー
ファイルテンプレートまたはメタデータテンプレートが見つからなかった場合にエラーを返します。
not_found- ファイルが見つからないか、ユーザーがファイルにアクセスできない場合に返されます。instance_tuple_not_found- メタデータテンプレートが見つかりませんでした。
application/jsonクライアントエラー
このメタデータテンプレートのインスタンスがすでにファイルに存在する場合はエラーを返します。
tuple_already_exists- メタデータテンプレートのインスタンスがすでにファイルに存在する場合に返されます。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X POST "https://api.box.com/2.0/files/12345/metadata/enterprise/securityClassification-6VMVochwUWo" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"Box__Security__Classification__Key": "Sensitive"
}'Node/TypeScript v10
await client.fileClassifications.addClassificationToFile(file.id, {
requestBody: {
boxSecurityClassificationKey: classification.key,
} satisfies AddClassificationToFileRequestBody,
} satisfies AddClassificationToFileOptionalsInput);Python v10
client.file_classifications.add_classification_to_file(
file.id, box_security_classification_key=classification.key
).NET v10
await client.FileClassifications.AddClassificationToFileAsync(fileId: file.Id, requestBody: new AddClassificationToFileRequestBody() { BoxSecurityClassificationKey = classification.Key });Swift v10
try await client.fileClassifications.addClassificationToFile(fileId: file.id, requestBody: AddClassificationToFileRequestBody(boxSecurityClassificationKey: classification.key))Java v10
client.getFileClassifications().addClassificationToFile(file.getId(), new AddClassificationToFileRequestBody.Builder().boxSecurityClassificationKey(classification.getKey()).build()).NET v6
await client.FileClassifications.AddClassificationToFileAsync(fileId: file.Id, requestBody: new AddClassificationToFileRequestBody() { BoxSecurityClassificationKey = classification.Key });Node v4
await client.fileClassifications.addClassificationToFile(file.id, {
requestBody: {
boxSecurityClassificationKey: classification.key,
} satisfies AddClassificationToFileRequestBody,
} satisfies AddClassificationToFileOptionalsInput);レスポンスの例
{
"$canEdit": true,
"$parent": "folder_59449484661,",
"$scope": "enterprise_27335",
"$template": "securityClassification-6VMVochwUWo",
"$type": "securityClassification-6VMVochwUWo-fd31537a-0f95-4d86-9f2b-5974a29978f8",
"$typeVersion": 5,
"$version": 1,
"Box__Security__Classification__Key": "Sensitive"
}