Content Type

Content Type はコンテンツが従うひな形(スキーマ)です。どのフィールドを持ち、各フィールドがどのタイプ・多言語対応の有無・必須の有無・バリデーションルールを持つかを定義します。アパレルショッピングモールの「商品」を例にとると、商品名・価格・詳細説明・代表写真といった項目構成を Content Type 「商品」1つが規定し、実際の個々の商品はこのひな形に従う Content として作成されます。

CMA において Content Type は Space の下位リソースであり、パスは /spaces/{spaceId}/content-types を基準とします。作成・更新・公開取り消しといった管理操作は CMA で実行し、公開されたスナップショットは CDA へ配信されます。ただし Content Type は作成・更新時に自動的に公開されるため、Content とは異なり、別途の公開呼び出しなしにただちに Published 状態になります(下記 状態と自動公開 を参照)。

リソース構造

以下は Content Type 「商品」の単一取得レスポンスです。sys(システムプロパティ)とともに、name、displayField、publishWithAuthor、fields といった本体プロパティを持ちます。

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA",
    "type": "ContentType",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "publish": {
      "version": 7,
      "at": "2026-06-17T03:13:49.973Z",
      "firstAt": "2026-06-14T17:04:46.953Z",
      "counter": 4,
      "by": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } }
    },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T17:04:46.846Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-17T03:13:49.973Z",
    "version": 8,
    "status": "Published"
  },
  "name": "商品",
  "displayField": "productName",
  "publishWithAuthor": false,
  "fields": [
    { "id": "5n06s7ocmwdi", "name": "商品名", "apiName": "productName", "type": "ShortText", "localized": true, "required": true, "validations": [], "disabled": false },
    { "id": "1gecyz8g4llwf", "name": "価格", "apiName": "price", "type": "Long", "localized": false, "required": false, "validations": [], "disabled": false },
    { "id": "3ow4popgz54zg", "name": "詳細説明", "apiName": "description", "type": "RichText", "localized": true, "required": false, "validations": [], "disabled": false },
    { "id": "2alxdptmdub1s", "name": "代表写真", "apiName": "photo", "type": "Refer", "localized": false, "required": false, "validations": [], "disabled": false, "targetType": "Media" },
    {
      "id": "2a80lehazfx3t",
      "name": "ブランド",
      "apiName": "brand",
      "type": "Refer",
      "localized": false,
      "required": false,
      "validations": [
        { "referContentType": [ { "sys": { "id": "3trmXRM3RqbgSnifyg7OveRYWnJWEG", "type": "Refer", "targetType": "ContentType" } } ] }
      ],
      "disabled": false,
      "targetType": "Content"
    }
  ]
}

主なキー:

• sys.id: Content Type の一意な識別子です。単一取得・更新・削除パスの {contentTypeId} に入ります。
• name: Content Type の名前です(例: 商品)。
• displayField: コンテンツスタジオの一覧で各 Content を代表して表示するフィールドの apiName です(例: productName)。
• publishWithAuthor: Content を公開する際、公開スナップショットに作成者情報(sys.createdBy・sys.updatedBy)を一緒に格納するかどうかです。デフォルト値は false で、この場合 CDA/ACDA へ配信されるスナップショットには作成者が格納されません。この値は公開時点で適用され、遡及しないため、後で true に変更しても、すでに公開された Content は再度公開しなければ作成者が埋め込まれません。管理 API(CMA/ACMA)が扱う下書きには、この設定とは無関係に sys.createdBy があります。配信レスポンスに作成者(byline)を表示したり、権限ルールの createdBy フィルター(:self を含む)を CDA/ACDA で判定したりするには、この値を true にしておく必要があります(SpaceRole・ServiceUserRoleの createdBy フィルターの説明を参照)。
• fields: このひな形が定義するフィールドの一覧です。各項目の構造は下記 フィールド で説明します。

photo フィールドは type が Refer で targetType が Media であるため、アップロードしたファイルアセットを指します。brand フィールドは Refer + targetType: Content であり、validations の referContentType によって特定の Content Type(ここでは「ブランド」)の Content のみを参照するよう制限します。

