تحديد جماهير جهة اتصال
يحدّد بالضبط الجماهير التي تنتمي إليها جهة اتصال واحدة، باستدعاء واحد. تنضم جهة الاتصال إلى كل جمهور في `audienceIds` لم تكن فيه بعد، وتغادر كل جمهور آخر. ويُحتفظ بالجمهور الافتراضي دائمًا، لذا فالقائمة الفارغة تُبقي جهة الاتصال في الجمهور الافتراضي وحده.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
PUT /contacts/{email}/audiences
يحدّد بالضبط الجماهير التي تنتمي إليها جهة اتصال واحدة، باستدعاء واحد. تنضم جهة الاتصال إلى كل جمهور في audienceIds لم تكن فيه بعد، وتغادر كل جمهور آخر. ويُحتفظ بالجمهور الافتراضي دائمًا، لذا فالقائمة الفارغة تُبقي جهة الاتصال في الجمهور الافتراضي وحده.
مثال
يتطلب audiences:write، لأنه يكتب العضويات لا جهة الاتصال. رمّز @ في عنوان URL. وتتسع audienceIds لما يصل إلى 100 معرّف.
curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'{ "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", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null } ]}يجب أن تكون جهة الاتصال موجودة مسبقًا. والعنوان غير الموجود في الدفتر يعطي 404 contact_not_found. أنشئها عبر POST /contacts، الذي يقبل audienceIds أيضًا.
المعرّف الذي لا يشير إلى أي جمهور في مساحة العمل هذه يعطي 404 audience_not_found ولا يتغير شيء، فلا يستطيع خطأ مطبعي أن يُخرج شخصًا من قائمة بصمت. وإرسال الاستدعاء نفسه مرة أخرى لا يغيّر شيئًا.
الرد هو جهة الاتصال كما يعيدها GET /contacts/{email}، مع كل جمهور تنتمي إليه بعد التغيير.