Bir kişinin kitlelerini belirleme
Bir kişinin tam olarak hangi kitlelerde olduğunu tek çağrıda belirtir. Kişi, `audienceIds` içindeki henüz bulunmadığı her kitleye katılır ve diğer hepsinden ayrılır. Varsayılan kitle her zaman korunur; bu yüzden boş bir liste kişiyi yalnızca varsayılan kitlede bırakır.
Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.
PUT /contacts/{email}/audiences
Bir kişinin tam olarak hangi kitlelerde olduğunu tek çağrıda belirtir. Kişi, audienceIds içindeki henüz bulunmadığı her kitleye katılır ve diğer hepsinden ayrılır. Varsayılan kitle her zaman korunur; bu yüzden boş bir liste kişiyi yalnızca varsayılan kitlede bırakır.
Örnek
Kişiyi değil üyelikleri yazdığı için audiences:write gerektirir. @ karakterini URL kodlamasıyla yazın. audienceIds en fazla 100 kimlik alır.
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 } ]}Kişinin zaten var olması gerekir. Defterde olmayan bir adres 404 contact_not_found verir. Kişiyi, audienceIds de alan POST /contacts ile oluşturun.
Bu çalışma alanında hiçbir kitleyi göstermeyen bir kimlik 404 audience_not_found verir ve hiçbir şey değişmez; böylece bir yazım hatası birini sessizce bir listeden çıkaramaz. Aynı çağrıyı yeniden göndermek hiçbir şeyi değiştirmez.
Yanıt, GET /contacts/{email} yanıtıyla aynı biçimdeki kişidir ve değişiklikten sonra içinde bulunduğu her kitleyi içerir.