Box Developerドキュメントの新しいベータ版サイトがまもなくリリースされる予定です。最新の開発者向けガイド、APIリファレンス、AI搭載の検索により、Boxを使用した迅速な開発をサポートします。更新情報については今しばらくお待ちください。
Create metadata taxonomy
Creates a new metadata taxonomy that can be used in metadata templates.
リクエスト
リクエスト本文
"Geography"4096The display name of the taxonomy.
"geography"256The taxonomy key. If it is not provided in the request body, it will be generated from the displayName. The displayName would be converted to lower case, and all spaces and non-alphanumeric characters replaced with underscores.
"enterprise_123456"4096The namespace of the metadata taxonomy to create.
レスポンス
The schema representing the metadata taxonomy created.
リクエストのパラメータまたは本文が無効な場合に返されます。
bad_request- 本文に有効なリクエストが含まれていない場合に返されます。多くの場合、このレスポンスには、不足しているフィールドに関する追加の詳細が含まれます。
Returned when the user does not have the permission to create 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.
予期しないクライアントエラー。
リクエストの例
await client.MetadataTaxonomies.CreateMetadataTaxonomyAsync(requestBody: new CreateMetadataTaxonomyRequestBody(displayName: displayName, namespaceParam: namespaceParam) { Key = taxonomyKey });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"
}