機械翻訳について

タイプの作成

post

/content/management/api/v1.1/types

指定されたペイロードでタイプを作成します。

リクエスト

サポートされているメディア・タイプ
問合せパラメータ
ヘッダー・パラメータ
本文()
ペイロード内に指定の情報でタイプを作成します。 型の名前は、大/小文字が区別されません、つまり、既存の型名を使用した型は作成できません。 ペイロード内に指定されている場合でも、id, createdBy, createdDate, updatedBy, updatedDateおよびlinksフィールドは無視されます。
ルート・スキーマ : タイプ
型: object
AggregatedType
ソースを表示
ネストされたスキーマ : allowedActions
型: array
タイプのallowedActions。
ソースを表示
ネストされたスキーマ : allowedFileTypes
型: array
タイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
ソースを表示
ネストされたスキーマ : ItemSubResourceListTypeField
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : connectorInfos
型: array
タイプのconnectorInfos。
ソースを表示
ネストされたスキーマ : date
型: object
date
ソースを表示
ネストされたスキーマ: fields
型: array
タイプで使用されるフィールド。
ソースを表示
ネストされたスキーマ : ItemSubResourceListInplacePreview
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListLayoutMapping
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ: properties
型: object
使用可能なその他のプロパティ
ソースを表示
特定のプロパティを入力します。
ネストされたスキーマ : ItemSubResourceTypeRelationships
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListRequiredTaxonomy
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : TypeField
型: object
FieldInAggrType.
ソースを表示
ネストされたスキーマ : defaultValue
型: object
フィールドのdefaultValue。
ネストされたスキーマ: properties
型: object
使用可能なその他のプロパティ
ソースを表示
フィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
例:
{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}
ネストされたスキーマ : settings
型: object
使用可能なその他のプロパティ
ソースを表示
フィールド固有の設定。
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ : ConnectorInfo
型: object
ConnectorInfo
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : InplacePreview
型: object
InplacePreview
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : LayoutMapping
型: object
LayoutMapping
ソースを表示
ネストされたスキーマ: formats
型: object
使用可能なその他のプロパティ
ソースを表示
レイアウト形式。
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ : TypeRelationships
型: object
タイプ関連
ソースを表示
ネストされたスキーマ : references
型: array
一意のアイテムが必要: true
参照タイプ名/ID
ソースを表示
ネストされたスキーマ : TypeReferences
型: object
型参照Bean
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : RequiredTaxonomy
型: object
ソースを表示
ネストされたスキーマ : defaultCategories
型: array
ソースを表示
ネストされたスキーマ : カテゴリ
型: object
ソースを表示
トップに戻る

レスポンス

サポートされているメディア・タイプ

201レスポンス

作成されました。
本文()
ルート・スキーマ : タイプ
型: object
AggregatedType
ソースを表示
ネストされたスキーマ : allowedActions
型: array
タイプのallowedActions。
ソースを表示
ネストされたスキーマ : allowedFileTypes
型: array
タイプでサポートされているファイル拡張子の許可されたリスト。 これはレスポンス取得の必須プロパティです。 ポスト/プット・リクエストではオプションで、typeCategoryがContentTypeの場合は[ContentItem]にデフォルト設定され、typeCategoryがDigitalAssetTypeの場合は空にデフォルト設定されます。
ソースを表示
ネストされたスキーマ : ItemSubResourceListTypeField
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : connectorInfos
型: array
タイプのconnectorInfos。
ソースを表示
ネストされたスキーマ : date
型: object
date
ソースを表示
ネストされたスキーマ: fields
型: array
タイプで使用されるフィールド。
ソースを表示
ネストされたスキーマ : ItemSubResourceListInplacePreview
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListLayoutMapping
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ: properties
型: object
使用可能なその他のプロパティ
ソースを表示
特定のプロパティを入力します。
ネストされたスキーマ : ItemSubResourceTypeRelationships
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ : ItemSubResourceListRequiredTaxonomy
型: object
アイテムSubResource。
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : TypeField
型: object
FieldInAggrType.
ソースを表示
ネストされたスキーマ : defaultValue
型: object
フィールドのdefaultValue。
ネストされたスキーマ: properties
型: object
使用可能なその他のプロパティ
ソースを表示
フィールド固有のプロパティ。 publishingDependencyフィールドは、メディアおよび参照に固有です。
例:
{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}
ネストされたスキーマ : settings
型: object
使用可能なその他のプロパティ
ソースを表示
フィールド固有の設定。
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ : ConnectorInfo
型: object
ConnectorInfo
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : InplacePreview
型: object
InplacePreview
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : LayoutMapping
型: object
LayoutMapping
ソースを表示
ネストされたスキーマ: formats
型: object
使用可能なその他のプロパティ
ソースを表示
レイアウト形式。
ネストされたスキーマ: additionalProperties
型: object
ネストされたスキーマ : TypeRelationships
型: object
タイプ関連
ソースを表示
ネストされたスキーマ : references
型: array
一意のアイテムが必要: true
参照タイプ名/ID
ソースを表示
ネストされたスキーマ : TypeReferences
型: object
型参照Bean
ソースを表示
ネストされたスキーマ: data
型: array
ソースを表示
ネストされたスキーマ : RequiredTaxonomy
型: object
ソースを表示
ネストされたスキーマ : defaultCategories
型: array
ソースを表示
ネストされたスキーマ : カテゴリ
型: object
ソースを表示

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"
      }
    ]
  }
}
先頭に戻る