Box Developerドキュメントの新しいベータ版サイトがまもなくリリースされる予定です。最新の開発者向けガイド、APIリファレンス、AI搭載の検索により、Boxを使用した迅速な開発をサポートします。更新情報については今しばらくお待ちください。
最新バージョン
Create metadata taxonomy node
APIバージョン 2024.0
Creates a new metadata taxonomy node.
リクエスト
bearer [ACCESS_TOKEN]
application/json
パスパラメータ
stringパス内必須
enterprise_123456The namespace of the metadata taxonomy.
stringパス内必須
geographyThe key of the metadata taxonomy.
リクエスト本文
string本文内必須
"France"The display name of the taxonomy node.
integer本文内必須
1The level of the taxonomy node.
string本文内省略可能
"99df4513-7102-4896-8228-94635ee9d330"The identifier of the parent taxonomy node. Omit this field for root-level nodes.
レスポンス
application/jsonMetadata taxonomy node
The schema representing the taxonomy node created.
application/jsonクライアントエラー
リクエストのパラメータまたは本文が無効な場合に返されます。
bad_request- 本文に有効なリクエストが含まれていない場合に返されます。多くの場合、このレスポンスには、不足しているフィールドに関する追加の詳細が含まれます。
application/jsonクライアントエラー
Returned when the user does not have the permission to modify the metadata taxonomy. This can happen for a few reasons, most commonly when the user does not have (co-)admin permissions, or the user doesn't have access to the provided namespace.
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
.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"
}