إضافة جهة اتصال إلى جمهور
يأخذ عنوانًا موجودًا مسبقًا في دفتر مساحة العمل ويعيد العضوية، ومعها جهة الاتصال التي تشير إليها. توجد عضوية واحدة لكل جمهور وجهة اتصال، لذا فإن إضافة شخص موجود في الجمهور بالفعل تُجيب بـ `200` مع قيمة `addedAt` الأصلية بدلًا من إضافة عضوية ثانية أو الفشل. وهذا ما يجعل إعادة الاستدعاء آمنة.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /audiences/{id}/contacts
يأخذ عنوانًا موجودًا مسبقًا في دفتر مساحة العمل ويعيد العضوية، ومعها جهة الاتصال التي تشير إليها. توجد عضوية واحدة لكل جمهور وجهة اتصال، لذا فإن إضافة شخص موجود في الجمهور بالفعل تُجيب بـ 200 مع قيمة addedAt الأصلية بدلًا من إضافة عضوية ثانية أو الفشل. وهذا ما يجعل إعادة الاستدعاء آمنة.
مثال
يتطلب audiences:write.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]"}'{ "object": "audience_member", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "addedAt": "2026-09-18T09:30:00.000Z", "contact": { "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": null, "lastSeenAt": null, "createdAt": "2026-09-18T09:00:00.000Z", "updatedAt": "2026-09-18T09:00:00.000Z" }}العنوان الذي ليس جهة اتصال يُرفض بـ 422 contact_not_found بدلًا من إنشائه في الحال. احفظه أولًا عبر POST /contacts.
audiences:write هو النطاق الوحيد الذي يُفحص. فوضع جهة اتصال في قائمة ليس كتابةً على جهة الاتصال.
استدعاء واحد لكل جهة اتصال. لا توجد إضافة جماعية في هذه النسخة، وحذف جهة الاتصال لاحقًا يُسقط هذه العضوية معها.