Skip to content

ユーザーのサブスクリプショングループステータスの更新

post

/subscription/status/set

このエンドポイントを使用して、Braze ダッシュボード上で最大50ユーザーのサブスクリプション状態を一括更新します。

サブスクリプショングループのsubscription_group_id にアクセスするには、サブスクリプショングループ ページに移動します。

例を見たり、このエンドポイントをテストしたりする場合は、メールサブスクリプショングループをご覧ください。

SMSサブスクリプショングループ用のこのエンドポイントをテストするか例を見たい場合:

前提条件

このエンドポイントを使用するには、API キーsubscription.status.setの権限が必要です。

レート制限

このエンドポイントには、API レート制限に記載されているように、/subscription/status/set および /v2/subscription/status/set エンドポイントで共有される1分あたり5000リクエストのレート制限があります。

要求本文:

* SMSサブスクリプショングループ:external_id またはphone のみが受け入れられます。

* 電子メールサブスクリプショングループ:email またはexternal_id のいずれかが必要です。

このプロパティは、ユーザーのプロファイル情報の更新には使用しないでください。代わりに、/users/trackプロパティを使用します。

リクエストパラメーター

パラメーター required データ型 説明
subscription_group_id 必須 文字列 サブスクリプショングループのid
subscription_state 必須 文字列 使用できる値は、unsubscribed (サブスクリプショングループに含まれない) または subscribed (サブスクリプショングループに含まれる) です。
external_id 必須* 文字列の配列 ユーザーの external_id には、最大で 50 個の id を含めることができます。
email 必須* 文字列または文字列の配列 ユーザーのメールアドレスは、文字列の配列として渡すことができます。少なくとも 1 件のメールアドレス (最大 50件 まで) を含める必要があります。

同じワークスペース内の複数のユーザー (external_id) が同じメールアドレスを共有している場合、そのメールアドレスを共有するすべてのユーザーは、サブスクリプショングループの変更で更新されます。
phone 必須* E.164 形式の文字列 ユーザーの電話番号は文字列の配列として渡すことができます。少なくとも1つの電話番号を含むこと(50件まで)。

同じワークスペース内の複数のユーザー(external_id)が同じ電話番号を共有している場合、電話番号を共有しているすべてのユーザーが同じサブスクリプショングループの変更で更新される。

例のリクエスト

メール

SMS

成功応答の例

ステータスコード 201 は、次の応答本文を返す可能性があります。

「このページはどの程度役に立ちましたか?」
New Stuff!