একটি superChatEvent রিসোর্স YouTube লাইভ স্ট্রিম চলাকালীন একজন ভক্তের দ্বারা কেনা একটি সুপার চ্যাট বার্তা উপস্থাপন করে। YouTube লাইভ চ্যাট স্ট্রীমে, সুপার চ্যাট দুটি উপায়ে অন্যান্য বার্তা থেকে আলাদা:
- সুপার চ্যাট একটি রঙ দিয়ে হাইলাইট করা হয়।
- সুপার চ্যাট একটি নির্দিষ্ট সময়ের জন্য টিকারে পিন করা থাকে।
সুপার চ্যাটের রঙ, টিকারে এটি কতক্ষণ পিন করা থাকবে এবং সর্বাধিক বার্তার দৈর্ঘ্য সবই কেনার পরিমাণ দ্বারা নির্ধারিত হয়। সুপার চ্যাট সম্পর্কে আরও জানতে YouTube সহায়তা কেন্দ্র দেখুন।
পদ্ধতি
API superChatEvents সংস্থানগুলির জন্য নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:
- list
- আগের 30 দিনের মধ্যে একটি চ্যানেলের লাইভ স্ট্রিম থেকে সুপার চ্যাট ইভেন্টগুলি তালিকাভুক্ত করুন৷ এখনই চেষ্টা করে দেখুন ।
সম্পদ প্রতিনিধিত্ব
নিম্নলিখিত 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 | stringAPI সম্পদের ধরন সনাক্ত করে। মান হবে youtube#superChatEvent । |
etag | etagএই সম্পদের Etag. |
id | stringসুপার চ্যাট ইভেন্টটিকে অনন্যভাবে সনাক্ত করতে YouTube যে আইডি বরাদ্দ করে। |
snippet | objectsnippet অবজেক্টে সুপার চ্যাট ইভেন্ট সম্পর্কে প্রাথমিক বিবরণ রয়েছে। |
snippet. channelId | stringYouTube চ্যানেল আইডি যা সুপার চ্যাট ইভেন্টের সাথে যুক্ত লাইভ স্ট্রিম সম্প্রচার করে এমন চ্যানেলকে শনাক্ত করে। |
snippet. supporterDetails | objectসমর্থকের চ্যানেল সম্পর্কে বিস্তারিত। |
snippet.supporterDetails. channelId | stringসমর্থকের ইউটিউব চ্যানেল আইডি। |
snippet.supporterDetails. channelUrl | stringসমর্থকের চ্যানেলের URL। |
snippet.supporterDetails. displayName | stringসমর্থকের চ্যানেলের প্রদর্শনের নাম। |
snippet.supporterDetails. profileImageUrl | stringসমর্থকের চ্যানেলের জন্য অবতার URL। |
snippet. commentText | stringসমর্থকের মন্তব্য পাঠ্য বিষয়বস্তু. |
snippet. createdAt | datetimeসুপার চ্যাট কেনার তারিখ ও সময়। মানটি 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 সংস্থান একটি সুপার চ্যাট বার্তা সনাক্ত করে, তখন snippet.superChatDetails.tier প্রপার্টিতে এই মান থাকে৷বার্তাটি কেনার জন্য যে পরিমাণ অর্থ ব্যয় করা হয়েছে তার উপর ভিত্তি করে স্তরটি। এটি লাইভ চ্যাট UI-তে বার্তাটি হাইলাইট করতে ব্যবহৃত রঙ, সর্বাধিক বার্তার দৈর্ঘ্য এবং বার্তাটি টিকারের সাথে পিন করার সময় নির্ধারণ করে। সুপার চ্যাটের স্তরগুলি YouTube সহায়তা কেন্দ্রে নথিভুক্ত করা হয়েছে৷ (সুপার চ্যাট কেনাকাটার বিশদ বিবরণ সম্বন্ধে প্রসারণযোগ্য বিভাগটি দেখুন।) সেই তালিকায়, সর্বনিম্ন ক্রয়ের পরিমাণের স্তরটি হল স্তর 1, পরবর্তী সর্বনিম্ন পরিমাণ হল স্তর 2 এবং আরও অনেক কিছু৷ |
snippet. isSuperStickerEvent | booleanসংস্থানটি একটি সুপার স্টিকার কিনা তা নির্দেশ করে, যেটি একটি নির্দিষ্ট ধরণের সুপার চ্যাট বার্তা যার একটি সম্পর্কিত ছবি রয়েছে৷ যদি এই ক্ষেত্রের মান true হয়, তাহলে superStickerMetadata ক্ষেত্রটিতে এমন তথ্য থাকবে যা চিত্রটি প্রদর্শন করতে ব্যবহার করা যেতে পারে। |
snippet. superStickerMetadata | objectসুপার স্টিকার সম্পর্কে বিস্তারিত। snippet.isSuperStickerEvent ক্ষেত্রের মান true হলেই এই বস্তুটি ফেরত দেওয়া হয়। |
snippet.superStickerMetadata. stickerId | stringএকটি অনন্য আইডি যা স্টিকার চিত্রটিকে সনাক্ত করে। মনে রাখবেন যে ব্যবহারকারীরা যখন ইউটিউবে চ্যাট উইন্ডোটি দেখেন তখন ছবিটি শুধুমাত্র সুপার স্টিকার বার্তার অংশ হিসাবে প্রদর্শিত হয়। যাইহোক, ছবির URL API এর মাধ্যমে উপলব্ধ নয়। শুধুমাত্র রেফারেন্সের জন্য, আপনি এই CSV ফাইলে কোন স্টিকার আইডি কোন সুপার স্টিকারের সাথে সম্পর্কিত তা খুঁজে পেতে পারেন। |
snippet.superStickerMetadata. altText | stringএকটি পাঠ্য স্ট্রিং যা স্টিকার বর্ণনা করে। snippet.superStickerMetadata.language ক্ষেত্র পাঠ্যের ভাষা সনাক্ত করে। superChatEvents.list পদ্ধতিতে কল করার সময়, পাঠ্যের জন্য পছন্দসই ভাষায় hl প্যারামিটার মান সেট করুন। |
snippet.superStickerMetadata. language | stringsnippet.superStickerMetadata.altText প্রপার্টির মানের ভাষা। সুপার স্টিকার যদি কোনো টেক্সটও দেখায়, তাহলে সেই টেক্সটটিও এই ভাষায়। |