Перейти к документации
API

Массовое удаление контактов из аудитории

Убирает до 200 контактов из одной аудитории одним вызовом, по адресу. Каждый из них остаётся в адресной книге, в аудитории по умолчанию и во всех других аудиториях, в которых был.

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

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

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

Убирает до 200 контактов из одной аудитории одним вызовом, по адресу. Каждый из них остаётся в адресной книге, в аудитории по умолчанию и во всех других аудиториях, в которых был.

Пример

Требует audiences:write. Тело имеет ту же форму, что и при массовом добавлении: emails с 1–200 адресами.

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, и ничего не убирается. Удалите контакт, если хотите, чтобы он исчез.