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