LiveChatMessages

একটি liveChatMessage রিসোর্স হলো ইউটিউব লাইভ চ্যাটের একটি চ্যাট মেসেজ। এই রিসোর্সটিতে বিভিন্ন ধরনের মেসেজের বিবরণ থাকতে পারে, যার মধ্যে নতুন পোস্ট করা টেক্সট মেসেজ বা ফ্যান ফান্ডিং ইভেন্ট অন্তর্ভুক্ত।

লাইভ সম্প্রচারের জন্য লাইভ চ্যাট ফিচারটি ডিফল্টরূপে চালু থাকে এবং লাইভ ইভেন্টটি চলাকালীন এটি উপলব্ধ থাকে। (ইভেন্টটি শেষ হয়ে গেলে, সেই ইভেন্টের জন্য লাইভ চ্যাট আর উপলব্ধ থাকে না।)

পদ্ধতি

API-টি liveChatMessages রিসোর্সগুলির জন্য নিম্নলিখিত পদ্ধতিগুলি সমর্থন করে:

list
একটি নির্দিষ্ট চ্যাটের লাইভ চ্যাট বার্তাগুলো তালিকাভুক্ত করে। এখনই চেষ্টা করুন
streamList
কম ল্যাটেন্সিতে একটি নির্দিষ্ট চ্যাটের লাইভ চ্যাট বার্তা গ্রহণ করার জন্য সার্ভার-স্ট্রিমিং সংযোগ সক্ষম করে। এখনই চেষ্টা করুন
insert
লাইভ চ্যাটে একটি বার্তা বা পোল যোগ করে। এখনই চেষ্টা করুন
transition
একটি লাইভ বার্তার অবস্থা পরিবর্তন করে। এখনই চেষ্টা করুন
delete
একটি চ্যাট বার্তা মুছে দেয়। এপিআই অনুরোধটি অবশ্যই চ্যানেল মালিক অথবা লাইভ চ্যাটের একজন মডারেটর দ্বারা অনুমোদিত হতে হবে। এখনই চেষ্টা করুন

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত JSON কাঠামোটি একটি liveChatMessages রিসোর্সের ফরম্যাট দেখায়:

{
  "kind": "youtube#liveChatMessage",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "liveChatId": string,
    "authorChannelId": string,
    "publishedAt": datetime,
    "hasDisplayContent": boolean,
    "displayMessage": string,
    "fanFundingEventDetails": {
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "userComment": string
    },
    "textMessageDetails": {
      "messageText": string
    },
    "messageDeletedDetails": {
      "deletedMessageId": string
    },
    "userBannedDetails": {
      "bannedUserDetails": {
        "channelId": string,
        "channelUrl": string,
        "displayName": string,
        "profileImageUrl": string
      },
      "banType": string,
      "banDurationSeconds": unsigned long
    },
    "memberMilestoneChatDetails": {
      "userComment": string,
      "memberMonth": unsigned integer,
      "memberLevelName": string
    },
    "newSponsorDetails": {
      "memberLevelName": string,
      "isUpgrade": bool
    },
    "superChatDetails": {
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "userComment": string,
      "tier": unsigned integer
    },
    "superStickerDetails": {
      "superStickerMetadata": {
        "stickerId": string,
        "altText": string,
        "language": string
      },
      "amountMicros": unsigned long,
      "currency": string,
      "amountDisplayString": string,
      "tier": unsigned integer
    },
    "pollDetails": {
      "metadata": {
        "options": {
          "optionText": string,
          "tally": string,
        },
        "questionText": string,
        "status": enum
      },
    },
    "membershipGiftingDetails": {
      "giftMembershipsCount": integer,
      "giftMembershipsLevelName": string
    },
    "giftMembershipReceivedDetails": {
      "memberLevelName": string,
      "gifterChannelId": string,
      "associatedMembershipGiftingMessageId": string
    },
      "giftEventDetails": {
      "giftMetadata": {
        "jewelsAmount": integer,
        "giftName": string,
        "giftUrl": string,
        "giftDuration": object,
        "seconds": integer,
        "nanos": integer,
        "hasVisualEffect": boolean,
        "comboCount": integer,
        "altText": string,
        "language": string
      },
    },
  },
  "authorDetails": {
    "channelId": string,
    "channelUrl": string,
    "displayName": string,
    "profileImageUrl": string,
    "isVerified": boolean,
    "isChatOwner": boolean,
    "isChatSponsor": boolean,
    "isChatModerator": boolean
  },
}

