Scheduleオブジェクト

キャンペーンとキャンバスのスケジュール作成エンドポイントのパラメータは、送信エンドポイントのパラメータを反映し、ターゲットユーザーにいつメッセージを受信させたいかを指定できるschedule パラメータを追加する。schedule オブジェクトにtime パラメータだけを含めると、Brazeはその時点ですべてのユーザーにメッセージングを行う。

in_local_time をtrue に設定した場合、すべてのタイムゾーンでtimeパラメータがパスした場合、エラー・レスポンスが返ってくる。at_optimal_time をtrueに設定すると、ユーザーは指定した日付の最適な時間にメッセージを受け取る（あなたが指定した時間に関係なく）。ローカル時間または最適時間送信を使用する場合、時間パラメータの値にタイムゾーン指定子を指定しない（例えば、"2015-02-20T13:14:47-05:00" の代わりに"2015-02-20T13:14:47" を使用する）。

このレスポンシブには、schedule_id 、スケジュールしたメッセージのキャンセルや更新が必要になったときのために保存しておく必要がある：

オブジェクト本体

このオブジェクトを必要に応じて挿入し、メッセージのスケジューリングを行う。

1
2
3
4
5
"schedule": {
  "time": (required, datetime as ISO 8601 string) time to send the message in UTC,
  "in_local_time": (optional, bool),
  "at_optimal_time": (optional, bool),
}

スケジュール ID の応答

作成したスケジュールされたメッセージのschedule_id 。

1
2
3
{
  "schedule_id" : (required, string) identifier for the scheduled message you created
}

サーバー間の呼び出しに API を使用する場合、ファイアウォールの内側にある場合は、適切な API URL を許可リストに追加する必要が生じることがあります。

メッセージスケジューリングエンドポイントのレスポンスには、メッセージのディスパッチに参照するためのメッセージのdispatch_id 。dispatch_id は、メッセージディスパッチの ID です (Braze から送信される「送信」ごとに固有の ID）。