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

メタデータ階層ノードを作成

post
https://api.box.com/2.0
/metadata_taxonomies/:namespace/:taxonomy_key/nodes

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

新しいメタデータ階層ノードを作成します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
enterprise_123456

メタデータ階層の名前空間。

stringパス内必須
geography

メタデータ階層のキー。

リクエスト本文

string本文内必須
"France"

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

integer本文内必須
1

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

string本文内省略可能
"99df4513-7102-4896-8228-94635ee9d330"

親メタデータ階層ノードの識別子。このフィールドを省略すると、ルートレベルのノードが作成されます。

レスポンス

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

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

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

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

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

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

リクエストの例

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


.NET v6
await client.MetadataTaxonomies.CreateMetadataTaxonomyNodeAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, requestBody: new CreateMetadataTaxonomyNodeRequestBody(displayName: "Europe", level: 1));
Node v4
await client.metadataTaxonomies.createMetadataTaxonomyNode(
  namespace,
  taxonomyKey,
  {
    displayName: 'Europe',
    level: 1,
  } satisfies CreateMetadataTaxonomyNodeRequestBody,
);

レスポンスの例

{
  "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
  "ancestors": [
    {
      "displayName": "France",
      "id": "14d3d433-c77f-49c5-b146-9dea370f6e32",
      "level": 2
    }
  ],
  "displayName": "France",
  "level": 2,
  "nodePath": [
    "99df4513-7102-4896-8228-94635ee9d330"
  ],
  "parentId": "99df4513-7102-4896-8228-94635ee9d330"
}