Skip to main content

概要

参照ツールでは、メッセージ・ページ・レッスンの作成/更新時に指定する要素タイプやメッセージタイプ、配信条件の定義を取得できます。element_types_mail でHTMLメールの要素タイプ、element_types_lesson でレッスンの要素タイプ、message_types_line でLINEメッセージタイプ、message_condition_types で配信条件・読者絞り込みの条件キーを参照し、各ツールの elements / messages / conditions パラメータを組み立てる際の手がかりにします(ファネルページの要素タイプ element_types_funnel / element_types_funnel_properties は ファネルツール にあります)。このほか、管理画面で設定した連携(Googleスプレッドシート連携アカウント・広告連携設定)の一覧を取得する連携ツールを掲載しています。 要素タイプ・メッセージタイプ・配信条件の参照定義は、REST のエンドポイントであればAPIキー無しで呼び出せます。MCP ではどのツールも接続時の認証(APIキー)を前提とし、連携ツール(google_spreadsheet_account_list / ads_setting_list)が呼び出す REST エンドポイントもAPIキーが必要です。

HTMLメール要素リファレンス

element_types_mail

HTMLメールの要素タイプ一覧を取得します。デフォルトは基本カテゴリ(layout, content)のみを返す軽量レスポンスです。 パラメータ: includeの値:
ファネル用の payment / event などのカテゴリはHTMLメールには存在しません。HTMLメールで指定できる拡張カテゴリは template のみです。
指示例:
  • 「HTMLメールで使える要素の種類を見せて」
  • 「テンプレート要素も含めて取得して」

element_types_mail_properties

指定したHTMLメール要素タイプのプロパティ定義を取得します。要素に設定可能なプロパティ(色・サイズ・配置等)の詳細仕様を返します。 パラメータ:
レスポンス構造:
レスポンスは各プロパティを properties 配列にメタ情報付きで返しますが、これは「そのタイプに存在するプロパティの一覧」です。実際にメッセージ作成・更新で elements を指定する際は、properties キーで包まず各プロパティをフラットに記述してください(properties キーなど定義に無いプロパティを付けるとエラー(validation_error)になります)。
指示例:
  • 「メールのボタン要素で設定できるプロパティを教えて」
  • 「テキスト要素と画像要素のプロパティ定義を取得して」

LINE・配信条件リファレンス

message_types_line

LINEメッセージの作成・更新時に使用可能なメッセージタイプとパラメータ定義を取得します。テキスト・スタンプ・画像・イメージマップ・ボタン・カルーセル・音声・動画の8タイプの定義と、ボタン/カルーセルで使えるアクションタイプの定義(ボタンを押した際に実行するアクションをメッセージ・テンプレートの中で直接作る action_details を含む)を含みます。 パラメータ: なし レスポンス構造: 指示例:
  • 「LINEメッセージで使えるタイプを教えて」
  • 「カルーセルのボタンに設定できるアクションを確認したい」

message_condition_types

配信条件・読者絞り込みで使用可能な条件キー・演算子・値の型を取得します。メッセージ作成/更新の conditions パラメータや、読者一覧の conditions パラメータを組み立てる際に参照します。 パラメータ: なし レスポンス構造: 各条件キーには利用可能な場面(available_in)が含まれます。delivery は配信条件、reader は読者一覧で使用可能です。base_datetime は配信条件専用で、読者一覧では使用できません。 指示例:
  • 「配信条件に使える項目を教えて」
  • 「ラベルで絞り込む条件の書き方を知りたい」

レッスン要素リファレンス

element_types_lesson

会員サイトのレッスン(コンテンツエディター)で使える要素タイプの一覧を取得します。レッスンの要素はレイアウト要素(layout: section / row / col)とコンテンツ要素(content)だけで、拡張カテゴリはありません。ファネルページとは使える要素・プロパティが異なるため(memo はレッスン専用、登録フォーム・決済などの要素は使えません)、member_lesson_create / member_lesson_update の前にこちらを参照してください。 パラメータ: なし 指示例:
  • 「レッスンで使える要素の種類を見せて」
  • 「レッスンにメモ欄を置けるか確認して」

element_types_lesson_properties

指定したレッスン要素タイプのプロパティ定義を取得します。要素に設定可能なプロパティ(色・サイズ・配置等)の詳細仕様を返します。 パラメータ:
レスポンス構造:
レスポンスは各プロパティを properties 配列にメタ情報付きで返しますが、これは「そのタイプに存在するプロパティの一覧」です。実際に member_lesson_create / member_lesson_update で elements を指定する際は、properties キーで包まず各プロパティをフラットに記述してください。定義に無いプロパティはエラー(validation_error)になります。
指示例:
  • 「レッスンの動画要素で設定できるプロパティを教えて」
  • 「メモ要素とボタン要素のプロパティ定義を取得して」

連携

管理画面で連携したアカウント・登録した連携設定の一覧を取得します。他のツールで指定するID(spreadsheet_account_id・ads_setting_id・ads_event)の取得元です。連携の追加・変更・解除は管理画面で行います。

google_spreadsheet_account_list

Googleスプレッドシート連携アカウント(管理画面のアクション設定「Googleスプレッドシートへ追記」で連携したGoogleアカウント)の一覧を取得します。ファネルアクション・配信アクションの google_spreadsheet の動作、および配信メッセージ・LINEテンプレートの action_details に指定する spreadsheet_account_id の取得元です。Googleスプレッドシート連携が無効な環境ではエラー(bad_request)になります。 パラメータ: なし 指示例:
  • 「Googleスプレッドシート連携アカウントの一覧を見せて」
  • 「スプレッドシートに追記するアクションで使えるGoogleアカウントを確認して」

ads_setting_list

広告連携設定(管理画面「広告連携設定」で登録したMeta広告・Google広告の連携設定)の一覧を取得します。type は meta(Meta広告)/ google(Google広告)です。登録経路の作成・更新(message_tracking_create / message_tracking_update)の ads_setting_id と、ads_event(各設定の events の value から選ぶ。Meta広告は固定のイベント名、Google広告は登録済みのコンバージョンアクション)の取得元です。 パラメータ: なし 指示例:
  • 「広告連携設定の一覧を見せて」
  • 「Google広告の連携設定で指定できるイベントを確認して」