メインコンテンツへスキップ
PUT
/
metadata_templates
/
{scope}
/
{template_key}
/
schema
cURL
curl -i -X PUT "https://api.box.com/2.0/metadata_templates/enterprise/blueprintTemplate/schema" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json-patch+json" \
     -d '[
       {
         "op": "editField",
         "fieldKey": "category",
         "data": {
           "displayName": "Customer Group"
         }
       }
     ]'
{
  "id": "58063d82-4128-7b43-bba9-92f706befcdf",
  "type": "metadata_template",
  "scope": "enterprise_123456",
  "templateKey": "productInfo",
  "displayName": "Product Info",
  "hidden": true,
  "fields": [
    {
      "type": "string",
      "key": "category",
      "displayName": "Category",
      "description": "The category",
      "hidden": true,
      "options": [
        {
          "key": "Category 1",
          "id": "45dc2849-a4a7-40a9-a751-4a699a589190"
        }
      ],
      "id": "822227e0-47a5-921b-88a8-494760b2e6d2"
    }
  ],
  "copyInstanceOnItemCopy": true
}

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

パスパラメータ

scope
enum<string>
必須

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

利用可能なオプション:
global,
enterprise
template_key
string
必須

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

ボディ

application/json-patch+json
op
enum<string>
必須

テンプレートに対して実行する変更のタイプ。その中には、既存のテンプレートを変更する際に危険を伴うものもあります。

利用可能なオプション:
editTemplate,
addField,
reorderFields,
addEnumOption,
reorderEnumOptions,
reorderMultiSelectOptions,
addMultiSelectOption,
editField,
removeField,
editEnumOption,
removeEnumOption,
editMultiSelectOption,
removeMultiSelectOption
:

"addEnumOption"

data
object

操作するデータ。これは、実行される操作によって異なります。

:
{ "name": "Aaron Levie" }
fieldKey
string

1つのフィールドに影響する操作の場合は、影響を受けるフィールドのキーを定義します。

:

"category"

fieldKeys
string[]

複数のフィールドに影響する操作の場合は、影響を受けるフィールドのキーを定義します。

:
["category", "name"]
enumOptionKey
string

1つのenumオプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。

:

"option1"

enumOptionKeys
string[]

複数のenumオプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。

:
["option1", "option2", "option3"]
multiSelectOptionKey
string

1つの複数選択オプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。

:

"option1"

multiSelectOptionKeys
string[]

複数の複数選択オプションに影響する操作の場合は、影響を受けるオプションのキーを定義します。

:
["option1", "option2", "option3"]

レスポンス

カスタムテンプレートデータを含め、更新されたメタデータテンプレートを返します。

ファイルやフォルダに適用可能なメタデータのテンプレート。

id
string
必須

メタデータテンプレートのID。

:

"58063d82-4128-7b43-bba9-92f706befcdf"

type
enum<string>
必須

値は常にmetadata_templateになります。

利用可能なオプション:
metadata_template
:

"metadata_template"

scope
string

メタデータテンプレートのスコープは、globalまたはenterprise_*のいずれかになります。globalスコープは、Boxを使用するすべての会社が利用できるテンプレートに使用されます。enterprise_*スコープは、特定の会社内で作成されたテンプレートを表します (*はその会社のID)。

:

"enterprise_123456"

templateKey
string

テンプレートの一意の識別子。この識別子は、メタデータテンプレートが適用される会社のscope全体で一意ですが、会社を越えて一意であるとは限りません。

Maximum string length: 64
Pattern: ^[a-zA-Z_][-a-zA-Z0-9_]*$
:

"productInfo"

displayName
string

テンプレートの表示名。Boxウェブアプリとモバイルアプリに表示されます。

Maximum string length: 4096
:

"Product Info"

hidden
boolean

このテンプレートをBoxウェブアプリのUIに表示するか、APIを介した使用のみを目的とするかを定義します。

:

true

fields
メタデータフィールド (読み取り) · object[]

テンプレートに含まれるテンプレートフィールドの順序付きリスト。各フィールドは、通常のテキストフィールド、日付フィールド、数値フィールド、単一または複数選択リストのいずれかになります。

copyInstanceOnItemCopy
boolean

ファイルまたはフォルダのコピー時にメタデータを含めるかどうか。

:

true