বৈশিষ্ট্য

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

বৈশিষ্ট্য
kind string
এপিআই রিসোর্সের ধরন শনাক্ত করে। এর মান হবে youtube#liveChatMessage
etag etag
এই রিসোর্সের ই-ট্যাগ।
id string
যে আইডিটি ইউটিউব বার্তাটিকে অনন্যভাবে শনাক্ত করার জন্য নির্ধারণ করে।
snippet object
snippet অবজেক্টটিতে চ্যাট বার্তা সম্পর্কিত মূল বিবরণ থাকে।
snippet. type string
বার্তার ধরণ। এই প্রপার্টিটি সর্বদা উপস্থিত থাকে এবং এর মান নির্ধারণ করে যে রিসোর্সটিতে কোন কোন ফিল্ড উপস্থিত থাকবে।

এই প্রপার্টির জন্য বৈধ মানগুলি হলো:
  • chatEndedEvent – ​​চ্যাটটি শেষ হয়ে গেছে এবং এর পরে আর কোনো বার্তা যোগ করা যাবে না। একটি ব্রডকাস্ট শেষ হওয়ার কিছুক্ষণ পরে এটি স্বাভাবিকভাবেই ঘটে। চ্যানেলের ডিফল্ট ব্রডকাস্টে লাইভ চ্যাটের জন্য এই ধরনের বার্তা পাঠানো হয় না।
  • messageDeletedEvent – ​​একজন মডারেটর একটি বার্তা মুছে দিয়েছেন। author ফিল্ডে মডারেটরের বিবরণ থাকে। এই ইভেন্টের কোনো প্রদর্শিত বিষয়বস্তু নেই।
  • sponsorOnlyModeEndedEvent – ​​চ্যাটটি আর শুধুমাত্র স্পনসরদের জন্য নির্দিষ্ট মোডে নেই, যার অর্থ হলো যারা স্পনসর নন, তারাও এখন বার্তা পাঠাতে পারবেন। এই ইভেন্টটির কোনো প্রদর্শিত বিষয়বস্তু নেই।
  • sponsorOnlyModeStartedEvent – ​​চ্যাটটি শুধুমাত্র স্পনসরদের জন্য নির্ধারিত মোডে প্রবেশ করেছে, যার অর্থ হলো কেবল স্পনসররাই বার্তা পাঠাতে পারবেন। এই ইভেন্টের কোনো প্রদর্শিত বিষয়বস্তু নেই।
  • newSponsorEvent – ​​একজন নতুন ব্যবহারকারী লাইভ চ্যাটের মালিকানাধীন চ্যানেলটি স্পনসর করেছেন। author ফিল্ডগুলিতে নতুন স্পনসরের বিবরণ রয়েছে।
  • memberMilestoneChatEvent – ​​একজন ব্যবহারকারী একটি মেম্বার মাইলস্টোন চ্যাট পাঠিয়েছেন।
  • superChatEvent – ​​একজন ব্যবহারকারী একটি সুপার চ্যাট কিনেছেন।
  • superStickerEvent – ​​একজন ব্যবহারকারী একটি সুপার স্টিকার কিনেছেন।
  • textMessageEvent – ​​একজন ব্যবহারকারী একটি টেক্সট মেসেজ পাঠিয়েছেন।
  • tombstone – একটি টুম্বস্টোন বোঝায় যে এই আইডি এবং প্রকাশের সময় সহ একটি বার্তা আগে বিদ্যমান ছিল, কিন্তু পরে তা মুছে ফেলা হয়েছে। কোনো বার্তা মুছে ফেলার সাথে সাথে এটি পাঠানো হয় না, বরং মুছে ফেলার আগে বার্তাটি কোথায় ছিল তা বোঝানোর জন্য এটি দেখানো হয়। এই ধরনের বার্তায় শুধুমাত্র snippet.liveChatId , snippet.type , এবং snippet.publishedAt ফিল্ডগুলো উপস্থিত থাকে।
  • userBannedEvent – ​​একজন ব্যবহারকারীকে একজন মডারেটর কর্তৃক নিষিদ্ধ করা হয়েছে। author ফিল্ডে মডারেটরের বিবরণ থাকে।
  • membershipGiftingEvent – ​​একজন ব্যবহারকারী অন্যান্য দর্শকদের জন্য সদস্যপদ কিনেছেন।
  • giftMembershipReceivedEvent – ​​একজন ব্যবহারকারী একটি উপহার সদস্যপদ পেয়েছেন।
  • pollDetails – একজন ব্যবহারকারী একটি লাইভ পোল তৈরি করেছেন।
  • giftEvent – ​​একজন ব্যবহারকারী একটি উপহারের জন্য জুয়েলস রিডিম করেছেন।
