تعیین گروههای مخاطب یک مخاطب
با یک فراخوانی دقیقاً میگوید یک مخاطب در کدام گروهها باشد. مخاطب به هر گروهی در `audienceIds` که هنوز در آن نیست میپیوندد و هر گروه دیگری را ترک میکند. گروه مخاطبان پیشفرض همیشه نگه داشته میشود، پس یک فهرست خالی مخاطب را تنها در گروه مخاطبان پیشفرض باقی میگذارد.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
PUT /contacts/{email}/audiences
با یک فراخوانی دقیقاً میگوید یک مخاطب در کدام گروهها باشد. مخاطب به هر گروهی در audienceIds که هنوز در آن نیست میپیوندد و هر گروه دیگری را ترک میکند. گروه مخاطبان پیشفرض همیشه نگه داشته میشود، پس یک فهرست خالی مخاطب را تنها در گروه مخاطبان پیشفرض باقی میگذارد.
نمونه
به audiences:write نیاز دارد، چون عضویتها را مینویسد نه خود مخاطب را. @ را در URL رمزگذاری کنید. audienceIds تا ۱۰۰ شناسه را میپذیرد.
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} برمیگرداند، با همهٔ گروههایی که پس از تغییر در آنهاست.