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

メタデータ階層キーを指定してメタデータ階層を取得

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

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

メタデータ階層キーを指定してメタデータ階層を取得する場合に使用します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
enterprise_123456

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

stringパス内必須
geography

メタデータ階層のキー。

レスポンス

application/jsonメタデータ階層

メタデータ階層キーで指定されたメタデータ階層を返します。

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

指定されたnamespaceおよびtaxonomy_keyを持つメタデータ階層が見つからない場合に返されます。

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

get
メタデータ階層キーを指定してメタデータ階層を取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

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


.NET v6
await client.MetadataTaxonomies.GetMetadataTaxonomyByKeyAsync(namespaceParam: namespaceParam, taxonomyKey: taxonomyKey);
Node v4
await client.metadataTaxonomies.getMetadataTaxonomyByKey(
  namespace,
  taxonomyKey,
);

レスポンスの例

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