Skip to content

スケジュールされたAPIトリガーキャンバスを更新する

post

/canvas/trigger/schedule/update

このエンドポイントを使用して、ダッシュボードで作成されたスケジュール済みAPIトリガーキャンバスを更新する。

これにより、メッセージ送信をトリガーするアクションを決定できます。メッセージ自体にテンプレート化される trigger_properties を渡すことができます。

このエンドポイントを使用してメッセージを送信するには、キャンバスを構築するときに作成されたキャンバスIDが必要であることに注意してほしい。

どのスケジュールも、スケジュール作成リクエストや以前のスケジュール更新リクエストで提供したものを完全に上書きする。

  • 例えば、最初に"schedule" : {"time" : "2015-02-20T13:14:47", "in_local_time" : true} を指定し、更新時に"schedule" : {"time" : "2015-02-20T14:14:47"} を指定した場合、メッセージはユーザーのローカル時間ではなく、UTCで指定された時間に送信されるようになる。
  • 送信予定時刻に非常に近いか、送信予定時刻に更新されたスケジュールされたトリガーは、ベストエフォートで更新されます。このため、直前の変更は、ターゲットユーザーの全員または一部に適用されるか、あるいはまったく適用されない可能性があります。

前提条件

このエンドポイントを使用するには、API キーcanvas.trigger.schedule.updateの権限が必要です。

レート制限

API レート制限で説明されているように、このエンドポイントにはデフォルトの1時間あたり25万リクエストのBraze レート 制限が適用されます。

要求本文:

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
5
6
7
{
  "canvas_id": (required, string) see Canvas identifier,
  "schedule_id": (required, string) the `schedule_id` to update (obtained from the response to create schedule),
  "schedule": {
    // required, see create schedule documentation
  }
}

リクエストパラメーター

パラメータ 必須 データ型 説明
canvas_id 必須 文字列 キャンバス識別子を参照してください。
schedule_id オプション 文字列 更新するschedule_id (スケジュール作成のレスポンスから取得)。
schedule 必須 オブジェクト スケジュールオブジェクトを参照してください。

例のリクエスト

1
2
3
4
5
6
7
8
9
10
11
curl --location --request POST 'https://rest.iad-01.braze.com/canvas/trigger/schedule/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "canvas_id": "canvas_identifier",
  "schedule_id": "schedule_identifier",
  "schedule": {
    "time": "2017-05-24T21:30:00Z",
    "in_local_time": true
  }
}'
「このページはどの程度役に立ちましたか?」
New Stuff!