BoxWorks 2024でコンテンツとAIの可能性について紹介します。
最新バージョン
フォルダの分類を取得
APIバージョン 2024.0
フォルダに適用されている分類メタデータインスタンスを取 得します。
このAPIは、/folders/:id/enterprise_12345/securityClassification-6VMVochwUWoのように、URLにEnterprise IDを明示的に含めることで呼び出すこともできます。
リクエスト
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分類
securityClassificationメタデータテンプレートのインスタンスを返します。これには、この会社が使用できるすべての分類のリストを取得するBox__Security__Classification__Keyフィールドが含まれています。
application/jsonクライアントエラー
リクエストパラメータが無効な場合に返されます。
application/jsonクライアントエラー
指定したメタデータテンプレートがこのフォルダに適用されていない場合、またはユーザーがこのフォルダにアクセスできない場合に返されます。
instance_not_found- メタデータテンプレートがフォルダに適用されていなかった場合に返されます。
application/jsonクライアントエラー
メソッドが許可されなかった場合に返されます。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://api.box.com/2.0/folders/12345/metadata/enterprise/securityClassification-6VMVochwUWo" \
-H "authorization: Bearer <ACCESS_TOKEN>"Node/TypeScript v10
await client.folderClassifications.getClassificationOnFolder(folder.id);Python v10
client.folder_classifications.get_classification_on_folder(folder.id).NET v10
await client.FolderClassifications.GetClassificationOnFolderAsync(folderId: folder.Id);Swift v10
try await client.folderClassifications.getClassificationOnFolder(folderId: folder.id)Java v10
client.getFolderClassifications().getClassificationOnFolder(folder.getId())Java v5
BoxFolder folder = new BoxFolder(api, "id");
Metadata metadata = folder.getMetadata(Metadata.CLASSIFICATION_TEMPLATE_KEY);Python v4
metadata = client.folder(folder_id='11111').metadata(scope='enterprise', template='securityClassification-6VMVochwUWo').get().NET v6
var folderId = "0";
var folderMetadata = await client.MetadataManager.GetFolderMetadataAsync(folderId, "enterprise", "securityClassification-6VMVochwUWo");Node v4
client.folders.getMetadata('11111', 'enterprise', 'securityClassification-6VMVochwUWo')
.then(metadata => {
// the metadata instance, which includes the applied metadata
});レスポンスの例
{
"$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"
}