Belgelere geç
API

Bir kitleden toplu kişi çıkarma

Tek çağrıda, adrese göre en fazla 200 kişiyi bir kitleden çıkarır. Her biri adres defterinde, varsayılan kitlede ve bulunduğu diğer bütün kitlelerde kalır.

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

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

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

Tek çağrıda, adrese göre en fazla 200 kişiyi bir kitleden çıkarır. Her biri adres defterinde, varsayılan kitlede ve bulunduğu diğer bütün kitlelerde kalır.

Örnek

audiences:write gerektirir. Gövde toplu ekleme ile aynı biçimdedir: 1 ile 200 arası adres içeren 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]"]}'
Yanıt
{  "object": "audience_batch",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "removed": 1,  "notInAudience": ["[email protected]"],  "missing": ["[email protected]"]}

removed kaldırılan üyelikleri sayar, notInAudience bu kitlede olmayan kişileri, missing ise hiç kişi olmayan adresleri listeler. Bu iki listedekilere hiçbir şey olmaz; bu yüzden çağrı güvenle yinelenebilir.

Yerleşik varsayılan kitle seyreltilemez. Çağrı 409 audience_immutable ile reddedilir ve hiçbir şey kaldırılmaz. Bir kişinin gitmesini istediğinizde onu silin.