Skip to content

スケジュールされたメッセージを更新する

post

/messages/schedule/update

スケジュールされたメッセージを更新するには、このエンドポイントを使う。

このエンドポイントは、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!