سرد الجماهير
الجمهور قائمة مسمّاة من جهات الاتصال في مساحة العمل هذه. كل جهة اتصال تنتمي إلى الجمهور الافتراضي المدمج منذ لحظة وجودها، و`builtin` هو ما يُسمّي ذلك الصف؛ أما البقية فهي لك تصنعها وتملؤها وتحذفها. يأتي الجمهور الافتراضي أولًا، ثم البقية من الأحدث إلى الأقدم. وهذه النسخة تدير القوائم ولا ترسل إليها شيئًا، فلا توجد نقطة نهاية للبث تبحث عنها.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /audiences
الجمهور قائمة مسمّاة من جهات الاتصال في مساحة العمل هذه. كل جهة اتصال تنتمي إلى الجمهور الافتراضي المدمج منذ لحظة وجودها، وbuiltin هو ما يُسمّي ذلك الصف؛ أما البقية فهي لك تصنعها وتملؤها وتحذفها. يأتي الجمهور الافتراضي أولًا، ثم البقية من الأحدث إلى الأقدم. وهذه النسخة تدير القوائم ولا ترسل إليها شيئًا، فلا توجد نقطة نهاية للبث تبحث عنها.
مثال
يتطلب audiences:read. وتصل limit إلى 100 وقيمتها الافتراضية 25.
curl "$OE/audiences" -H "$AUTH"{ "object": "list", "data": [ { "object": "audience", "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "description": null, "builtin": "default", "contactCount": 412, "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-08-01T10:00:00.000Z" } ], "hasMore": false, "nextCursor": null}تفرّع على builtin لا على الاسم. فالجمهور الافتراضي يستطيع أي شخص إعادة تسميته، واسمه هو الشيء الوحيد الذي يتغيّر فيه.
يُحسم الجمهور الافتراضي عند أول قراءة، لذا فإن مساحة العمل التي لم تُنشئ جمهورًا قط تسرد صفًا واحدًا بالضبط.
يُحسب contactCount لحظة القراءة، لذا تختلف قراءتان على طرفي عملية إنشاء بمقدار واحد. والأسماء ليست فريدة، فخزّن المعرّفات لا الأسماء.