メインコンテンツへスキップ
POST
/
metadata_taxonomies
cURL
curl -i -X POST "https://api.box.com/2.0/metadata_taxonomies" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "displayName": "Geography",
       "key": "geography",
       "namespace": "enterprise_123456"
     }'
{
  "id": "822227e0-47a5-921b-88a8-494760b2e6d2",
  "displayName": "Geography",
  "namespace": "enterprise_123456",
  "key": "geography",
  "levels": [
    {
      "displayName": "Continent",
      "description": "Continent",
      "level": 1
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

​
Authorization
string
header
必須

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

ボディ

application/json
​
displayName
string
必須

メタデータ階層の表示名。

Maximum string length: 4096
例:

"Geography"

​
namespace
string
必須

作成するメタデータ階層の名前空間。

Maximum string length: 4096
例:

"enterprise_123456"

​
key
string

メタデータ階層のキー。リクエスト本文で指定しない場合、displayNameから生成されます。displayNameは小文字に変換され、英数字以外の文字とスペースはすべてアンダースコアに置き換えられます。

Maximum string length: 256
例:

"geography"

レスポンス

作成されたメタデータ階層を表すスキーマ。

メタデータテンプレートで使用可能なメタデータ階層のオブジェクト。

​
id
string
必須

メタデータ階層の一意の識別子。

例:

"822227e0-47a5-921b-88a8-494760b2e6d2"

​
displayName
string
必須

メタデータ階層の表示名。Boxウェブアプリに表示されます。

Maximum string length: 4096
例:

"Geography"

​
namespace
string
必須

メタデータ階層が関連付けられている名前空間。

Maximum string length: 4096
例:

"enterprise_123456"

​
key
string

メタデータ階層の一意の識別子。この識別子は、そのメタデータ階層が属する名前空間内で一意である必要があります。

Maximum string length: 256
Pattern: ^[a-zA-Z_][-a-zA-Z0-9_]*$
例:

"geography"

​
levels
メタデータ階層レベル · object[]

メタデータ階層のレベル。