অডিয়েন্স API

bulkSetTags

POST https://api.pushwoosh.com/api/v2/audience/bulkSetTags

ডিভাইসের তালিকার জন্য ট্যাগ মান সেট করে।

গুরুত্বপূর্ণ

bulkSetTags পদ্ধতি ব্যবহার করার সময়, নিশ্চিত করুন যে সর্বনিম্ন ৫০টি ডিভাইসের জন্য ট্যাগ মান সেট করা হয়েছে। একটি ডিভাইসের জন্য ট্যাগ সেট করতে, setTags পদ্ধতিটি ব্যবহার করুন।

অনুরোধের বডি

নাম	টাইপ	বিবরণ
application*	String	পুশউশ অ্যাপ্লিকেশন কোড
auth*	String	পুশউশ কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন।
create_missing_tags	Boolean	যদি সত্য হয়, অনুপস্থিত ট্যাগগুলি স্বয়ংক্রিয়ভাবে তৈরি হয়।
devices*	Object	ডিভাইসের অ্যারে।
devices.hwid	String	user_id বা push_token এর পরিবর্তে একটি ডিভাইস শনাক্ত করতে ব্যবহার করা যেতে পারে। আরও জানুন
devices.user_id	String	hwid বা push_token এর পরিবর্তে একজন ব্যবহারকারীকে শনাক্ত করতে ব্যবহার করা যেতে পারে। আরও জানুন
devices.push_token	String	hwid বা user_id এর পরিবর্তে একটি ডিভাইস শনাক্ত করতে ব্যবহার করা যেতে পারে। আরও জানুন
devices.list_operator	String	তালিকা ধরনের ট্যাগগুলির জন্য মান কীভাবে সেট করতে হবে তা নির্ধারণ করে: সেট, অ্যাপেন্ড, বা রিমুভ
devices.tags*	Object	নির্দিষ্ট ট্যাগগুলির জন্য সেট করার মান।

ঠিক আছে

{
  "request_id": "GET পদ্ধতিতে কাজের স্ট্যাটাস পেতে ব্যবহৃত অনুরোধ আইডি",
  "status": "পেন্ডিং"
}

ত্রুটি

{
  "message": "অবৈধ অনুরোধ"
}

অনুরোধ:

{
  "application": "application code",   // আবশ্যক। পুশউশ অ্যাপ কোড
  "auth": "Pushwoosh auth token",      // আবশ্যক। পুশউশ কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন
  "create_missing_tags": false,        // ঐচ্ছিক। অনুপস্থিত ট্যাগগুলি স্বয়ংক্রিয়ভাবে তৈরি করা উচিত
  "devices": [{                        // আবশ্যক। ডিভাইসের অ্যারে
    "hwid": "device hwid",             // ঐচ্ছিক। এর পরিবর্তে একটি ডিভাইস শনাক্ত করতে ব্যবহার করা যেতে পারে
                                       //           "user_id" বা "push_token"।
    "user_id": "user ID",              // ঐচ্ছিক। "hwid" বা "push_token" এর পরিবর্তে একজন ব্যবহারকারীকে শনাক্ত করতে ব্যবহার করা যেতে পারে।
    "push_token": "device push token", // ঐচ্ছিক। "hwid" বা "user_id" এর পরিবর্তে একটি ডিভাইস শনাক্ত করতে ব্যবহার করা যেতে পারে।
    "list_operator": "set",            // আবশ্যক। তালিকা ট্যাগের জন্য। তালিকা ধরনের ট্যাগগুলির জন্য
                                       //           মান কীভাবে সেট করতে হবে তা নির্ধারণ করে: সেট, অ্যাপেন্ড, বা রিমুভ
    "tags": {                          // আবশ্যক। নির্দিষ্ট ট্যাগগুলির জন্য সেট করার মান।
      "tag_name": "tagvalue",          //           সঠিক মানের টাইপ ব্যবহার করুন
      "tag_name2": "tagvalue2"
    }
  }]
}

প্রতিক্রিয়া:

{
  "request_id": "GET পদ্ধতিতে কাজের স্ট্যাটাস পেতে ব্যবহৃত অনুরোধ আইডি",
  "status": "পেন্ডিং"
}

bulkSetTags স্ট্যাটাস

