تخطَّ إلى المستندات
API

تحديث جمهور

تحديث جزئي. الحقل الذي تتركه يحتفظ بقيمته المخزّنة، و`null` الصريحة تمسحه. ويمكن إعادة تسمية الجمهور الافتراضي المدمج ووصفه كأي جمهور آخر، وإعادة تسميته لا تغيّر `builtin` ولا ما يحويه.

PATCHapi.openemail.uk/audiences/{id}

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

PATCH /audiences/{id}

تحديث جزئي. الحقل الذي تتركه يحتفظ بقيمته المخزّنة، وnull الصريحة تمسحه. ويمكن إعادة تسمية الجمهور الافتراضي المدمج ووصفه كأي جمهور آخر، وإعادة تسميته لا تغيّر builtin ولا ما يحويه.

مثال

يتطلب audiences:write.

curl
curl -X PATCH "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Release notes"}'
الاستجابة
{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Release notes",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:22:00.000Z"}

لا يمكن ضبط builtin أو نقله أو مسحه من هنا.

إعادة التسمية لا تنقل أحدًا. تبقى جهات الاتصال في الجمهور تحت اسمه الجديد، والمعرّف لا يتغيّر أبدًا.