snippet. liveChatId string
যে আইডিটি বার্তাটির সাথে যুক্ত লাইভ চ্যাটটিকে অনন্যভাবে শনাক্ত করে। একটি ব্রডকাস্টের সাথে যুক্ত লাইভ চ্যাট আইডিটি liveBroadcast রিসোর্সের snippet.liveChatId প্রপার্টিতে ফেরত দেওয়া হয়।
snippet. authorChannelId string
বার্তাটির লেখকের আইডি। এই ক্ষেত্রটি শুধুমাত্র নিম্নলিখিত বার্তা প্রকারগুলির জন্য পূরণ করা হয়:
  • মেসেজের ধরণ যদি textMessageEvent হয়, তাহলে প্রপার্টির মানটি মেসেজটি লেখা ব্যবহারকারীকে শনাক্ত করে।
  • বার্তার ধরণ যদি fanFundingEvent হয়, তাহলে প্রপার্টি ভ্যালুটি সেই ব্যবহারকারীকে শনাক্ত করে যিনি সম্প্রচারটিতে অর্থায়ন করেছেন।
  • মেসেজের ধরণ যদি messageDeletedEvent হয়, তাহলে প্রপার্টি ভ্যালুটি সেই মডারেটরকে শনাক্ত করে যিনি মেসেজটি ডিলিট করেছেন।
  • মেসেজের ধরণ যদি newSponsorEvent হয়, তাহলে প্রপার্টির মানটি সেই ব্যবহারকারীকে শনাক্ত করে যিনি এইমাত্র স্পনসর হয়েছেন।
  • বার্তার ধরণ যদি memberMilestoneChatEvent হয়, তাহলে প্রপার্টির মানটি বার্তা প্রেরণকারী সদস্যকে শনাক্ত করে।
  • মেসেজের ধরণ যদি userBannedEvent হয়, তাহলে প্রপার্টি ভ্যালুটি সেই মডারেটরকে শনাক্ত করে যিনি ব্যবহারকারীকে ব্যান করেছেন।
  • মেসেজের ধরণ যদি membershipGiftingEvent হয়, তাহলে প্রপার্টির মানটি সেই ব্যবহারকারীকে শনাক্ত করে যিনি মেম্বারশিপ গিফটিং ক্রয়টি করেছেন।
  • মেসেজের ধরণ যদি giftMembershipReceivedEvent হয়, তাহলে প্রপার্টির মানটি সেই ব্যবহারকারীকে শনাক্ত করে যিনি উপহার সদস্যপদটি পেয়েছেন।
  • মেসেজের ধরণ যদি pollEvent হয়, তাহলে প্রপার্টি ভ্যালুটি সেই ব্যবহারকারীকে শনাক্ত করে যিনি একটি লাইভ পোল তৈরি করেছেন।
  • বার্তার ধরণ যদি giftEvent হয়, তাহলে প্রপার্টির মানটি উপহার প্রেরণকারী ব্যবহারকারীকে শনাক্ত করে।
