SuperChatEvents

superChatEvent রিসোর্স হল YouTube লাইভ স্ট্রিম চলাকালীন কোনও অনুরাগীর কেনা Super Chat মেসেজ। YouTube লাইভ চ্যাট স্ট্রিমে, Super Chat দুটি উপায়ে অন্যান্য মেসেজের থেকে আলাদাভাবে দেখানো হয়:

• Super Chat একটি রঙ দিয়ে হাইলাইট করা হয়।
• Super Chats একটি নির্দিষ্ট সময়সীমার জন্য টিকারের মধ্যে পিন করা থাকে।

Super Chat-এর রঙ, টিকারে এটি কতক্ষণ পিন করা থাকবে এবং মেসেজের সর্বাধিক দৈর্ঘ্য কত হবে, এই সবকিছুই ক্রয়ের অঙ্কের উপর নির্ভর করে। Super Chat সম্পর্কে আরও জানতে YouTube সহায়তা কেন্দ্র দেখুন।

পদ্ধতি

API-তে superChatEvents রিসোর্সের জন্য নিম্নলিখিত পদ্ধতি কাজ করে:

তালিকা

গত ৩০ দিনে চ্যানেলের লাইভ স্ট্রিম থেকে Super Chat ইভেন্টের তালিকা। এখনই এটি ব্যবহার করে দেখুন।

রিসোর্স রিপ্রেজেন্টেশন

নিচে দেওয়া JSON স্ট্রাকচার থেকে superChatEvent রিসোর্সের ফর্ম্যাট সম্পর্কে জানা যায়:

