Skip to content

사용자의 구독 그룹 상태 업데이트(V2)

post

/v2/subscription/status/set

이 엔드포인트를 사용하여 Braze 대시보드에서 최대 50명의 사용자의 구독 상태를 일괄 업데이트할 수 있습니다.

구독 그룹 페이지로 이동하여 구독 그룹의 subscription_group_id에 액세스할 수 있습니다.

이메일 구독 그룹에 대한 예제를 확인하거나 이 엔드포인트를 테스트하려면:

See me in Postman

SMS 구독 그룹에 대한 예제를 확인하거나 이 엔드포인트를 테스트하려면:

See me in Postman

WhatsApp 그룹에 대한 예제를 확인하거나 이 엔드포인트를 테스트하려면:

See me in Postman

필수 조건

이 엔드포인트를 사용하려면 subscription.status.set 권한이 있는 API 키가 필요합니다.

V1과의 차이점

V2 엔드포인트는 다음과 같은 점에서 V1 엔드포인트와 다릅니다:

  • 여러 구독 그룹: V2에서는 단일 API 요청으로 여러 구독 그룹을 업데이트할 수 있지만, V1은 요청당 하나의 구독 그룹만 지원합니다.
  • 이메일과 SMS를 한 번의 호출로 업데이트: external_ids를 사용하면 동일한 사용자에 대해 이메일 및 SMS 구독 그룹을 단일 API 호출로 업데이트할 수 있습니다. V1에서는 이메일 및 SMS 구독 그룹에 대해 별도의 API 호출을 해야 합니다.
  • 이메일 또는 전화번호 식별자 사용: external_ids 대신 emails 또는 phones를 사용하면 동일한 요청에서 이메일 및 SMS 구독 그룹을 함께 업데이트할 수 없습니다. 이메일 구독 그룹과 SMS 구독 그룹 각각에 대해 별도의 API 호출을 해야 합니다.

사용량 제한

이 엔드포인트는 API 사용량 제한 설명서에 명시된 바와 같이 /subscription/status/set 및 /v2/subscription/status/set 엔드포인트 간에 공유되는 분당 5,000건의 요청 사용량 제한이 적용됩니다.

요청 본문

1
2

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

1
2
3
4
5
6
7
8
9
10
11
12

{
  "subscription_groups":[
    {
      "subscription_group_id": (required, string),
      "subscription_state": (required, string),
      "external_ids": (required*, array of strings),
      "emails": (required*, array of strings),
      "phones": (required*, array of strings in E.164 format),
      "use_double_opt_in_logic": (optional, boolean)
    }
  ]
}

요청 매개변수

요청 예시

다음 예시에서는 external_ids를 사용하여 단일 API 호출로 이메일 및 SMS 구독 그룹을 업데이트합니다. 이는 external_ids를 사용할 때만 가능하며, emails 또는 phones를 사용할 때는 이메일 및 SMS 구독 그룹을 한 번의 호출로 업데이트할 수 없습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","[email protected]"]
    },
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","[email protected]"]
    }
  ]
}

이메일

1
2
3
4
5
6
7
8
9
10
11
12
13

curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "emails":["[email protected]","[email protected]"]
    }
  ]
}
'

SMS 및 WhatsApp

1
2
3
4
5
6
7
8
9
10
11
12
13

curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "phones":["+12223334444","+15556667777"]
    }
  ]
}
'
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!