استيراد جهات اتصال إلى جمهور
استيراد CSV في صفحة الجمهور، عبر الواجهة البرمجية. كل عنوان سليم الصياغة يصبح جهة اتصال إن لم يكن كذلك بعد، وينتهي الجميع في هذا الجمهور، حتى 500 صف في كل استدعاء. أرسل القائمة الأطول على عدة استدعاءات.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /audiences/{id}/import
استيراد CSV في صفحة الجمهور، عبر الواجهة البرمجية. كل عنوان سليم الصياغة يصبح جهة اتصال إن لم يكن كذلك بعد، وينتهي الجميع في هذا الجمهور، حتى 500 صف في كل استدعاء. أرسل القائمة الأطول على عدة استدعاءات.
مثال
يتطلب audiences:write وcontacts:write، لأنه يُنشئ جهات اتصال. وكل صف هو email وname اختياري حتى 200 حرف.
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 هنا لا يملأ إلا اسمًا فارغًا. والعنوان الذي حُذف من الدفتر يعود جهة اتصال، والعنوان نفسه مرتين في استدعاء واحد يُعدّ مرة واحدة.
آمن لإعادة التشغيل: الاستدعاء الثاني المطابق لا يُنشئ شيئًا ولا يضيف شيئًا. ولا يُرسل شيء إلى أحد، ولا يُشترك أحد في أي شيء.