snippet. publishedAt datetime
বার্তাটি প্রথম প্রকাশের তারিখ ও সময়। মানটি ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) ফরম্যাটে নির্দিষ্ট করা হয়।
snippet. hasDisplayContent boolean
বার্তাটিতে ব্যবহারকারীদের দেখানোর মতো কোনো বিষয়বস্তু আছে কি না, তা নির্দেশ করে।
snippet. displayMessage string
এতে একটি স্ট্রিং থাকে যা ব্যবহারকারীদের দেখানো হয়। মেসেজের ধরন chatEndedEvent বা tombstone হলে এই ফিল্ডটি উপস্থিত থাকে না।
snippet. fanFundingEventDetails object
দ্রষ্টব্য: এই অবজেক্ট এবং এর চাইল্ড প্রোপার্টিগুলো অপ্রচলিত ঘোষণা করা হয়েছে। ২৮শে ফেব্রুয়ারী, ২০১৭ থেকে, liveChatMessage রিসোর্সগুলো আর ফ্যান ফান্ডিং ইভেন্টের বিবরণ প্রদান করবে না।

এই অবজেক্টটিতে অর্থায়ন ইভেন্ট সম্পর্কিত বিস্তারিত তথ্য থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন মেসেজের ধরণ fanFundingEvent হয়।
snippet.fanFundingEventDetails. amountMicros unsigned long
দ্রষ্টব্য: এই প্রপার্টিটি অপ্রচলিত হয়ে গেছে।

তহবিলের পরিমাণ।
snippet.fanFundingEventDetails. currency string
দ্রষ্টব্য: এই প্রপার্টিটি অপ্রচলিত হয়ে গেছে।

যে মুদ্রায় তহবিলটি গঠন করা হয়েছিল।
snippet.fanFundingEventDetails. amountDisplayString string
দ্রষ্টব্য: এই প্রপার্টিটি অপ্রচলিত হয়ে গেছে।

একটি রেন্ডার করা স্ট্রিং যা ব্যবহারকারীকে তহবিলের পরিমাণ এবং মুদ্রা প্রদর্শন করে।
snippet.fanFundingEventDetails. userComment string
দ্রষ্টব্য: এই প্রপার্টিটি অপ্রচলিত হয়ে গেছে।

এই ফ্যান ফান্ডিং ইভেন্টে ব্যবহারকারীর যোগ করা মন্তব্য।
snippet. textMessageDetails object
এই অবজেক্টটিতে টেক্সট মেসেজ সম্পর্কিত বিস্তারিত তথ্য থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন মেসেজের ধরণ textMessageEvent হয়।
snippet.textMessageDetails. messageText string
ব্যবহারকারীর বার্তা।
snippet. messageDeletedDetails object
এই অবজেক্টটিতে চ্যাট মডারেটর অথবা লাইভ ব্রডকাস্ট চ্যানেলের মালিক কর্তৃক মুছে ফেলা কোনো বার্তার বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন বার্তার ধরনটি messageDeletedEvent হয়।
snippet.messageDeletedDetails. deletedMessageId string
যে আইডিটি মুছে ফেলা বার্তাটিকে অনন্যভাবে শনাক্ত করে। এর মান মূল টেক্সট মেসেজের id প্রপার্টির মানের সমান। উদাহরণস্বরূপ, যদি একটি textMessageEvent এর id প্রপার্টির মান 123 হয়, এবং সেই বার্তাটি পরবর্তীতে মুছে ফেলা হয়, তাহলে সেই বার্তার জন্য ' snippet.messageDeletedDetails.deletedMessageId এর মান হবে 123

