タイプを読み取る
get
/content/management/api/v1.1/types/{name}
型を読み取ります。
リクエスト
パス・パラメータ
- name: string
型名識別子は大/小文字が区別され、特殊文字はエンコードする必要があります。
問合せパラメータ
- expand(optional): string
Expandパラメータは、タイプresponseを使用して子リソース(archivedFields)をインラインで取得するオプションを提供します。 archivedFields、relationshipsまたは「すべて」を受け入れます。
例 : expand= すべて
archivedFieldsおよびタイプ・レスポンスの関係を返します。
例 : expand= archivedFields
タイプ・レスポンスでarchivedFieldsを返します。 - fields(optional): string
このパラメータは、typeの返されるフィールドを制御するために使用されます。 このパラメータは、フィールド名のカンマ区切りリストを受け入れます。
すべてのフィールド名は大文字と小文字が区別されるため、ユーザーは問合せで正しいフィールド名を指定する必要があります。
このパラメータが指定されていない場合、レスポンスにはデフォルトのフィールドが含まれます。
デフォルトのフィールドは次のとおりです:
- id
- name
- displayName
- apiName
- description
- typeCategory
- createdBy
- createdDate
- updatedBy
- updatedDate
- fields
- properties
- allowedFileTypes
- roleName
- layoutMapping
- inplacePreview
- allowedActions
- archivedFields
- relationships
- connectorInfos
例: ?fields=name
これにより、タイプの名前とリンクのみが返されます。
デフォルト値:id,name,displayName,apiName,description,typeCategory,createdBy,createdDate,updatedBy,updatedDate,fields,properties,allowedFileTypes,roleName,layoutMapping,inplacePreview,allowedActions,archivedFields,relationships,connectorInfos,jobToken,renditionPolicies - links(optional): string
このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
OK。
ルート・スキーマ : タイプ
型:
objectAggregatedType
ソースを表示
- 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
ネストされたスキーマ : allowedActions
型:
arrayタイプのallowedActions。
ソースを表示
- Array of: string
許容値:
[ "preview", "read", "write", "update", "delete" ]
ネストされたスキーマ : allowedFileTypes
型:
arrayタイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
ソースを表示
ネストされたスキーマ : connectorInfos
型:
arrayタイプのconnectorInfos。
ソースを表示
- Array of: object ConnectorInfo
ConnectorInfo
ネストされたスキーマ : TypeField
型:
objectFieldInAggrType.
ソースを表示
- 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" ]値は単一またはリストとしてカウントされます。 これは、レスポンスの取得とリクエストのポスト/送信の必須プロパティです。
ネストされたスキーマ : defaultValue
型:
objectフィールドのdefaultValue。
ネストされたスキーマ: properties
型:
object使用可能なその他のプロパティ
ソースを表示
フィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
例:
{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}ネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ: Link
型:
objectリソースのリンク。
ソースを表示
- href(optional): string
ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
- mediaType(optional): string
メディア・タイプ。
- method(optional): string
ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
- profile(optional): string
ターゲット・リソースを記述するメタデータにリンクします。
- rel(optional): string
関連タイプ これはレスポンス取得の必須プロパティです。
- templated(optional): boolean
URIがテンプレートであるかどうか。
ネストされたスキーマ : ConnectorInfo
型:
objectConnectorInfo
ソースを表示
- connectorId(optional): string
コネクタのId。
- connectorSyncEnabled(optional): boolean
コネクタの同期ステータス。
ネストされたスキーマ : LayoutMapping
型:
objectLayoutMapping
ソースを表示
- apiName(optional): string
レイアウトの名前。
- formats(optional): object formats
許可される追加のプロパティ: additionalPropertiesレイアウト形式。
- generateRendition(optional): boolean
generateRendition.
- id(optional): integer(int64)
レイアウト・マッピングのID。
- label(optional): string
レイアウト・マッピングのカテゴリの名前です。
ネストされたスキーマ: additionalProperties
型:
objectネストされたスキーマ : TypeRelationships
型:
objectタイプ関連
ソースを表示
- references(optional): array references
一意のアイテムが必要:
true参照タイプ名/ID
ネストされたスキーマ : references
型:
array一意のアイテムが必要:
true参照タイプ名/ID
ソースを表示
- Array of: object TypeReferences
型参照Bean
ネストされたスキーマ : カテゴリ
型:
ソースを表示
object- apiName(optional): string
読取り専用:
true - id(optional): string
- name(optional): string
読取り専用:
true
304 レスポンス
変更されていません。
400レスポンス
不正リクエスト
403レスポンス
禁止。
404レスポンス
見つかりません。
500レスポンス
内部サーバー・エラー
例
次の例では、cURLを使用してGETリクエストを送信することによってすべてのタイプを取得する方法を示します。
curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/types/{name}'
例1
これは、name:TypeSampleで型を読み取ります。
/content/management/api/v1.1/types/TypeSample
レスポンス本文
{
"id": "D103EEB2A5CC42619D7688A62A169092",
"name": "TypeSample",
"displayName": "TypeSampleDisplayName",
"apiName": "typeSample",
"typeCategory" : "ContentType",
"allowedFileTypes" : ["ContentItem"],
"description": "",
"createdBy": "cecusername",
"createdDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"updatedBy": "cecusername",
"updatedDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"fields": [
{
"id": "66EA1FD6AE634B1290968AB1C8F606C4",
"name": "fieldASample",
"apiName": "fieldASample",
"description": "Content",
"datatype": "largetext",
"required": false,
"valuecount": "single",
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
"name": "fieldBSample",
"apiName": "fieldBSample",
"description": "Content",
"datatype": "largetext",
"required": true,
"valuecount": "single",
"properties": {},
"settings": {}
}
],
"jobToken":"OPC3630DF06AC04F4EB477A62B0EFB47",
"properties": {},
"properties": {
"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
}
}
},
"roleName": "manager",
"archivedFields": {
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/types/TypeSample/archivedFields",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
}
]
},
"links": [
{
"href": "https://<hostname>/content/management/api/v1.1/types/TypeSample",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/types/TypeSample",
"rel": "canonical",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/TypeSample",
"rel": "describedby",
"method": "GET",
"mediaType": "application/schema+json"
}
]
}
例2
これは、archivedFieldsとともにname:TypeSampleという名前のタイプを読み取ります。archivedFieldsは、'all'に置き換えることもできます。
/content/management/api/v1.1/types/TypeSample?expand=archivedFields
レスポンス本文
{
"id": "D103EEB2A5CC42619D7688A62A169092",
"name": "TypeSample",
"apiName": "typeSample",
"description": "",
"typeCategory" : "ContentType",
"allowedFileTypes" : ["ContentItem"],
"createdBy": "cecusername",
"createdDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"updatedBy": "cecusername",
"updatedDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"fields": [
{
"id": "66EA1FD6AE634B1290968AB1C8F606C4",
"name": "fieldASample",
"apiName": "fieldASample",
"description": "Content",
"datatype": "largetext",
"required": false,
"valuecount": "single",
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
"name": "fieldBSample",
"apiName": "fieldBSample",
"description": "Content",
"datatype": "largetext",
"required": true,
"valuecount": "single",
"properties": {},
"settings": {}
}
],
"properties": {},
"roleName": "manager",
"archivedFields": {
"data": [
{
"id": "2383782175B04C7AB62F25E7A606196E",
"name": "Test139004168217008",
"description": "Test139004168251009",
"datatype": "text",
"required": false,
"valuecount": "list",
"properties": {},
"settings": {},
"archivedBy": "cecusername",
"archivedDate": {
"value": "2020-05-01T08:33:11.943Z",
"timezone": "UTC"
}
},
{
"id": "0502F305EDD74CED87CF7ADA4F07D7F8",
"name": "Test139004168280000",
"description": "Test139004168295001",
"datatype": "largetext",
"required": false,
"valuecount": "single",
"properties": {},
"settings": {},
"archivedBy": "cecusername",
"archivedDate": {
"value": "2020-05-01T08:33:11.947Z",
"timezone": "UTC"
}
}
],
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/types/TypeSample/archivedFields",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
}
]
},
"links": [
{
"href": "https://<hostname>/content/management/api/v1.1/types/TypeSample?expand=archivedFields",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/types/TypeSample?expand=archivedFields",
"rel": "canonical",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/TypeSample",
"rel": "describedby",
"method": "GET",
"mediaType": "application/schema+json"
}
]
}
例3
これは、name:DigitalTypeSampleのタイプを読み取ります。
/content/management/api/v1.1/types/DigitalTypeSample
レスポンス本文
{
"id": "D103EEB2A5CC42619D7688A62A169092",
"name": "TypeSample",
"typeCategory" : "DigitalAssetType",
"allowedFileTypes" : ["jpg","jpeg","png"],
"description": "",
"createdBy": "cecusername",
"createdDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"updatedBy": "cecusername",
"updatedDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"fields": [
{
"id": "66EA1FD6AE634B1290968AB1C8F606C4",
"name": "fieldASample",
"description": "Content",
"datatype": "largetext",
"required": false,
"valuecount": "single",
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
"name": "fieldBSample",
"description": "Content",
"datatype": "largetext",
"required": true,
"valuecount": "single",
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
"name": "size",
"description": "size",
"datatype": "number",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE3",
"name": "fileType",
"description": "fileType",
"datatype": "text",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE9",
"name": "fileGroup",
"description": "fileGroup",
"datatype": "text",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE5",
"name": "mimeType",
"description": "mimeType",
"datatype": "text",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE6",
"name": "renditions",
"description": "renditions",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE7",
"name": "metadata",
"description": "metadata",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE8",
"name": "native",
"description": "native",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DA8",
"name": "advancedVideoInfo",
"description": "advancedVideoInfo",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
}
],
"properties": {},
"roleName": "manager",
"archivedFields": {
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/types/DigitalTypeSample/archivedFields",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
}
]
},
"links": [
{
"href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample",
"rel": "canonical",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/DigitalTypeSample",
"rel": "describedby",
"method": "GET",
"mediaType": "application/schema+json"
}
]
}
例4
これは、name:DigitalTypeSampleのタイプをarchivedFieldsとともに読み取ります。archivedFieldsは、'all'に置き換えることもできます。
/content/management/api/v1.1/types/DigitalTypeSample
レスポンス本文
{
"id": "D103EEB2A5CC42619D7688A62A169092",
"name": "DigitalTypeSample",
"description": "",
"typeCategory" : "DigitalAssetType",
"allowedFileTypes" : ["jpg","jpeg","png"],
"createdBy": "cecusername",
"createdDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"updatedBy": "cecusername",
"updatedDate": {
"value": "2018-11-23T10:33:17.270Z",
"timezone": "UTC"
},
"fields": [
{
"id": "66EA1FD6AE634B1290968AB1C8F606C4",
"name": "fieldASample",
"description": "Content",
"datatype": "largetext",
"required": false,
"valuecount": "single",
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
"name": "fieldBSample",
"description": "Content",
"datatype": "largetext",
"required": true,
"valuecount": "single",
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
"name": "size",
"description": "size",
"datatype": "number",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE3",
"name": "fileType",
"description": "fileType",
"datatype": "text",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE9",
"name": "fileGroup",
"description": "fileGroup",
"datatype": "text",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE5",
"name": "mimeType",
"description": "mimeType",
"datatype": "text",
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE6",
"name": "renditions",
"description": "renditions",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE7",
"name": "metadata",
"description": "metadata",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE8",
"name": "native",
"description": "native",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
},
{
"id": "B4E2EA0BBD5E4DD38BA721BEA7E02DA8",
"name": "advancedVideoInfo",
"description": "advancedVideoInfo",
"datatype": "json",
"jsonSchema" : null,
"required": false,
"valuecount": "single",
"isSystemField":true,
"properties": {},
"settings": {}
}
],
"properties": {},
"roleName": "manager",
"archivedFields": {
"data": [
{
"id": "2383782175B04C7AB62F25E7A606196E",
"name": "Test139004168217008",
"description": "Test139004168251009",
"datatype": "text",
"required": false,
"valuecount": "list",
"properties": {},
"settings": {},
"archivedBy": "cecusername",
"archivedDate": {
"value": "2020-05-01T08:33:11.943Z",
"timezone": "UTC"
}
},
{
"id": "0502F305EDD74CED87CF7ADA4F07D7F8",
"name": "Test139004168280000",
"description": "Test139004168295001",
"datatype": "largetext",
"required": false,
"valuecount": "single",
"properties": {},
"settings": {},
"archivedBy": "cecusername",
"archivedDate": {
"value": "2020-05-01T08:33:11.947Z",
"timezone": "UTC"
}
}
],
"links": [
{
"href": "http://<hostname>/content/management/api/v1.1/types/DigitalTypeSample/archivedFields",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
}
]
},
"links": [
{
"href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample?expand=archivedFields",
"rel": "self",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample?expand=archivedFields",
"rel": "canonical",
"method": "GET",
"mediaType": "application/json"
},
{
"href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/DigitalTypeSample",
"rel": "describedby",
"method": "GET",
"mediaType": "application/schema+json"
}
]
}
}
]
}