문서로 건너뛰기
API

오디언스에서 연락처 일괄 제거

주소를 기준으로 한 번의 호출에 최대 200개의 연락처를 한 오디언스에서 뺍니다. 모두 주소록, 기본 오디언스, 원래 속해 있던 다른 모든 오디언스에 그대로 남습니다.

POSTapi.openemail.uk/audiences/{id}/contacts/batch-remove

본인 키로 워크스페이스에 실제 호출을 실행합니다.

POST /audiences/{id}/contacts/batch-remove

주소를 기준으로 한 번의 호출에 최대 200개의 연락처를 한 오디언스에서 뺍니다. 모두 주소록, 기본 오디언스, 원래 속해 있던 다른 모든 오디언스에 그대로 남습니다.

예시

audiences:write가 필요합니다. 본문은 일괄 추가와 같은 형태로, 1~200개의 주소를 담은 emails입니다.

curl
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch-remove" -H "$AUTH" -H 'content-type: application/json' -d '{  "emails": ["[email protected]", "[email protected]", "[email protected]"]}'
응답
{  "object": "audience_batch",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "removed": 1,  "notInAudience": ["[email protected]"],  "missing": ["[email protected]"]}

removed는 뺀 멤버십을 세고, notInAudience는 이 오디언스에 없던 연락처를, missing은 아예 연락처가 아닌 주소를 나열합니다. 두 목록 모두 아무 일도 일어나지 않으므로, 이 호출은 다시 실행해도 안전합니다.

기본 제공 기본 오디언스는 줄일 수 없습니다. 호출은 409 audience_immutable로 거부되고 아무것도 제거되지 않습니다. 연락처 자체를 없애려면 연락처를 삭제하세요.