API

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

درون‌بری CSV صفحهٔ گروه مخاطب، از راه API. هر نشانی درست‌ساخت اگر هنوز مخاطب نیست مخاطب می‌شود، و همه به این گروه می‌رسند، تا ۵۰۰ ردیف در هر فراخوانی. فهرست بلندتر را در چند فراخوانی بفرستید.

POSTapi.openemail.uk/audiences/{id}/import

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

POST /audiences/{id}/import

نمونه

به audiences:write و contacts:write نیاز دارد، چون مخاطب می‌سازد. هر ردیف یک email و یک name اختیاری تا ۲۰۰ نویسه است.

curl

curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/import" -H "$AUTH" -H 'content-type: application/json' -d '{  "contacts": [    { "email": "[email protected]", "name": "Grace Hopper" },    { "email": "[email protected]", "name": "Katherine Johnson" },    { "email": "not-an-address" }  ]}'

پاسخ

{  "object": "audience_import",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "created": 1,  "added": 1,  "skipped": 1,  "invalid": ["not-an-address"]}

created مخاطبان تازه را می‌شمارد، added عضویت‌های تازه در این گروه را، و skipped ردیف‌هایی را که درون‌بری نشدند. invalid نشانی‌های نادرست را دقیقاً همان‌طور که فرستاده شده‌اند فهرست می‌کند. مخاطب تازه با manual ذخیره می‌شود و به گروه مخاطبان پیش‌فرض هم می‌پیوندد.

نشانی‌ای که از پیش مخاطب است دوباره به کار می‌رود، هرگز تکراری نمی‌شود، و نامش را نگه می‌دارد: name در اینجا تنها نامی خالی را پر می‌کند. نشانی‌ای که از دفترچه حذف شده دوباره مخاطب می‌شود، و یک نشانی که دو بار در یک فراخوانی آمده یک بار شمرده می‌شود.

تکرارش بی‌خطر است: فراخوانی دوم یکسان نه چیزی می‌سازد و نه چیزی می‌افزاید. چیزی برای کسی فرستاده نمی‌شود و کسی مشترک چیزی نمی‌شود.