চ্যাট বার্তাগুলো পুনরুদ্ধার করার পর যদি আপনি সেগুলো ক্যাশ করে রাখেন, তাহলে যে বার্তাটি আর প্রদর্শন করা উচিত নয়, তা শনাক্ত করতে এই প্রপার্টির মানটি ব্যবহার করুন।
snippet. userBannedDetails object
এই অবজেক্টটিতে চ্যাট থেকে নিষিদ্ধ হওয়া একজন ব্যবহারকারীর বিবরণ রয়েছে। এতে নিষেধাজ্ঞাটি সম্পর্কেও বিস্তারিত তথ্য থাকে। ব্যবহারকারীদের চ্যাট থেকে স্থায়ীভাবে বা অস্থায়ীভাবে নিষিদ্ধ করা যেতে পারে।
snippet.userBannedDetails. bannedUserDetails object
এই অবজেক্টটিতে নিষিদ্ধ ব্যবহারকারীর তথ্য রয়েছে।
snippet.userBannedDetails.bannedUserDetails. channelId string
নিষিদ্ধ ব্যবহারকারীর ইউটিউব চ্যানেল আইডি।
snippet.userBannedDetails.bannedUserDetails. channelUrl string
নিষিদ্ধ ব্যবহারকারীর ইউটিউব চ্যানেলের ইউআরএল।
snippet.userBannedDetails.bannedUserDetails. displayName string
নিষিদ্ধ ব্যবহারকারীর ইউটিউব চ্যানেলের প্রদর্শিত নাম।
snippet.userBannedDetails.bannedUserDetails. profileImageUrl string
নিষিদ্ধ ব্যবহারকারীর ইউটিউব চ্যানেলের অ্যাভাটার।
snippet.userBannedDetails. banType string
নিষেধাজ্ঞার ধরণ। এই বৈশিষ্ট্যের জন্য বৈধ মানগুলি হলো:
  • স্থায়ী
  • অস্থায়ী
snippet.userBannedDetails. banDurationSeconds unsigned long
নিষেধাজ্ঞার সময়কাল। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকে যখন snippet.userBannedDetails.banType প্রপার্টির মান temporary হয়।
snippet. memberMilestoneChatDetails object
এই অবজেক্টটিতে একটি মেম্বার মাইলস্টোন ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন মেসেজের ধরণটি memberMilestoneChatEvent হয়।
snippet.memberMilestoneChatDetails. userComment string
এই মেম্বার মাইলস্টোন চ্যাটে সদস্যের যোগ করা মন্তব্য। সদস্যের মন্তব্যবিহীন বার্তাগুলির জন্য এই ক্ষেত্রটি খালি থাকে।
snippet.memberMilestoneChatDetails. memberMonth unsigned integer
দর্শক মোট যত মাস (পূর্ণসংখ্যায় পূর্ণ) ধরে সদস্য আছেন, যার ফলে তিনি এই মেম্বার মাইলস্টোন চ্যাটটি পেয়েছেন। ইউটিউব ব্যবহারকারীদের কাছেও এই একই সংখ্যক মাস দেখানো হচ্ছে।
snippet.memberMilestoneChatDetails. memberLevelName string
দর্শক যে লেভেলের সদস্য, তার নাম। মেম্বারশিপ প্রদানকারী ইউটিউব চ্যানেল লেভেলের নামগুলো নির্ধারণ করে দেয়। কিছু ক্ষেত্রে এই ফিল্ডটি পূরণ করা থাকে না।
snippet. newSponsorDetails object
এই অবজেক্টটিতে নতুন সদস্য ঘোষণা ইভেন্ট সম্পর্কিত বিবরণ রয়েছে। এটি শুধুমাত্র তখনই সেট করা হয় যখন টাইপটি newSponsorEvent হয়। "Member" শব্দটি "sponsor"-এর জন্য ব্যবহৃত হয়।
snippet.newSponsorDetails. memberLevelName string
দর্শক যে লেভেলের সদস্য, তার নাম। মেম্বারশিপ প্রদানকারী ইউটিউব চ্যানেলটি লেভেলের নামগুলো নির্ধারণ করে দেয়। কিছু ক্ষেত্রে, এই ফিল্ডটি পূরণ করা থাকে না।
snippet.newSponsorDetails. isUpgrade bool
দর্শক নিম্নতর স্তর থেকে আপগ্রেড করেছেন কিনা তা নির্দেশ করে। ক্রয়ের সময় যে সকল দর্শক সদস্য ছিলেন না, তাদের ক্ষেত্রে ফিল্ডটির মান false হয়।
snippet. superChatDetails object
এই অবজেক্টটিতে একটি সুপার চ্যাট ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন মেসেজের ধরণ superChatEvent হয়।
snippet.superChatDetails. amountMicros unsigned long
ক্রয়ের পরিমাণ, যা ক্রয় মুদ্রার মাইক্রো এককে প্রকাশ করা হয়। উদাহরণস্বরূপ, যদি ক্রয়ের পরিমাণ এক ডলার হয়, তাহলে snippet.amountMicros প্রপার্টির মান হবে 1000000
snippet.superChatDetails. currency string
যে মুদ্রায় ক্রয়টি করা হয়েছিল। মানটি একটি ISO 4217 মুদ্রা কোড।
snippet.superChatDetails. amountDisplayString string
$1.00 মতো একটি স্ট্রিং, যাতে ক্রয়ের পরিমাণ এবং মুদ্রা থাকে। এই স্ট্রিংটি ব্যবহারকারীকে দেখানোর জন্য তৈরি করা হয়েছে।
snippet.superChatDetails. userComment string
এই সুপার চ্যাট ইভেন্টে ব্যবহারকারীর যোগ করা মন্তব্যটি।
snippet.superChatDetails. tier unsigned integer
পেইড মেসেজের জন্য স্তর। উল্লেখ্য যে, একটি superChatEvent রিসোর্সে, snippet.messageType প্রপার্টিতে এই মানটি থাকে।