GET https://api.pushwoosh.com/api/v2/audience/bulkSetTags/{request_id}?detailed=false

/bulkSetTags অপারেশনের স্ট্যাটাস প্রদান করে

পাথ প্যারামিটার

নাম	টাইপ	বিবরণ
request_id	String	পূর্ববর্তী /bulkSetTags কল থেকে অনুরোধ আইডি

কোয়েরি প্যারামিটার

নাম	টাইপ	বিবরণ
detailed	Boolean	(সত্য/মিথ্যা) প্রতি-ডিভাইস বিস্তারিত তথ্য প্রদান করা হবে কিনা

প্রতিক্রিয়া:

{
  "request_id": "অনুরোধের আইডি",
  "status": "সম্পূর্ণ",          // এছাড়াও "পেন্ডিং", "ব্যর্থ"
  "progress": 100,                // কাজের অগ্রগতি ০-১০০
  "devices_success": 100,         // ভালো ডিভাইস
  "devices_not_found": 0,         // পুশউশে ডিভাইস পাওয়া যায়নি
  "devices_failed": 0,            // ত্রুটিযুক্ত
  "devices": [{                   // ডিভাইস রিপোর্ট (শুধুমাত্র বিস্তারিত = সত্য হলে)
    "hwid": "device hwid",
    "status": "সম্পন্ন",             // এছাড়াও "ব্যর্থ", "পাওয়া যায়নি"
    "tags": {
      "tagName": "ঠিক আছে",
      "tagName2": "ট্যাগ পাওয়া যায়নি",
      "tagName3": "ভুল মান। প্রত্যাশিত :স্ট্রিং"
    }
  }]
}

bulkRegisterDevice

একটি অনুরোধে পুশউশে একাধিক ডিভাইস নিবন্ধন করে। এটি প্রতিটি ডিভাইসের জন্য বিভিন্ন ট্যাগ নির্দিষ্ট করার অনুমতিও দেয়।

POST https://api.pushwoosh.com/api/v2/audience/bulkRegisterDevice

অনুরোধের বডি প্যারামিটার

প্যারামিটার	টাইপ	আবশ্যক	বিবরণ
application	string	হ্যাঁ	পুশউশ অ্যাপ্লিকেশন কোড
auth	string	হ্যাঁ	API অ্যাক্সেস টোকেন।
devices	array	হ্যাঁ	ডিভাইস অবজেক্টের একটি অ্যারে। প্রতিটি অবজেক্ট একটি ডিভাইস এবং এর সংশ্লিষ্ট ডেটা উপস্থাপন করে। নিচের ডিভাইস অবজেক্ট প্যারামিটার টেবিলে বিস্তারিত দেখুন।

ডিভাইস অবজেক্ট প্যারামিটার

প্যারামিটার	টাইপ	আবশ্যক	বিবরণ
hwid	string	হ্যাঁ	ডিভাইসের জন্য হার্ডওয়্যার আইডি বা অনন্য শনাক্তকারী।
push_token	string	হ্যাঁ	ডিভাইসের জন্য পুশ টোকেন।
platform	integer	হ্যাঁ	প্ল্যাটফর্ম শনাক্তকারী। আরও জানুন
list_operator	string	না	তালিকা-ধরনের ট্যাগগুলির জন্য ক্রিয়া নির্ধারণ করে: - “append”: ট্যাগ তালিকায় নির্দিষ্ট মান যোগ করুন। - “remove”: ট্যাগ তালিকা থেকে নির্দিষ্ট মান সরান। দ্রষ্টব্য: যদি list_operator প্যারামিটার নির্দিষ্ট না করা হয়, তাহলে ট্যাগ তালিকার সমস্ত বিদ্যমান মান প্রদত্ত মানগুলির সাথে প্রতিস্থাপিত হবে।
tags	object	না	ডিভাইসে নির্ধারিত কাস্টম ট্যাগ। ট্যাগগুলি সেগমেন্টেশনের জন্য ব্যবহৃত কী-ভ্যালু পেয়ার।

অনুরোধের উদাহরণ

