오디언스에 연락처 일괄 추가
주소를 기준으로 한 번의 호출에 최대 200개의 연락처를 한 오디언스에 넣습니다. 단건 추가와 마찬가지로 워크스페이스 주소록에 이미 있는 주소만 받고 연락처를 새로 만들지 않습니다. 연락처가 아닌 주소는 `missing`으로 돌아오고 그 주소에 대해서는 아무것도 쓰지 않지만, 호출의 나머지는 그대로 처리됩니다.
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /audiences/{id}/contacts/batch
주소를 기준으로 한 번의 호출에 최대 200개의 연락처를 한 오디언스에 넣습니다. 단건 추가와 마찬가지로 워크스페이스 주소록에 이미 있는 주소만 받고 연락처를 새로 만들지 않습니다. 연락처가 아닌 주소는 missing으로 돌아오고 그 주소에 대해서는 아무것도 쓰지 않지만, 호출의 나머지는 그대로 처리됩니다.
예시
audiences:write가 필요합니다. emails에는 1~200개의 주소를 넣으며, 대조하기 전에 앞뒤 공백을 없애고 소문자로 바꿉니다.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "added": 1, "unchanged": 1, "missing": ["[email protected]"]}added는 새 멤버십을, unchanged는 이미 오디언스에 있던 연락처를 세고, missing은 연락처가 아닌 주소를 소문자로 중복 없이 나열합니다. 이 주소들은 POST /contacts로 저장하거나, 연락처를 만들어 주는 POST /audiences/{id}/import로 보내세요.
다시 실행해도 안전합니다. 같은 호출을 두 번째로 보내면 아무것도 추가되지 않고 모두 unchanged로 보고됩니다. 기본 오디언스에 추가하면 항상 added: 0이 반환되는데, 모든 연락처가 이미 들어 있기 때문입니다.
emails가 비었거나 주소가 200개를 넘거나 본문에 다른 키가 있으면 422가 되고, 아무것도 쓰지 않습니다.