メタデータ階層は、メタデータ階層のdisplayNameとnamespaceを使用して作成でき、関連項目をnamespaceとtaxonomy_keyを使用して作成できます。
メタデータ階層を作成
メタデータテンプレートで参照可能な新しいメタデータ階層を作成します。
メタデータ階層のdisplayNameとnamespaceを指定して、 APIエンドポイントを呼び出します。キーを指定していなかった場合、Boxによってキーが生成されます。
curl --request POST \
--url "https://api.box.com/2.0/metadata_taxonomies" \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"displayName": "DISPLAY_NAME",
"namespace": "{namespace}",
"key": "{taxonomy_key}"
}'
メタデータ階層レベルを作成
ノードを追加するには、まず1つ以上のレベルを作成し、メタデータ階層の階層構造を定義する必要があります。各レベルが1つの階層を表します (例: Country、State、City)。
メタデータ階層のdisplayName、description、levelを指定して、 APIエンドポイントを呼び出します。
curl --request POST \
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels" \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"levels": [
{
"displayName": "Continent",
"description": "Continent Level"
},
{
"displayName": "Country",
"description": "Country Level"
}
]
}'
メタデータ階層のおよびについては、追加情報があります。
追加レベルを追加
初期レベルを定義した後で、既存の階層の最下位に新しいレベルを追加できます (たとえば、「郡」の後に「市」を追加できます)。
メタデータ階層のdisplayNameおよびdescriptionを指定して、 APIエンドポイントを呼び出します。
curl --request POST \
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/levels:append" \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"displayName": "Region",
"description": "Region Description"
}'
メタデータ階層のおよびについては、追加情報があります。
メタデータ階層へのノードの追加
階層が定義されたら、メタデータ階層におけるデータであるノードの追加を開始できます。
メタデータ階層のdisplayName、level、parentIdを指定して、 APIエンドポイントを呼び出します。
curl --request POST \
--url "https://api.box.com/2.0/metadata_taxonomies/{namespace}/{taxonomy_key}/nodes" \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"displayName": "Europe",
"level": 1
}'
メタデータ階層のおよびについては、追加情報があります。