ファイルに分類を追加

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" }'

{ "Box__Security__Classification__Key": "Sensitive", "$parent": "folder_59449484661,", "$template": "securityClassification-6VMVochwUWo", "$scope": "enterprise_27335", "$version": 1, "$type": "securityClassification-6VMVochwUWo-fd31537a-0f95-4d86-9f2b-5974a29978f8", "$typeVersion": 5, "$canEdit": true }

承認

Authorization

string

header

必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

file_id

string

必須

ファイルを表す一意の識別子。

ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_idは123です。

ボディ

application/json

Box__Security__Classification__Key

string

このファイルに適用する分類の名前。

会社で使用できる分類のリストを取得するには、分類APIを使用して、使用可能なすべての分類キーが表示される分類テンプレートを取得します。

例:

"Sensitive"

レスポンス

ファイルに適用された分類テンプレートインスタンスを返します。

ファイルまたはフォルダに適用される分類を含む、分類メタデータテンプレートのインスタンス。

項目に適用される分類に関する詳細を取得するには、分類メタデータテンプレートをリクエストしてください。

Box__Security__Classification__Key

string

項目に適用される分類の名前。

例:

"Sensitive"

$parent

string

このメタデータインスタンスが追加されている項目の識別子。これは、親のtypeとidを{type}_{id}という形式で組み合わせたものです。

例:

"folder_59449484661,"

$template

enum<string>

値は常にsecurityClassification-6VMVochwUWoになります。

利用可能なオプション:

securityClassification-6VMVochwUWo

例:

"securityClassification-6VMVochwUWo"

$scope

string

この分類が適用されている会社のスコープ。

これはenterprise_{enterprise_id}形式になります。

例:

"enterprise_27335"

$version

integer

メタデータインスタンスのバージョン。このバージョンは0から始まり、分類が更新されるたびに増加します。

例:

1

$type

string

この分類インスタンスの一意のID。これには、分類テンプレートの名前と一意のIDが含まれます。

例:

"securityClassification-6VMVochwUWo-fd31537a-0f95-4d86-9f2b-5974a29978f8"

$typeVersion

number

メタデータテンプレートのバージョン。このバージョンは0から始まり、テンプレートが更新されるたびに増加します。これはほとんどの場合、内部で使用されます。

例:

5

$canEdit

boolean

エンドユーザーが分類を変更できるかどうか。

例:

true

Documentation Index

承認

パスパラメータ

ボディ

レスポンス