تخطَّ إلى المستندات
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 ولا يُزال شيء. احذف جهة الاتصال حين تقصد أن تذهب.