タイプの作成
/content/management/api/v1.1/types
リクエスト
- application/json
- links(optional): string
このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby
- X-Requested-With: string
CSRF攻撃を軽減するためのカスタム・ヘッダー。許容値:
[ "XMLHttpRequest" ]
object- allowedActions(optional): array allowedActions
タイプのallowedActions。
- allowedFileTypes(optional): array allowedFileTypes
タイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
- apiName(optional): string
タイプのAPI名。
- archivedFields(optional): object ItemSubResourceListTypeField
アイテムSubResource。
- connectorInfos(optional): array connectorInfos
タイプのconnectorInfos。
- createdBy(optional): string
作成方法
- createdDate(optional): object date
date
- description(optional): string
タイプの説明。
- displayName(optional): string
タイプの表示名。 これはgetレスポンスの必須プロパティですが、post/putリクエストでは必要ありません。
- fields(optional): array fields
タイプで使用されるフィールド。
- id(optional): string
型のId。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- inplacePreview(optional): object ItemSubResourceListInplacePreview
アイテムSubResource。
- jobToken(optional): string
タイプを更新するバックグラウンド・ジョブのジョブ・トークン。
- layoutMapping(optional): object ItemSubResourceListLayoutMapping
アイテムSubResource。
- links(optional): array links
- name(optional): string
タイプの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalProperties特定のプロパティを入力します。
- relationships(optional): object ItemSubResourceTypeRelationships
アイテムSubResource。
- requiredTaxonomies(optional): object ItemSubResourceListRequiredTaxonomy
アイテムSubResource。
- roleName(optional): string
コンテンツ・タイプのユーザー・ロールの名前。
- typeCategory(optional): string
タイプのカテゴリ。 使用可能な値は[ContentType, DigitalAssetType]です。 これはレスポンス取得の必須プロパティです。 ポスト・リクエストではオプションで、ContentTypeにデフォルト設定されます。 Putリクエストでもオプションで、URLのtypeNameパス・パラメータに基づいて識別されます。
- updatedBy(optional): string
更新者
- updatedDate(optional): object date
date
array- Array of: string
許容値:
[ "preview", "read", "write", "update", "delete" ]
arrayarray- Array of: object ConnectorInfo
ConnectorInfo
object- apiName(optional): string
フィールドのAPI名。
- archivedBy(optional): string
アーカイブしました。
- archivedDate(optional): object date
date
- datatype(optional): string
許容値:
[ "number", "long", "decimal", "text", "largetext", "reference", "datetime", "boolean" ]データ型列挙。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。 - defaultValue(optional): object defaultValue
フィールドのdefaultValue。
- description(optional): string
フィールドの説明。
- id(optional): string
フィールドのid。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- isSystemField(optional): boolean
システムによって提供されるフィールドです。
- name(optional): string
フィールドの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalPropertiesフィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
- required(optional): boolean
フィールドの必須またはオプションの値。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- settings(optional): object settings
許可される追加のプロパティ: additionalPropertiesフィールド固有の設定。
- valuecount(optional): string
許容値:
[ "single", "list" ]値は単一またはリストとしてカウントされます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
objectobject{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}objectobjectobject- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
object- connectorId(optional): string
コネクタのId。
- connectorSyncEnabled(optional): boolean
コネクタの同期ステータス。
object- apiName(optional): string
レイアウトの名前。
- formats(optional): object formats
許可される追加のプロパティ: additionalPropertiesレイアウト形式。
- generateRendition(optional): boolean
generateRendition.
- id(optional): integer(int64)
レイアウト・マッピングのID。
- label(optional): string
レイアウト・マッピングのカテゴリの名前です。
objectobject- references(optional): array references
一意のアイテムが必要:
true参照タイプ名/ID
arraytrue- Array of: object TypeReferences
型参照Bean
object- apiName(optional): string
読取り専用:
true - id(optional): string
- name(optional): string
読取り専用:
true
レスポンス
- application/json
201レスポンス
object- allowedActions(optional): array allowedActions
タイプのallowedActions。
- allowedFileTypes(optional): array allowedFileTypes
タイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
- apiName(optional): string
タイプのAPI名。
- archivedFields(optional): object ItemSubResourceListTypeField
アイテムSubResource。
- connectorInfos(optional): array connectorInfos
タイプのconnectorInfos。
- createdBy(optional): string
作成方法
- createdDate(optional): object date
date
- description(optional): string
タイプの説明。
- displayName(optional): string
タイプの表示名。 これはgetレスポンスの必須プロパティですが、post/putリクエストでは必要ありません。
- fields(optional): array fields
タイプで使用されるフィールド。
- id(optional): string
型のId。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- inplacePreview(optional): object ItemSubResourceListInplacePreview
アイテムSubResource。
- jobToken(optional): string
タイプを更新するバックグラウンド・ジョブのジョブ・トークン。
- layoutMapping(optional): object ItemSubResourceListLayoutMapping
アイテムSubResource。
- links(optional): array links
- name(optional): string
タイプの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalProperties特定のプロパティを入力します。
- relationships(optional): object ItemSubResourceTypeRelationships
アイテムSubResource。
- requiredTaxonomies(optional): object ItemSubResourceListRequiredTaxonomy
アイテムSubResource。
- roleName(optional): string
コンテンツ・タイプのユーザー・ロールの名前。
- typeCategory(optional): string
タイプのカテゴリ。 使用可能な値は[ContentType, DigitalAssetType]です。 これはレスポンス取得の必須プロパティです。 ポスト・リクエストではオプションで、ContentTypeにデフォルト設定されます。 Putリクエストでもオプションで、URLのtypeNameパス・パラメータに基づいて識別されます。
- updatedBy(optional): string
更新者
- updatedDate(optional): object date
date
array- Array of: string
許容値:
[ "preview", "read", "write", "update", "delete" ]
arrayarray- Array of: object ConnectorInfo
ConnectorInfo
object- apiName(optional): string
フィールドのAPI名。
- archivedBy(optional): string
アーカイブしました。
- archivedDate(optional): object date
date
- datatype(optional): string
許容値:
[ "number", "long", "decimal", "text", "largetext", "reference", "datetime", "boolean" ]データ型列挙。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。 - defaultValue(optional): object defaultValue
フィールドのdefaultValue。
- description(optional): string
フィールドの説明。
- id(optional): string
フィールドのid。 これはレスポンス取得と送信リクエストの必須プロパティであり、リクエストの転送には必要ありません。
- isSystemField(optional): boolean
システムによって提供されるフィールドです。
- name(optional): string
フィールドの名前。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- properties(optional): object properties
許可される追加のプロパティ: additionalPropertiesフィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
- required(optional): boolean
フィールドの必須またはオプションの値。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
- settings(optional): object settings
許可される追加のプロパティ: additionalPropertiesフィールド固有の設定。
- valuecount(optional): string
許容値:
[ "single", "list" ]値は単一またはリストとしてカウントされます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
objectobject{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}objectobjectobject- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
object- connectorId(optional): string
コネクタのId。
- connectorSyncEnabled(optional): boolean
コネクタの同期ステータス。
object- apiName(optional): string
レイアウトの名前。
- formats(optional): object formats
許可される追加のプロパティ: additionalPropertiesレイアウト形式。
- generateRendition(optional): boolean
generateRendition.
- id(optional): integer(int64)
レイアウト・マッピングのID。
- label(optional): string
レイアウト・マッピングのカテゴリの名前です。
objectobject- references(optional): array references
一意のアイテムが必要:
true参照タイプ名/ID
arraytrue- Array of: object TypeReferences
型参照Bean
object- apiName(optional): string
読取り専用:
true - id(optional): string
- name(optional): string
読取り専用:
true
400レスポンス
403レスポンス
404レスポンス
409レスポンス
500レスポンス
例
次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、タイプを作成する方法を示しています。
curl -X POST -H 'Content-Type: application/json' -H 'X-Requested-With: XMLHttpRequest' 'https://host:port/content/management/api/v1.1/types'
例1:
これにより、単純型が作成されます。 ペイロードを独自のデータで置換します。
/content/management/api/v1.1/types
リクエスト・ペイロード
{
"name": "Book_1",
"apiName": "book1",
"displayName": "Book_1Display",
"description": "Book_1 description."
}
例2:
これにより、単一値のオプションのテキスト・フィールドを持つ型が作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Book_2",
"displayName": "Book_2Display",
"apiName": "book2",
"typeCategory": "ContentType",
"description": "Book_2 description.",
"fields": [
{
"name": "title",
"apiName": "title",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
}
]
}
例3
これにより、複数値のオプションのテキスト・フィールドを持つ型が作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Book_3",
"displayName": "Book_3Display",
"apiName": "book3",
"description": "Book_3 description.",
"fields": [
{
"name": "title",
"apiName": "title",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "list"
}
]
}
例4
これにより、単一値の必須数値フィールドを持つ型が作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Book_4",
"displayName": "Book_4",
"apiName": "book4",
"description": "Book_4 description.",
"fields": [
{
"name": "volume",
"apiName": "volume",
"description": "Number Field",
"datatype": "number",
"required": true,
"valuecount": "single"
}
]
}
例5
これにより、他の既存のtype(Book_4)を参照する必須の参照フィールドを持つタイプが作成されます。Book_4はシステム内の既存のタイプです。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Author",
"displayName": "AuthorDisplay",
"apiName": "author",
"description": "Author description.",
"fields": [
{
"name": "collection",
"apiName": "collection",
"description": "referenceField",
"datatype": "reference",
"required": true,
"valuecount": "list",
"properties": {},
"settings": {},
"referenceType": {
"type": "Book_4",
"typeCategory": "ContentType"
}
}
]
}
例6
これにより、typeCategoryの必要な参照MyImageを持つ型が作成されます : DigitalAssetType. ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "referenceType",
"displayName": "referenceTypeDisplay",
"apiName": "referenceType",
"description": "referenceType description",
"fields": [
{
"name": "media",
"apiName": "media",
"datatype": "reference",
"referenceType": {
"type": "MyImage"
},
"valuecount": "single",
"required": true
}
]
}
例7
これにより、publishingDependencyを必須とするオプションの参照を持つ型が作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "referenceType-pubDep-required",
"displayName": "refType-pubDep-required_Display",
"apiName": "referenceTypePubDepRequired",
"description": "referenceType-pubDep-required description",
"fields": [
{
"name": "media",
"apiName": "media",
"datatype": "reference",
"required": true,
"valuecount": "single",
"properties": {
"publishingDependency": "required"
},
"settings": {},
"referenceType": {
"type": null,
"types": []
}
}
]
}
例8
これにより、publishingDependencyをオプションにした必須の参照DigitalAssetを持つ型が作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "referenceType-pubDep-optional",
"displayName": "refType-pubDep-optional_Display",
"apiName": "referenceTypePubDepOptional",
"description": "referenceType-pubDep-optional description",
"fields": [
{
"name": "media",
"apiName": "media",
"datatype": "reference",
"required": true,
"valuecount": "single",
"properties": {
"publishingDependency": "optional"
},
"settings": {},
"referenceType": {
"type": "DigitalAsset"
}
}
]
}
例9
これにより、単一値の必須数値フィールドと単一値のオプション・テキスト・フィールドを持つタイプが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Book_5",
"displayName": "Book_5_Display",
"apiName": "book5",
"description": "Book_5 description.",
"fields": [
{
"name": "title",
"apiName": "title",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
},
{
"name": "volume",
"apiName": "volume",
"description": "Number Field",
"datatype": "number",
"required": true,
"valuecount": "single"
}
]
}
例10
これにより、他の既存のtype(Book_4)を参照する参照フィールドを持つタイプAuthorが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Author",
"displayName": "Author_Display",
"apiName": "author",
"description": "Author description.",
"fields": [
{
"name": "subject",
"apiName": "subject",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
},
{
"name": "collection",
"apiName": "collection",
"description": "referenceField",
"datatype": "reference",
"required": true,
"valuecount": "list",
"properties": {},
"settings": {},
"referenceType": {
"type": "Book_4"
}
}
]
}
例11
これにより、1つのオプション・フィールドである参照フィールドを持つタイプ作成者が作成されます。参照フィールドは、他の既存のタイプとデジタル・アセット参照フィールドを参照します。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Author",
"apiName": "author",
"displayName": "Author_Display",
"description": "Author description.",
"fields": [
{
"name": "subject",
"apiName": "subject",
"description": "Text field",
"datatype": "largetext",
"required": false,
"valuecount": "single"
},
{
"name": "collection",
"apiName": "collection",
"description": "referenceField",
"datatype": "reference",
"required": true,
"valuecount": "list",
"properties": {},
"settings": {},
"referenceType": {
"type": "Book_4",
"typeCategory": "ContentType"
}
},
{
"name": "profilePic",
"apiName": "profilePic",
"datatype": "reference",
"referenceType": {
"type": "DigitalAsset",
"typeCategory": "DigitalAssetType"
},
"valuecount": "single",
"required": false
}
]
}
例12
これにより、1つのオプション・フィールド(スキーマのないjsonフィールド)を持つタイプAuthorが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Author",
"displayName": "Author_Display",
"apiName": "author",
"description": "Author description.",
"fields": [
{
"name": "otherDetails",
"apiName": "otherDetails",
"description": "json field",
"datatype": "json",
"required": false,
"valuecount": "single"
}
]
}
例13
これにより、1つの必須フィールド(スキーマを持つjsonフィールド)を持つタイプAuthorが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Author",
"displayName": "Author_Display",
"apiName": "author",
"description": "Author description.",
"fields": [
{
"name": "otherDetails",
"apiName": "otherDetails",
"description": "json field",
"datatype": "json",
"required": true,
"valuecount": "single",
"jsonSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Sample Object schema",
"type": "object",
"properties": {
"string_attr": {
"type": "string"
},
"number_attr": {
"type": "number"
},
"integer_attr": {
"type": "integer"
},
"boolean_attr": {
"type": "boolean"
},
"list_attr": {
"type": "array",
"items": {
"type": "number"
}
},
"object_attr": {
"type": "object"
}
}
}
}
]
}
例14
これにより、単純なデジタル・タイプが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Invoices",
"displayName": "InvoicesDisplay",
"description": "Invoices description.",
"typeCategory": "DigitalAssetType",
"allowedFileTypes": [
"pdf"
]
}
例15
これにより、複数のfields(digital type supports all fields supported by content type, here mentioning only few)を持つデジタル・タイプが作成されます。 ペイロードを独自のデータで置換します。
{
"name": "Invoices",
"displayName": "MyInvoices",
"description": "Invoices description.",
"typeCategory": "DigitalAssetType",
"allowedFileTypes": [
"pdf"
],
"fields": [
{
"name": "title",
"description": "title field",
"datatype": "text",
"required": true,
"valuecount": "single"
},
{
"name": "detail",
"description": "detail field",
"datatype": "largetext",
"required": false,
"valuecount": "multi"
},
{
"name": "invoice date",
"description": "invoice date field",
"datatype": "datetime",
"required": false,
"valuecount": "single"
},
{
"name": "count",
"description": "count field",
"datatype": "number",
"required": false,
"valuecount": "single"
},
{
"name": "percentage",
"description": "percentage field",
"datatype": "decimal",
"required": false,
"valuecount": "single"
},
{
"name": "verified",
"description": "verified field",
"datatype": "boolean",
"required": false,
"valuecount": "single"
},
{
"name": "address",
"description": "address field",
"datatype": "json",
"required": false,
"valuecount": "single"
},
{
"name": "media",
"apiName": "media",
"datatype": "reference",
"referenceType": {
"type": "MyImage"
},
"valuecount": "single",
"required": false
},
{
"name": "collection",
"apiName": "collection",
"description": "referenceField",
"datatype": "reference",
"required": true,
"valuecount": "list",
"properties": {},
"settings": {},
"referenceType": {
"type": "Book_4"
}
}
]
}
例16
ペイロードにallowedFileTypesノードがないため、単純なデジタル型の作成中にエラーが返されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Invoices",
"displayName": "MyInvoices",
"description": "Invoices description.",
"typeCategory": "DigitalAssetType"
}
例17
これにより、わかりやすいURLが有効になり、ファイル共有が有効になっている単純なデジタル・タイプが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Invoices",
"displayName": "InvoicesDisplay",
"description": "Invoices description.",
"typeCategory": "DigitalAssetType",
"allowedFileTypes": [
"pdf"
],
"properties": {
"caas": {
"slug": {
"enabled": true,
"allow-forward-slash": true,
"pattern": "invoices-{name}"
}
},
"caas-translations": {
"description": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"file": {
"inheritFromMaster": true,
"note": "",
"translate": false
},
"name": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"slug": {
"inheritFromMaster": false,
"note": "",
"translate": true
}
}
}
}
リクエスト・ヘッダー
{
"Content-Type": "application/json",
"X-Requested-With": "XMLHttpRequest"
}
例18
これにより、わかりやすいURLが有効になり、ファイル共有が無効になっている単純なデジタル・タイプが作成されます。 ペイロードを独自のデータで置換します。
リクエスト・ペイロード
{
"name": "Invoices",
"displayName": "InvoicesDisplay",
"description": "Invoices description.",
"typeCategory": "DigitalAssetType",
"allowedFileTypes": [
"pdf"
],
"properties": {
"caas": {
"slug": {
"enabled": true,
"allow-forward-slash": true,
"pattern": "invoices-{name}"
}
},
"caas-translations": {
"description": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"file": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"name": {
"inheritFromMaster": false,
"note": "",
"translate": true
},
"slug": {
"inheritFromMaster": false,
"note": "",
"translate": true
}
}
}
}
リクエスト・ヘッダー
{
"Content-Type": "application/json",
"X-Requested-With": "XMLHttpRequest"
}
例19
これにより、2つの必須タクソノミを持つタイプが作成され、1つのタクソノミにデフォルト・カテゴリが割り当てられます。 タクソノミおよびカテゴリはシステムにすでに存在している必要があります。
リクエスト・ペイロード
{
"name": "ContentTypeWithRequiredTaxonomy",
"description": "Type with required taxonomy",
"typeCategory": "ContentType",
"requiredTaxonomies": {
"data": [
{
"id": "B3A601C4A45D418DA24F88E00CA238CE",
"defaultCategories": [
{
"id": "317AE47B62A54463AA8AAB7DA03AC40E"
}
]
},
{
"id": "5C31CC8E13C941D58A7DD471496FF188"
}
]
}
}