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

Удаление контакта из аудитории

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

DELETEapi.openemail.uk/audiences/{id}/contacts/{email}

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

DELETE /audiences/{id}/contacts/{email}

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

Пример

Требуется audiences:write. Кодируйте @ в URL.

curl
curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/grace%40example.com" -H "$AUTH"
Ответ
{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "email": "[email protected]",  "deleted": true}

Контакт, которого нет в этой аудитории, даёт 404, поэтому опечатка не сможет отчитаться об удалении, которого не было.

Встроенную аудиторию по умолчанию нельзя проредить. Такой вызов отклоняется с 409 audience_immutable, потому что она содержит каждый контакт до тех пор, пока тот остаётся контактом. Удаляйте контакт, если хотите, чтобы он исчез.

Удаление последнего контакта оставляет аудиторию на месте и пустой.