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