মেসেজটি কেনার জন্য ব্যয় করা অর্থের পরিমাণের উপর ভিত্তি করে টিয়ার নির্ধারণ করা হয়। এটি লাইভ চ্যাট UI-তে মেসেজটি হাইলাইট করার জন্য ব্যবহৃত রঙ, মেসেজের সর্বোচ্চ দৈর্ঘ্য এবং মেসেজটি টিকারে কতক্ষণ পিন করা থাকবে, তাও নির্ধারণ করে।

সুপার চ্যাটের স্তরগুলো ইউটিউব হেল্প সেন্টারে নথিভুক্ত করা আছে। (সুপার চ্যাট কেনার বিবরণ সম্পর্কিত বিস্তারিত অংশটি দেখুন।) সেই তালিকায়, সর্বনিম্ন ক্রয়মূল্যের স্তরটি হলো স্তর ১, তার পরের সর্বনিম্ন মূল্যের স্তরটি হলো স্তর ২, এবং এভাবেই চলতে থাকে।
snippet. superStickerDetails object
এই অবজেক্টটিতে একটি সুপার স্টিকার ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন মেসেজ টাইপটি superStickerEvent হয়।
snippet.superStickerDetails. superStickerMetadata object
সুপার স্টিকার সম্পর্কে বিস্তারিত তথ্য।
snippet.superStickerDetails.superStickerMetadata. stickerId string
একটি অনন্য আইডি যা স্টিকার ইমেজটিকে শনাক্ত করে। উল্লেখ্য যে, ব্যবহারকারীরা যখন ইউটিউবে চ্যাট উইন্ডো দেখেন, তখন সুপার স্টিকার বার্তার অংশ হিসেবে ছবিটি প্রদর্শিত হয়। তবে, এপিআই (API) ব্যবহার করে ছবির ইউআরএল (URL) পাওয়া যায় না। শুধুমাত্র তথ্যের জন্য, আপনি এই সিএসভি (CSV) ফাইলটিতে খুঁজে নিতে পারেন কোন স্টিকার আইডিগুলো কোন সুপার স্টিকারের সাথে সম্পর্কিত।
snippet.superStickerDetails.superStickerMetadata. altText string
একটি টেক্সট স্ট্রিং যা স্টিকারটির বর্ণনা দেয়। snippet.superStickerDetails.superStickerMetadata.language ফিল্ডটি টেক্সটটির ভাষা নির্ধারণ করে। liveChatMessages.list মেথডটি কল করার সময়, টেক্সটটির জন্য নির্বাচিত ভাষায় hl প্যারামিটারের মান সেট করুন।
snippet.superStickerDetails.superStickerMetadata. language string
snippet.superStickerDetails.superStickerMetadata.altText প্রপার্টির মানের ভাষা।
snippet.superStickerDetails. amountMicros unsigned long
ক্রয়ের পরিমাণ, যা ক্রয় মুদ্রার মাইক্রো এককে প্রকাশ করা হয়। উদাহরণস্বরূপ, যদি ক্রয়ের পরিমাণ এক ডলার হয়, তাহলে snippet.amountMicros প্রপার্টির মান হবে 1000000
snippet.superStickerDetails. currency string
যে মুদ্রায় ক্রয়টি করা হয়েছিল। মানটি একটি ISO 4217 মুদ্রা কোড।
snippet.superStickerDetails. amountDisplayString string
$1.00 মতো একটি স্ট্রিং, যাতে ক্রয়ের পরিমাণ এবং মুদ্রা থাকে। এই স্ট্রিংটি ব্যবহারকারীকে দেখানোর জন্য তৈরি করা হয়েছে।
snippet.superStickerDetails. tier unsigned integer
পেইড মেসেজের জন্য স্তর। উল্লেখ্য যে, একটি superChatEvent রিসোর্সে, snippet.messageType প্রপার্টিতে এই মানটি থাকে।

