Box Developerドキュメント

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

最新バージョン

Update metadata taxonomy

patch
https://api.box.com/2.0
/metadata_taxonomies/:namespace/:taxonomy_key

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

Updates an existing metadata taxonomy.

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
enterprise_123456

The namespace of the metadata taxonomy.

stringパス内必須
geography

The key of the metadata taxonomy.

リクエスト本文

string本文内必須
"Geography"
4096

The display name of the taxonomy.

レスポンス

application/jsonMetadata taxonomy

The schema representing the updated metadata taxonomy.

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

  • 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.

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

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

リクエストの例

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


.NET v6
await client.MetadataTaxonomies.UpdateMetadataTaxonomyAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey, requestBody: new UpdateMetadataTaxonomyRequestBody(displayName: updatedDisplayName));
Node v4
await client.metadataTaxonomies.updateMetadataTaxonomy(namespace, taxonomyKey, {
  displayName: updatedDisplayName,
} satisfies UpdateMetadataTaxonomyRequestBody);

レスポンスの例

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