Box Developerドキュメント
最新バージョン

メタデータ階層を作成

post
https://api.box.com/2.0
/metadata_taxonomies

このエンドポイントはバージョン2024.0です。引き続き使用するために 変更は必要ありません。詳細については、 **Box APIのバージョン管理**を参照してください。

メタデータテンプレートで使用可能な新しいメタデータ階層を作成します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

リクエスト本文

string本文内必須
"Geography"
4096

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

string本文内省略可能
"geography"
256

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

string本文内必須
"enterprise_123456"
4096

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

レスポンス

application/jsonメタデータ階層

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

リクエストのパラメータまたは本文が無効な場合に返されます。

  • bad_request - 本文に有効なリクエストが含まれていない場合に返されます。多くの場合、このレスポンスには、不足しているフィールドに関する追加の詳細が含まれます。

ユーザーにメタデータ階層を作成する権限がない場合に返されます。その理由はいくつかありますが、最も一般的なのは、ユーザーが (共同) 管理者権限を持っていないこと、またはユーザーに指定した名前空間へのアクセス権限が与えられていないことです。

予期しないクライアントエラー。

post
メタデータ階層を作成
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

Box SDKのバージョン戦略の詳細については、 **こちら**を確認してください。


.NET v6
await client.MetadataTaxonomies.CreateMetadataTaxonomyAsync(requestBody: new CreateMetadataTaxonomyRequestBody(displayName: displayName, namespaceParam: namespaceParam) { Key = taxonomyKey });
Node v4
await client.metadataTaxonomies.createMetadataTaxonomy({
  displayName: displayName,
  key: taxonomyKey,
  namespace: namespace,
} satisfies CreateMetadataTaxonomyRequestBody);

レスポンスの例

{
  "id": "822227e0-47a5-921b-88a8-494760b2e6d2",
  "displayName": "Geography",
  "key": "geography",
  "levels": [
    {
      "description": "Continent",
      "displayName": "Continent",
      "level": 1
    }
  ],
  "namespace": "enterprise_123456"
}