Box Developerドキュメント

Box Developerドキュメントの新しいベータ版サイトがまもなくリリースされる予定です。最新の開発者向けガイド、APIリファレンス、AI搭載の検索により、Boxを使用した迅速な開発をサポートします。更新情報については今しばらくお待ちください。

最新バージョン

Add metadata taxonomy level

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

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

Creates a new metadata taxonomy level and appends it to the existing levels. If there are no levels defined yet, this will create the first level.

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
enterprise_123456

The namespace of the metadata taxonomy.

stringパス内必須
geography

The key of the metadata taxonomy.

リクエスト本文

string本文内省略可能
"French Republic"

The description of the taxonomy level.

string本文内必須
"France"

The display name of the taxonomy level.

レスポンス

Returns an array of all taxonomy levels.

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

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

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.

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

post
Add metadata taxonomy level
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

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


.NET v6
await client.MetadataTaxonomies.AddMetadataTaxonomyLevelAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, requestBody: new AddMetadataTaxonomyLevelRequestBody(displayName: "Region") { Description = "Region Description" });
Node v4
await client.metadataTaxonomies.addMetadataTaxonomyLevel(
  namespace,
  taxonomyKey,
  {
    displayName: 'Region',
    description: 'Region Description',
  } satisfies AddMetadataTaxonomyLevelRequestBody,
);

レスポンスの例

{
  "entries": [
    {
      "description": "Continent",
      "displayName": "Continent",
      "level": 1
    }
  ]
}