افزودن یک مخاطب به گروه مخاطبان
نشانیای را که از پیش در دفترچه فضای کاری هست میگیرد و عضویت را همراه با مخاطبی که به آن اشاره میکند برمیگرداند. به ازای هر گروه مخاطبان و هر مخاطب فقط یک عضویت وجود دارد، بنابراین افزودن کسی که از پیش در گروه است با `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 تنها دامنه دسترسیای است که بررسی میشود. گذاشتن یک مخاطب در یک فهرست، نوشتن روی خود مخاطب نیست.
برای هر مخاطب یک فراخوانی. در این نسخه افزودن گروهی وجود ندارد، و حذف بعدی مخاطب این عضویت را هم با خود میبرد.