إفراغ جمهور
يُخرج كل جهة اتصال من الجمهور في معاملة واحدة. يبقى الجمهور بمعرّفه واسمه ووصفه، وتبقى كل جهة اتصال في دفتر العناوين وفي الجمهور الافتراضي وفي جماهيرها الأخرى.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /audiences/{id}/empty
يُخرج كل جهة اتصال من الجمهور في معاملة واحدة. يبقى الجمهور بمعرّفه واسمه ووصفه، وتبقى كل جهة اتصال في دفتر العناوين وفي الجمهور الافتراضي وفي جماهيرها الأخرى.
مثال
يتطلب audiences:write. لا يوجد متن للطلب.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/empty" -H "$AUTH"{ "object": "audience", "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "description": "Customers who asked to hear about releases", "builtin": null, "contactCount": 0, "lastContactAt": null, "createdAt": "2026-09-18T09:10:00.000Z", "updatedAt": "2026-09-18T09:10:00.000Z", "removed": 3}الرد هو الجمهور كما هو الآن، مضافًا إليه removed، أي عدد العضويات المُزالة. وإفراغ جمهور فارغ أصلًا يعيد removed: 0.
لا تراجع عن ذلك، ولا شيء يسجّل مَن كان في القائمة. مرّ على GET /audiences/{id}/contacts أولًا إن كنت قد تريد استعادتها. يطلب التطبيق من الشخص تأكيد هويته قبل إفراغ قائمة، والمفتاح لا يمر بهذه الخطوة، لذا امنح audiences:write عن قصد.
لا يمكن إفراغ الجمهور الافتراضي المدمج. ويُرفض ذلك الاستدعاء بـ 409 audience_immutable.