スケジュールされたメッセージを更新する
スケジュールされたメッセージを更新するには、このエンドポイントを使う。
このエンドポイントは、schedule
または messages
パラメーターのいずれか、あるいはその両方に対する更新を受け入れます。リクエストには、これら 2 つのキーのうち、少なくとも 1 つが含まれている必要があります。
前提条件
このエンドポイントを使用するには、API キーとmessages.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
8
9
{
"schedule_id": (required, string) the `schedule_id` to update (obtained from the response to create schedule),
"schedule": {
// optional, see create schedule documentation
},
"messages": {
// optional, see available messaging objects documentation
}
}
リクエストパラメーター
パラメータ | 必須 | データ型 | 説明 |
---|---|---|---|
schedule_id |
必須 | 文字列 | 更新するschedule_id (スケジュール作成のレスポンスから取得)。 |
schedule |
オプション | オブジェクト | スケジュールオブジェクトを参照してください。 |
messages |
オプション | オブジェクト | 利用可能なメッセージングオブジェクトを参照してください。 |
例のリクエスト
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
curl --location --request POST 'https://rest.iad-01.braze.com/messages/schedule/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
"schedule_id": "schedule_identifier",
"schedule": {
"time": "2017-05-24T20:30:36Z"
},
"messages": {
"apple_push": {
"alert": "Updated Message!",
"badge": 1
},
"android_push": {
"title": "Updated title!",
"alert": "Updated message!"
},
"sms": {
"subscription_group_id": "subscription_group_identifier",
"message_variation_id": "message_variation_identifier",
"body": "This is my SMS body.",
"app_id": "app_identifier"
}
}
}'
New Stuff!