برداشتن گروهی مخاطبان از یک گروه مخاطب
تا ۲۰۰ مخاطب را با یک فراخوانی و بر پایهٔ نشانی از یک گروه مخاطب بیرون میآورد. هرکدام در دفترچهٔ نشانیها، در گروه مخاطبان پیشفرض و در هر گروه دیگری که در آن بوده میماند.
فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا میکند.
POST /audiences/{id}/contacts/batch-remove
تا ۲۰۰ مخاطب را با یک فراخوانی و بر پایهٔ نشانی از یک گروه مخاطب بیرون میآورد. هرکدام در دفترچهٔ نشانیها، در گروه مخاطبان پیشفرض و در هر گروه دیگری که در آن بوده میماند.
نمونه
به audiences:write نیاز دارد. بدنه همان شکل افزودن گروهی را دارد: emails با ۱ تا ۲۰۰ نشانی.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch-remove" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "removed": 1, "notInAudience": ["[email protected]"], "missing": ["[email protected]"]}removed عضویتهای برداشتهشده را میشمارد، notInAudience مخاطبانی را که در این گروه نبودهاند فهرست میکند، و missing نشانیهایی را که اصلاً مخاطب نیستند. برای هیچکدام از این دو فهرست اتفاقی نمیافتد، پس تکرار فراخوانی بیخطر است.
گروه مخاطبان پیشفرض داخلی را نمیتوان کم کرد. فراخوانی با 409 audience_immutable رد میشود و چیزی برداشته نمیشود. وقتی میخواهید مخاطبی برود، آن را حذف کنید.