システムプロパティ (sys)

すべての Content Type は、共通のシステムプロパティと Content Type 固有のプロパティを sys オブジェクトに格納します。space、createdBy、updatedBy は Refer の形({ "sys": { "id", "type": "Refer", "targetType" } })で入ります。

publish オブジェクトのキー:

公開を取り消す(DELETE .../publish)と、publish から version、at、by が削除され、firstAt、counter のみが残ります。

Content Type の sys には、Content の sys にある contentType(自己参照)プロパティがありません。Content Type 自体がひな形だからです。archive プロパティもありません。

フィールド

fields は、この Content Type が定義するフィールドの一覧です。各項目は次の構造(FieldDefinition)を持ちます。

フィールドの種類 (type)

type は、値が保存・取得される方法を決定します。一部のタイプは検索の動作が異なります。

「商品」の例では、商品名 は ShortText、価格 は Long、詳細説明 は RichText、代表写真 は Refer(targetType: Media)、ブランド は Refer(targetType: Content)です。

値の制限はタイプが定めるプラットフォーム上限であり、Content Type を作成するときではなく、Content に値を書き込むときに検査されます。validations の size でこれより大きい上限を指定しても、プラットフォーム上限が先にかかります。Array の要素には要素タイプの同じ制限がそのまま適用されるため、items.type が ShortText の配列は、要素の1つ1つが64文字を超えられません。制限を超えた値で Content を書き込むと拒否され、そのコードは Content のエラー にあります。

バリデーション (validations)

validations は、フィールド値に適用するルールの配列です。各項目は次のキーのいずれかを格納します。

mediaMimetypeGroup に使用できる値(12種): Attachment、Plaintext、Image、Audio、Video、RichText、Presentation、Spreadsheet、PdfDocument、Archive、Code、Markup。

「商品」の例の brand フィールドは、referContentType によって「ブランド」Content Type(sys.id が 3trmXRM3RqbgSnifyg7OveRYWnJWEG)のみを参照するよう制限します。

状態と自動公開

Content Type は作成・更新・部分更新時に自動的に公開されます。この点が Content と異なります。Content は作成後に別途の公開呼び出しがあって初めて配信経路に乗りますが、Content Type は作成レスポンスがただちに status: "Published" で返ります。

status は次の4つのいずれかです。

sys.version はすべての変更で1ずつ増加します。Content Type は更新と公開が一度に発生するため、1回の更新で version が2上がります(更新自体 +1、自動公開 +1)。例の「お知らせ」では、作成直後の version は2(作成 +1、自動公開 +1)で、publish.counter は1です。続いて更新すると version は4になり、publish.counter は2になります。

Content Type が Draft になる唯一の経路は、明示的な公開取り消し(DELETE .../publish)です。公開を取り消すと status が Draft になり、publish オブジェクトから version・at・by が抜け、firstAt・counter のみが残ります。

制約

削除ガード: 削除は次の2つの条件をすべて満たす必要があります。

• この Content Type を使う Content が1つでもあると削除できません。先に該当する Content をすべて削除してください。この検査が最初にかかります。
• 公開状態(Published・Changed)の Content Type はそのまま削除できません。先に公開を取り消して(DELETE .../publish)Draft にしてから削除してください(Archived 状態も削除可能)。

エラー

Content Type を扱うときに出会うコードです。すべてのリソースに共通するコードは 共通エラー を参照してください。

API

以下のすべてのエンドポイントの基準 URL は https://cma.weegloo.com/v1 であり、Authorization ヘッダーに CMA を認証する Bearer トークンが必要です。更新・部分更新・公開・公開取り消しは、楽観的同時実行制御のために X-Weegloo-Version ヘッダー(現在のリソースの sys.version)を一緒に送る必要があります。

関連ドキュメント

• Content モデリング: Content Type をコンテンツスタジオで作成する方法。
• 状態と公開: 公開・バージョンの意味。