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