フォルダのメタデータインスタンスを取得

get
https://api.box.com/2.0
/folders/:folder_id/metadata/:scope/:template_key/

フォルダに適用されているメタデータテンプレートのインスタンスを取得します。これは、IDが0のルートフォルダでは使用できません。

リクエスト

Bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
12345

フォルダを表す一意の識別子。

フォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/folder/123の場合、folder_id123です。

Boxアカウントのルートフォルダは常にID 0で表されます。

stringパス内必須
global

メタデータテンプレートのスコープ

次の値のいずれか1つ: global,enterprise

stringパス内必須
properties

メタデータテンプレートの名前

レスポンス

ユーザーまたはアプリケーションによって定義された追加の"キー/値"ペアを含むメタデータテンプレートのインスタンス。

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

指定したメタデータテンプレートがこのフォルダに適用されていない場合、またはユーザーがこのフォルダにアクセスできない場合に返されます。

  • instance_not_found - メタデータテンプレートがフォルダに適用されていなかった場合に返されます。

メソッドが許可されなかった場合に返されます。これは、フォルダIDが無効であるか、IDが0のルートフォルダである場合によく発生します。

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

get
フォルダのメタデータインスタンスを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -i -X GET "https://api.box.com/2.0/folders/4353455/metadata/enterprise_27335/blueprintTemplate" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"

レスポンスの例

{
  "$parent": "folder_59449484661,",
  "$scope": "enterprise_27335",
  "$template": "marketingCollateral",
  "$version": 1
}