예약된 API 트리거 캠페인 업데이트

이 엔드포인트를 사용하여 대시보드에서 생성된 예약된 API 트리거 캠페인을 업데이트하고, 메시지 전송을 트리거할 동작을 결정할 수 있습니다.

메시지 자체에 Braze 템플릿으로 사용할 trigger_properties를 전달할 수 있습니다.

이 엔드포인트로 메시지를 보내려면 API 트리거 Campaign을 구축할 때 생성된 Campaign ID가 있어야 합니다.

모든 스케줄은 스케줄 생성 요청 또는 이전 스케줄 업데이트 요청에서 제공한 스케줄을 완전히 덮어씁니다. 예를 들어, 원래 스케줄을 "schedule" : {"time" : "2015-02-20T13:14:47", "in_local_time" : true}로 설정했다가 나중에 "schedule" : {"time" : "2015-02-20T14:14:47"}로 업데이트하면, Braze는 사용자의 현지 시간이 아닌 UTC 기준 지정된 시간에 메시지를 보냅니다.

예약된 트리거가 전송 예정 시간에 가까워지거나 해당 시간에 업데이트되는 경우, Braze는 타겟팅된 사용자 전체, 일부 또는 아무에게도 마지막 변경 사항을 적용하지 못할 수 있으며, 최선을 다해 업데이트를 적용합니다. 원래 스케줄이 현지 시간을 사용했고 어떤 시간대에서든 원래 시간이 이미 지난 경우에는 업데이트가 적용되지 않습니다.

필수 조건

이 엔드포인트를 사용하려면 campaigns.trigger.schedule.update 권한이 있는 API 키가 필요합니다.

사용량 제한

이 엔드포인트에는 API 사용량 제한 설명서에 명시된 대로 기본 Braze 사용량 제한인 시간당 250,000건의 요청이 적용됩니다.

요청 본문

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
4
5
6
7
{
  "campaign_id": (required, string) see campaign identifier,
  "schedule_id": (required, string) the `schedule_id` to update (obtained from the response to create schedule),
  "schedule": {
    // required, see create schedule documentation
  }
}

요청 매개변수

요청 예시

1
2
3
4
5
6
7
8
9
10
11
curl --location --request POST 'https://rest.iad-01.braze.com/campaigns/trigger/schedule/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "campaign_id": "campaign_identifier",
  "schedule_id": "schedule_identifier",
  "schedule": {
    "time": "2017-05-24T21:30:00Z",
    "in_local_time": true
  }
}'