読者更新
読者
読者更新
プレビュー機能。仕様は今後変更される可能性があります。 読者を部分更新します。リクエストに含めたフィールドのみ変更し、省略したフィールドは既存値を維持します。
scenario_fields / common_fields はいずれも指定したキーのみ更新します。common_fields の更新は同一人物の全シナリオに波及します。
読者更新
PATCH
この機能はプレビュー版です。仕様が変更される場合があります。
Authorizations
APIキーをBearerトークンとして指定
Path Parameters
アカウントID
シナリオID
読者ID
Body
application/json
シナリオ固有の読者項目(キー=項目名、値=文字列)。指定したキーのみ更新
全シナリオ共通の読者項目(キー=項目名、値=文字列)。指定したキーのみ更新。更新すると同一人物の全シナリオに波及する
メモ(全シナリオ共通の読者データ)
配信基準日時(Y-m-d または Y-m-d H:i:s)。日付形式が厳密に検証され、不正な値(例: 2026-02-30, tomorrow)は422になります
ステップ配信の対象にする
リマインダ配信の対象にする
シナリオ登録経路ID。空文字を指定するとnullに更新(該当シナリオが所有するものに限る)
ファネル登録経路ID。空文字を指定するとnullに更新(所有チェックあり)
Response
更新された読者
読者の詳細情報。読者項目はトップレベルではなく scenario_fields(シナリオ固有)/ common_fields(全シナリオ共通)の2グループで返る。トップレベルはシステム情報のみ。