名前を指定してメタデータテンプレートを取得

get

https://api.box.com/2.0

/metadata_templates/:scope/:template_key/schema

scopeとtemplateKeyの値でメタデータテンプレートを取得します。

テンプレートのscopeとtemplateKeyを調べるには、会社のすべてのテンプレートまたはグローバルテンプレートのリストを取得するか、ファイルまたはフォルダに適用されているすべてのテンプレートのリストを取得します。

関連するガイド

メタデータメタデータテンプレートの取得

リクエスト

Content-Typeapplication/json

パスパラメータ

scope stringパス内必須

例global

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

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

template_key stringパス内必須

例properties

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

レスポンス

200application/jsonメタデータテンプレート

scopeおよびtemplateの名前と一致するメタデータテンプレートを返します。

400application/jsonクライアントエラー

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

bad_request: テンプレートのスコープが認識されていない場合によく返されます。scopeの値として必ずenterpriseまたはglobalを使用してください。

404application/jsonクライアントエラー

指定されたscopeおよびtemplate_keyを持つテンプレートが見つからない場合に返されます。

defaultapplication/jsonクライアントエラー

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

get

名前を指定してメタデータテンプレートを取得

このドキュメント内で一部のAPIを試せるようになりました。

ログイン

リクエストの例

cURL

curl -X GET https://api.box.com/2.0/metadata_templates/enterprise/blueprintTemplate/schema \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'

.NET

BoxMetadataTemplate template = await client.MetadataManager
    .GetMetadataTemplate("enterprise", "marketingCollateral");

Java

MetadataTemplate template = MetadataTemplate.getMetadataTemplate(api, "templateName");

Python

template = client.metadata_template('enterprise', 'employeeRecord').get()
print('The {0} template has {1} fields'.format(template.displayName, len(template.fields)))

Node

client.metadata.getTemplateSchema('enterprise', 'vcontract')
	.then(template => {
		/* template -> {
			id: '17f2d715-6acb-45f2-b96a-28b15efc9faa',
			templateKey: 'vcontract',
			scope: 'enterprise_12345',
			displayName: 'Vendor Contract',
			hidden: true,
			fields: 
			[ { type: 'date',
				key: 'signed',
				displayName: 'Date Signed',
				hidden: false },
				{ type: 'string',
				key: 'vendor',
				displayName: 'Vendor',
				hidden: false },
				{ type: 'enum',
				key: 'fy',
				displayName: 'Fiscal Year',
				options: 
					[ { key: 'FY17' },
					{ key: 'FY18' },
					{ key: 'FY19' } ],
				hidden: false } ] }
		*/
	});

iOS

client.metadata.getTemplateByKey(
    scope: "enterprise",
    templateKey: "personnelRecord"
) { (result: Result<MetadataTemplate, BoxSDKError>) in
    guard case let .success(template) = result {
        print("Error retrieving metadata template")
        return
    }

    print("Metadata template has \(template.fields?.count) fields")
}