{
  "kind": "youtube#superChatEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string,
    "messageType": unsigned integer,
    "isSuperStickerEvent": boolean,
    "superStickerMetadata": {
      "stickerId": string,
      "altText": string,
      "language": string
    }
  }
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#superChatEvent হবে।
etag	etag এই রিসোর্সের Etag.
id	string Super Chat ইভেন্টকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি অ্যাসাইন করে।
snippet	object snippet অবজেক্টে Super Chat ইভেন্ট সম্পর্কে প্রাথমিক বিবরণ থাকে।
snippet.channelId	string YouTube চ্যানেল আইডি যা Super Chat ইভেন্টের সাথে যুক্ত লাইভ স্ট্রিম ব্রডকাস্ট করা চ্যানেলকে শনাক্ত করে।
snippet.supporterDetails	object সমর্থকের চ্যানেল সম্পর্কিত বিবরণ।
snippet.supporterDetails.channelId	string সমর্থকের YouTube চ্যানেল আইডি।
snippet.supporterDetails.channelUrl	string সমর্থকের চ্যানেলের URL।
snippet.supporterDetails.displayName	string সমর্থকের চ্যানেলের ডিসপ্লে নাম।
snippet.supporterDetails.profileImageUrl	string সমর্থকের চ্যানেলের অবতার URL।
snippet.commentText	string সমর্থকের কমেন্টের টেক্সট কন্টেন্ট।
snippet.createdAt	datetime Super Chat কেনার তারিখ ও সময়। ভ্যালু ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) ফর্ম্যাটে উল্লেখ করা হয়েছে।
snippet.amountMicros	unsigned long কেনাকাটার পরিমাণ, কেনাকাটার মুদ্রার মাইক্রোতে। যেমন, কেনাকাটার পরিমাণ এক ডলার হলে, snippet.amountMicros প্রপার্টির ভ্যালু হল 1000000।
snippet.currency	string যে মুদ্রায় কেনাকাটা করা হয়েছে। এই ভ্যালু হল একটি ISO 4217 মুদ্রার কোড।
snippet.displayString	string $1.00-এর মতো একটি স্ট্রিং যা কেনাকাটার পরিমাণ ও মুদ্রা দেখায়। hl অনুরোধ প্যারামিটার দ্বারা নির্দিষ্ট করা ভাষার কনভেনশনের উপর ভিত্তি করে ডিসপ্লে স্ট্রিং ফর্ম্যাট করা হয়। সাধারণত, ডিসপ্লে স্ট্রিংগুলি ইংরেজিতে যেভাবে লেখা হয় সেইভাবে ফর্ম্যাট করা হয়। যেমন, ডিফল্ট হিসেবে, কোনও স্ট্রিং $1,00-এর পরিবর্তে $1.00 হিসেবে ফর্ম্যাট করা হয়।
snippet.messageType	unsigned integer পেড মেসেজের জন্য লেভেল। মনে রাখবেন, কোনও liveChatMessage রিসোর্স Super Chat মেসেজ শনাক্ত করলে, snippet.superChatDetails.tier প্রপার্টিতে এই ভ্যালু থাকে। মেসেজ কেনার জন্য খরচ করা টাকার পরিমাণের উপর ভিত্তি করে টিয়ার নির্ধারণ করা হয়। এছাড়াও, এটি লাইভ চ্যাট UI-তে মেসেজ হাইলাইট করার জন্য ব্যবহৃত রঙ, মেসেজের সর্বাধিক দৈর্ঘ্য এবং কতক্ষণ মেসেজটি টিকারে পিন করা থাকবে তা নির্ধারণ করে। Super Chat লেভেল YouTube সহায়তা কেন্দ্রে ডকুমেন্ট করা আছে। (Super Chat কেনাকাটার বিবরণ সম্পর্কে আরও জানতে, প্রসারিত করা যায় এমন বিভাগটি দেখুন।) সেই তালিকায়, সবচেয়ে কম ক্রয়ের অঙ্ক সহ টিয়ার হল টিয়ার ১, এর পরের সবচেয়ে কম অঙ্ক হল টিয়ার ২ এবং এইভাবে চলতে থাকে।
snippet.isSuperStickerEvent	boolean রিসোর্সটি Super Sticker কিনা তা নির্দেশ করে, যা একটি নির্দিষ্ট ধরনের Super Chat মেসেজ যার সাথে একটি ছবি যুক্ত থাকে। এই ফিল্ডের ভ্যালু true হলে, superStickerMetadata ফিল্ডে এমন তথ্য থাকবে যা ছবি দেখানোর জন্য ব্যবহার করা যেতে পারে।
snippet.superStickerMetadata	object Super Sticker সম্পর্কে বিবরণ। snippet.isSuperStickerEvent ফিল্ডের ভ্যালু true হলে তবেই এই অবজেক্ট রিটার্ন করা হয়।
snippet.superStickerMetadata.stickerId	string একটি অনন্য আইডি যা স্টিকারের ছবি শনাক্ত করে। মনে রাখবেন, ব্যবহারকারীরা YouTube-এ চ্যাট উইন্ডো দেখলে তবেই ছবিটি Super Sticker মেসেজের অংশ হিসেবে দেখানো হয়। তবে, API-এর মাধ্যমে ছবির URL উপলভ্য নয়। শুধুমাত্র রেফারেন্সের জন্য, এই CSV ফাইলে কোন স্টিকার আইডি কোন Super Sticker-এর সাথে সম্পর্কিত তা আপনি খুঁজে পেতে পারেন।
snippet.superStickerMetadata.altText	string স্টিকারের বিবরণ সহ টেক্সট স্ট্রিং। snippet.superStickerMetadata.language ফিল্ড টেক্সটের ভাষা শনাক্ত করে। superChatEvents.list মেথড কল করার সময়, টেক্সটের জন্য পছন্দসই ভাষায় hl প্যারামিটারের ভ্যালু সেট করুন।
snippet.superStickerMetadata.language	string snippet.superStickerMetadata.altText প্রপার্টি ভ্যালুর ভাষা। Super Sticker-এ কোনও টেক্সট দেখানো হলে, সেটিও এই ভাষায় লেখা হয়।