মেসেজটি কেনার জন্য ব্যয় করা অর্থের পরিমাণের উপর ভিত্তি করে টিয়ার নির্ধারণ করা হয়। এটি লাইভ চ্যাট UI-তে মেসেজটি হাইলাইট করার জন্য ব্যবহৃত রঙ, মেসেজের সর্বোচ্চ দৈর্ঘ্য এবং মেসেজটি টিকারে কতক্ষণ পিন করা থাকবে, তাও নির্ধারণ করে।

সুপার চ্যাট টিয়ারগুলো, যার মধ্যে সুপার স্টিকারও অন্তর্ভুক্ত, ইউটিউব হেল্প সেন্টারে নথিভুক্ত করা আছে। (সুপার চ্যাট কেনার বিস্তারিত তথ্যের জন্য এক্সপ্যান্ডেবল সেকশনটি দেখুন।) সেই তালিকায়, সর্বনিম্ন ক্রয়মূল্যের টিয়ারটি হলো টিয়ার ১, তার পরের সর্বনিম্ন মূল্যের টিয়ারটি হলো টিয়ার ২, এবং এভাবেই চলতে থাকে।
snippet. pollDetails object
এই অবজেক্টটিতে একটি পোল ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন মেসেজের ধরণ pollEvent হয়।
snippet.pollDetails. metadata object
ভোটগ্রহণ অনুষ্ঠান সম্পর্কিত বিস্তারিত তথ্য।
snippet.pollDetails.metadata. options object
লাইভ পোলের বিকল্পগুলো।
snippet.pollDetails.metadata.options. optionText string
লাইভ পোল বিকল্পটির লেখা।
snippet.pollDetails.metadata.options. tally string
লাইভ পোল বিকল্পের গণনা। এই গণনা শুধুমাত্র তখনই দেখা যায়, যখন চ্যানেল মালিক কর্তৃক এপিআই অনুরোধটি অনুমোদিত হয়।
snippet.pollDetails.metadata. questionText string
সরাসরি ভোটের প্রশ্নের পাঠ্য।
snippet.pollDetails.metadata. status enum
লাইভ পোল ইভেন্টের অবস্থা। এই প্রপার্টির জন্য বৈধ মানগুলো হলো:
  • unknown
  • active
  • closed
