إضافة جهات اتصال إلى جمهور دفعة واحدة
يضع حتى 200 جهة اتصال في جمهور واحد باستدعاء واحد، بحسب العنوان. وكما في الإضافة الفردية، يأخذ عناوين موجودة مسبقًا في دفتر مساحة العمل ولا يُنشئ جهة اتصال أبدًا: فالعنوان الذي ليس جهة اتصال يعود في `missing` ولا يُكتب له شيء، بينما يمضي باقي الاستدعاء.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /audiences/{id}/contacts/batch
يضع حتى 200 جهة اتصال في جمهور واحد باستدعاء واحد، بحسب العنوان. وكما في الإضافة الفردية، يأخذ عناوين موجودة مسبقًا في دفتر مساحة العمل ولا يُنشئ جهة اتصال أبدًا: فالعنوان الذي ليس جهة اتصال يعود في missing ولا يُكتب له شيء، بينما يمضي باقي الاستدعاء.
مثال
يتطلب audiences:write. تحمل emails من 1 إلى 200 عنوان، تُقَص مسافاتها وتُحوَّل إلى أحرف صغيرة قبل المطابقة.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "added": 1, "unchanged": 1, "missing": ["[email protected]"]}added يعدّ العضويات الجديدة، وunchanged جهات الاتصال التي كانت في الجمهور مسبقًا، وmissing يسرد العناوين التي ليست جهات اتصال، بأحرف صغيرة ومن دون تكرار. احفظها عبر POST /contacts، أو أرسلها إلى POST /audiences/{id}/import الذي يُنشئها.
آمن لإعادة التشغيل. والاستدعاء الثاني المطابق لا يضيف شيئًا ويبلّغ عن الجميع بأنهم unchanged. والإضافة إلى الجمهور الافتراضي تعيد دائمًا added: 0، لأن كل جهة اتصال فيه أصلًا.
emails الفارغة، أو أكثر من 200 عنوان، أو أي مفتاح آخر في المتن يعطي 422، ولا يُكتب شيء.