{
  "application": "application code",   // আবশ্যক। পুশউশ অ্যাপ কোড
  "auth": "Pushwoosh auth token",      // আবশ্যক। পুশউশ কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন
  "devices": [{                        // আবশ্যক। ডিভাইসের অ্যারে
    "hwid": "device hwid",             // আবশ্যক। ডিভাইসের জন্য অনন্য শনাক্তকারী (ইমেল হতে পারে)।
    "push_token": "device push token", // আবশ্যক। ডিভাইসের জন্য পুশ নোটিফিকেশন টোকেন।
    "platform": 14,                    // আবশ্যক। ডিভাইস প্ল্যাটফর্ম (যেমন, ইমেলের জন্য 14)।
    "list_operator": "append",         // ঐচ্ছিক। তালিকা ট্যাগের জন্য। তালিকা ধরনের ট্যাগ থেকে নির্দিষ্ট মান(গুলি) যোগ বা অপসারণ করে।
    "tags": {                          // ঐচ্ছিক। নির্দিষ্ট ট্যাগগুলির জন্য সেট করার মান।
      "language": "en",                //           সঠিক মানের টাইপ ব্যবহার করুন।
      "CSV_Import": "summer_camp"
    }
  },
  {
    "hwid": "device hwid 2",           // আবশ্যক। দ্বিতীয় ডিভাইসের জন্য অনন্য শনাক্তকারী।
    "push_token": "device push token 2", // আবশ্যক। ডিভাইসের জন্য পুশ নোটিফিকেশন টোকেন।
    "platform": 14,                    // আবশ্যক। ডিভাইস প্ল্যাটফর্ম।
    "list_operator": "remove",         // ঐচ্ছিক। তালিকা ধরনের ট্যাগ থেকে মান যোগ বা অপসারণ করে।
    "tags": {                          // ঐচ্ছিক। নির্দিষ্ট ট্যাগ থেকে অপসারণ করার মান।
      "language": "en",
      "CSV_Import": "summer_camp2"
    }
  },
  {
    "hwid": "device hwid 3",           // আবশ্যক। তৃতীয় ডিভাইসের জন্য অনন্য শনাক্তকারী।
    "push_token": "device push token 3", // আবশ্যক। ডিভাইসের জন্য পুশ নোটিফিকেশন টোকেন।
    "platform": 14,                    // আবশ্যক। ডিভাইস প্ল্যাটফর্ম।
    "tags": {                          // ঐচ্ছিক। নির্দিষ্ট ট্যাগগুলির জন্য সেট করার মান।
      "language": "en",
      "CSV_Import": "summer_camp3"
    }
  }]
}

প্রতিক্রিয়া

পদ্ধতিটি একটি অপারেশন আইডি দিয়ে প্রতিক্রিয়া জানায়, যা বাল্ক নিবন্ধন প্রক্রিয়ার স্ট্যাটাস এবং ফলাফল ট্র্যাক করতে ব্যবহার করা যেতে পারে।

{
  "request_id": "GET পদ্ধতিতে কাজের স্ট্যাটাস পেতে ব্যবহৃত অনুরোধ আইডি",
  "status": "পেন্ডিং"
}

bulkRegisterDevice স্ট্যাটাস

আপনি নিম্নলিখিত GET অনুরোধ করে একটি বাল্ক নিবন্ধন প্রক্রিয়ার স্ট্যাটাস পরীক্ষা করতে পারেন:

GET https://api.pushwoosh.com/api/v2/audience/bulkRegisterDevice/{request_id}?detailed=true

প্যারামিটার	টাইপ	আবশ্যক	বিবরণ
request_id	string	হ্যাঁ	POST অনুরোধ দ্বারা ফেরত দেওয়া অনুরোধ আইডি।
detailed	boolean	না	যদি true তে সেট করা হয়, প্রতিক্রিয়াতে প্রতিটি নিবন্ধিত ডিভাইসের জন্য বিস্তারিত ফলাফল অন্তর্ভুক্ত থাকে।

উদাহরণ প্রতিক্রিয়া

{
  "request_id": "9a2e1a14-XXXX-46c3-XXXX-c254b25d3782",
  "status": "সম্পূর্ণ",
  "progress": 100,
  "devices_success": 4,
  "devices": [
    {
      "hwid": "user1@example.com",
      "status": "সম্পন্ন"
    },
    {
      "hwid": "user2@example.com",
      "status": "সম্পন্ন"
    },
    {
      "hwid": "user3@example.com",
      "status": "সম্পন্ন"
    },
    {
      "hwid": "invalid_email@example.com",
      "status": "ব্যর্থ"
    }
  ]
}