snippet. membershipGiftingDetails object
এই অবজেক্টটিতে একটি মেম্বারশিপ গিফটিং ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন message type membershipGiftingEvent হয়।
snippet.membershipGiftingDetails. giftMembershipsCount integer
ব্যবহারকারীর কেনা উপহার সদস্যপদের সংখ্যা।
snippet.membershipGiftingDetails. giftMembershipsLevelName string
ব্যবহারকারীর কেনা গিফট মেম্বারশিপের লেভেলের নাম। মেম্বারশিপ প্রদানকারী ইউটিউব চ্যানেল লেভেলের নাম নির্ধারণ করে দেয়। কিছু ক্ষেত্রে, এই ফিল্ডটি পূরণ করা হয় না।
snippet. giftMembershipReceivedDetails object
এই অবজেক্টটিতে একটি 'Gift Membership Received' ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন message type giftMembershipReceivedEvent ' হয়।
snippet.giftMembershipReceivedDetails. memberLevelName string
দর্শক যে লেভেলের সদস্য, এটি সেই লেভেলের নাম। এটি সংশ্লিষ্ট মেম্বারশিপ গিফটিং মেসেজের snippet.membershipGiftingDetails.giftMembershipsLevelName এর সাথে মেলে। মেম্বারশিপ প্রদানকারী ইউটিউব চ্যানেল দ্বারা লেভেলের নামগুলো নির্ধারিত হয়। কিছু ক্ষেত্রে, এই ফিল্ডটি পূরণ করা হয় না।
snippet.giftMembershipReceivedDetails. gifterChannelId string
যে ব্যবহারকারী মেম্বারশিপ গিফটিং ক্রয় করেছেন তার আইডি। এটি সংশ্লিষ্ট মেম্বারশিপ গিফটিং মেসেজের snippet.authorChannelId এর সাথে মেলে।
snippet.giftMembershipReceivedDetails. associatedMembershipGiftingMessageId string
এই উপহার সদস্যপদের সাথে সম্পর্কিত সদস্যপদ উপহার বার্তার আইডি। এই আইডিটি সর্বদা এমন একটি বার্তাকে নির্দেশ করবে যার type হলো membershipGiftingEvent
snippet. giftEventDetails object
এই অবজেক্টটিতে একটি উপহার ইভেন্ট সম্পর্কিত বিবরণ থাকে। এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন message type giftEvent হয়।
snippet.giftEventDetails. giftMetadata object
উপহার অনুষ্ঠান সম্পর্কিত বিস্তারিত তথ্য।
snippet.giftEventDetails.giftMetadata. jewelsAmount integer
উপহারটির জন্য রিডিম করা জুয়েলের পরিমাণ।
snippet.giftEventDetails.giftMetadata. giftName string
উপহারটির নাম।
snippet.giftEventDetails.giftMetadata. giftUrl string
উপহার সম্পদটির ইউআরএল।
snippet.giftEventDetails.giftMetadata. giftDuration object
উপহারের ইউআরএল প্রদর্শনের সময়কাল।
snippet.giftEventDetails.giftMetadata.giftDuration. seconds integer
উপহারের ইউআরএলটি প্রদর্শন করতে কত সেকেন্ড সময় লাগবে।
snippet.giftEventDetails.giftMetadata.giftDuration. nanos integer
উপহারের ইউআরএলটি প্রদর্শন করতে প্রয়োজনীয় ন্যানোসেকেন্ডের সংখ্যা।
snippet.giftEventDetails.giftMetadata. hasVisualEffect boolean
উপহারটির কোনো দৃশ্যগত প্রভাব আছে কি না।
snippet.giftEventDetails.giftMetadata. comboCount integer
উপহারটির কম্বো সংখ্যা; কম্বো না হলে ০।
snippet.giftEventDetails.giftMetadata. altText string
একটি টেক্সট স্ট্রিং যা উপহারটির বর্ণনা দেয়।
snippet.giftEventDetails.giftMetadata. language string
altText প্রপার্টির মানের ভাষা।
authorDetails object
authorDetails অবজেক্টটিতে এই বার্তাটি পোস্ট করা ব্যবহারকারী সম্পর্কে অতিরিক্ত বিবরণ থাকে।
authorDetails. channelId string
লেখকের ইউটিউব চ্যানেল আইডি।
authorDetails. channelUrl string
লেখকের ইউটিউব চ্যানেলের ইউআরএল।
authorDetails. displayName string
লেখকের ইউটিউব চ্যানেলের প্রদর্শিত নাম।
authorDetails. profileImageUrl string
লেখকের ইউটিউব চ্যানেলের অ্যাভাটার ইউআরএল।
authorDetails. isVerified boolean
এই মানটি নির্দেশ করে যে লেখকের পরিচয় ইউটিউব দ্বারা যাচাই করা হয়েছে কি না।
authorDetails. isChatOwner boolean
এই মানটি নির্দেশ করে যে লেখক লাইভ চ্যাটটির মালিক কিনা।
authorDetails. isChatSponsor boolean
এই মানটি নির্দেশ করে যে লেখক লাইভ চ্যাটের পৃষ্ঠপোষক কিনা।
authorDetails. isChatModerator boolean
এই মানটি নির্দেশ করে যে লেখক লাইভ চ্যাটের মডারেটর কিনা।