پرش به مستندات
API

تعیین گروه‌های مخاطب یک مخاطب

با یک فراخوانی دقیقاً می‌گوید یک مخاطب در کدام گروه‌ها باشد. مخاطب به هر گروهی در `audienceIds` که هنوز در آن نیست می‌پیوندد و هر گروه دیگری را ترک می‌کند. گروه مخاطبان پیش‌فرض همیشه نگه داشته می‌شود، پس یک فهرست خالی مخاطب را تنها در گروه مخاطبان پیش‌فرض باقی می‌گذارد.

PUTapi.openemail.uk/contacts/{email}/audiences

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

PUT /contacts/{email}/audiences

با یک فراخوانی دقیقاً می‌گوید یک مخاطب در کدام گروه‌ها باشد. مخاطب به هر گروهی در audienceIds که هنوز در آن نیست می‌پیوندد و هر گروه دیگری را ترک می‌کند. گروه مخاطبان پیش‌فرض همیشه نگه داشته می‌شود، پس یک فهرست خالی مخاطب را تنها در گروه مخاطبان پیش‌فرض باقی می‌گذارد.

نمونه

به audiences:write نیاز دارد، چون عضویت‌ها را می‌نویسد نه خود مخاطب را. @ را در URL رمزگذاری کنید. audienceIds تا ۱۰۰ شناسه را می‌پذیرد.

curl
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} برمی‌گرداند، با همهٔ گروه‌هایی که پس از تغییر در آن‌هاست.