bulkUnregisterDevice

একটি অনুরোধে পুশউশ থেকে একাধিক ডিভাইস নিবন্ধনমুক্ত করে।

POST https://api.pushwoosh.com/api/v2/audience/bulkUnregisterDevice

অনুরোধের বডি প্যারামিটার

প্যারামিটার	টাইপ	আবশ্যক	বিবরণ
application	string	হ্যাঁ	পুশউশ অ্যাপ্লিকেশন কোড
auth	string	হ্যাঁ	API অ্যাক্সেস টোকেন
devices	array	হ্যাঁ	ডিভাইস অবজেক্টের একটি অ্যারে। প্রতিটি অবজেক্ট একটি ডিভাইস এবং এর সংশ্লিষ্ট ডেটা উপস্থাপন করে। নিচের ডিভাইস অবজেক্ট প্যারামিটার টেবিলে বিস্তারিত দেখুন।

ডিভাইস অবজেক্ট প্যারামিটার

প্যারামিটার	টাইপ	আবশ্যক	বিবরণ
hwid	string	হ্যাঁ	ডিভাইসের জন্য হার্ডওয়্যার আইডি বা অনন্য শনাক্তকারী। আরও জানুন

অনুরোধের উদাহরণ

{
  "application": "application code",   // আবশ্যক। পুশউশ অ্যাপ কোড
  "auth": "Pushwoosh auth token",      // আবশ্যক। পুশউশ কন্ট্রোল প্যানেল থেকে API অ্যাক্সেস টোকেন
  "devices": [{                        // আবশ্যক। ডিভাইসের অ্যারে
    "hwid": "device hwid",             // আবশ্যক। ডিভাইসের জন্য অনন্য শনাক্তকারী (ইমেল হতে পারে)।
  },
  {
    "hwid": "device hwid 2",           // আবশ্যক। দ্বিতীয় ডিভাইসের জন্য অনন্য শনাক্তকারী।
  },
  {
    "hwid": "device hwid 3",           // আবশ্যক। তৃতীয় ডিভাইসের জন্য অনন্য শনাক্তকারী।
  }]
}

প্রতিক্রিয়া

পদ্ধতিটি একটি অপারেশন আইডি দিয়ে প্রতিক্রিয়া জানায়, যা বাল্ক প্রক্রিয়ার স্ট্যাটাস এবং ফলাফল ট্র্যাক করতে ব্যবহার করা যেতে পারে।

{
  "request_id": "GET পদ্ধতিতে কাজের স্ট্যাটাস পেতে ব্যবহৃত অনুরোধ আইডি",
  "status": "পেন্ডিং"
}

bulkUnregisterDevice স্ট্যাটাস

আপনি নিম্নলিখিত GET অনুরোধ করে একটি বাল্ক নিবন্ধনমুক্তকরণ প্রক্রিয়ার স্ট্যাটাস পরীক্ষা করতে পারেন:

GET https://api.pushwoosh.com/api/v2/audience/bulkUnregisterDevice/{request_id}?detailed=true

প্যারামিটার	টাইপ	আবশ্যক	বিবরণ
request_id	string	হ্যাঁ	POST অনুরোধ দ্বারা ফেরত দেওয়া অনুরোধ আইডি।
detailed	boolean	না	যদি true তে সেট করা হয়, প্রতিক্রিয়াতে প্রতিটি নিবন্ধনমুক্ত ডিভাইসের জন্য বিস্তারিত ফলাফল অন্তর্ভুক্ত থাকে।

উদাহরণ প্রতিক্রিয়া

{
  "request_id": "9a2e1a14-XXXX-46c3-XXXX-c254b25d3782",
  "status": "সম্পূর্ণ",
  "progress": 100,
  "devices_success": 4,
  "devices": [
    {
      "hwid": "user1@example.com",
      "status": "সম্পন্ন"
    },
    {
      "hwid": "user2@example.com",
      "status": "সম্পন্ন"
    },
    {
      "hwid": "user3@example.com",
      "status": "সম্পন্ন"
    },
    {
      "hwid": "invalid_email@example.com",
      "status": "ব্যর্থ"
    }
  ]
}