LiveChatMessages

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

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

পদ্ধতি

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

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

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

নিম্নলিখিত 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
    },
    "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
    },
    "giftDetails": {
      "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
API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#liveChatMessage হবে।
etag etag
এই রিসোর্সের Etag.
id string
মেসেজটি অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি অ্যাসাইন করে।
মনে রাখবেন: giftEvents-এর ক্ষেত্রে, কম্বো সংখ্যা আপডেট করার জন্য একই আইডি আবার ব্যবহার করা হতে পারে।
snippet object
snippet অবজেক্টে চ্যাট মেসেজ সম্পর্কে মূল বিবরণ থাকে।
snippet.type string
মেসেজের ধরন। এই প্রপার্টি সবসময় থাকে এবং এর ভ্যালু নির্ধারণ করে যে রিসোর্সে কোন কোন ফিল্ড আছে।

এই প্রপার্টির জন্য সঠিক ভ্যালু হল:
  • chatEndedEvent – চ্যাট শেষ হয়ে গেছে এবং এর পরে আর কোনও মেসেজ যোগ করা যাবে না। ব্রডকাস্ট শেষ হওয়ার কিছুক্ষণ পরে এটি স্বাভাবিকভাবেই ঘটবে। কোনও চ্যানেলের ডিফল্ট ব্রডকাস্টে লাইভ চ্যাটের জন্য এই ধরনের মেসেজ পাঠানো হয় না।
  • sponsorOnlyModeEndedEvent – চ্যাট আর শুধু স্পনসরদের জন্য মোডে নেই, এর অর্থ হল স্পনসর নন এমন ব্যবহারকারীরা এখন মেসেজ পাঠাতে পারবেন। এই ইভেন্টে দেখানোর মতো কোনও কন্টেন্ট নেই।
  • sponsorOnlyModeStartedEvent – চ্যাটটি শুধু স্পনসরদের জন্য মোডে প্রবেশ করেছে, যার অর্থ হল শুধুমাত্র স্পনসররা মেসেজ পাঠাতে পারবেন। এই ইভেন্টে দেখানোর মতো কোনও কন্টেন্ট নেই।
  • newSponsorEvent – লাইভ চ্যাটের মালিকানাধীন চ্যানেলকে একজন নতুন ব্যবহারকারী স্পনসর করেছেন। author ফিল্ডে নতুন স্পনসরের বিবরণ থাকে।
  • memberMilestoneChatEvent – কোনও ব্যবহারকারী মেম্বার মাইলস্টোন চ্যাট পাঠিয়েছেন।
  • superChatEvent – একজন ব্যবহারকারী Super Chat কিনেছেন।
  • superStickerEvent – একজন ব্যবহারকারী Super Sticker কিনেছেন।
  • textMessageEvent – কোনও ব্যবহারকারী টেক্সট মেসেজ পাঠিয়েছেন।
  • tombstone – কোনও টোমস্টোন থেকে বোঝা যায় যে এই আইডি ও প্রকাশনার সময় সহ একটি মেসেজ আগে ছিল, কিন্তু সেটি এখন মুছে দেওয়া হয়েছে। মেসেজ মুছে দেওয়ার পরে এটি পাঠানো হয় না, বরং মেসেজটি মুছে দেওয়ার আগে কোথায় ছিল তা বোঝাতে এটি দেখানো হয়। এই ধরনের মেসেজে শুধুমাত্র snippet.liveChatId, snippet.type এবং snippet.publishedAt ফিল্ড থাকে।
  • userBannedEvent – কোনও মডারেটর ব্যবহারকারীকে ব্যান করেছেন। author ফিল্ডে মডারেটরের বিবরণ থাকে।
  • membershipGiftingEvent – একজন ব্যবহারকারী অন্য দর্শকদের জন্য মেম্বারশিপ কিনেছেন।
  • giftMembershipReceivedEvent – একজন ব্যবহারকারী গিফ্ট মেম্বারশিপ পেয়েছেন।
  • pollDetails – কোনও ব্যবহারকারী লাইভ পোল তৈরি করেছেন।
  • giftEvent – কোনও ব্যবহারকারী গিফ্টের জন্য Jewels রিডিম করেছেন।
snippet.liveChatId string
মেসেজটি যে লাইভ চ্যাটের সাথে যুক্ত, সেটি অনন্যভাবে শনাক্ত করে এমন আইডি। ব্রডকাস্টের সাথে যুক্ত লাইভ চ্যাট আইডি liveBroadcast রিসোর্সের snippet.liveChatId প্রপার্টিতে ফেরত পাঠানো হয়।
snippet.authorChannelId string
মেসেজটি যে ব্যবহারকারী লিখেছেন তার আইডি। এই ফিল্ডটি শুধুমাত্র নিম্নলিখিত মেসেজের ধরনের জন্য পূরণ করা হয়:
  • মেসেজের ধরন textMessageEvent হলে, প্রপার্টির ভ্যালু সেই ব্যবহারকারীকে শনাক্ত করে যিনি মেসেজটি লিখেছেন।
  • মেসেজের ধরন fanFundingEvent হলে, প্রপার্টি ভ্যালু সেই ব্যবহারকারীকে শনাক্ত করে যিনি ব্রডকাস্টে ফান্ড দিয়েছেন।
  • মেসেজের ধরন 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.userBannedDetails object
এই অবজেক্টে চ্যাট থেকে ব্যান করা হয়েছে এমন ব্যবহারকারীর বিবরণ থাকে। এছাড়াও, এতে ব্যান সম্পর্কে বিবরণ থাকে। কোনও ব্যবহারকারীকে চ্যাট থেকে স্থায়ী বা সাময়িকভাবে নিষিদ্ধ করা হতে পারে।
snippet.userBannedDetails.bannedUserDetails object
এই অবজেক্টে নিষিদ্ধ ব্যবহারকারী সম্পর্কে তথ্য থাকে।
snippet.userBannedDetails.bannedUserDetails.channelId string
নিষিদ্ধ ব্যবহারকারীর YouTube চ্যানেল আইডি।
snippet.userBannedDetails.bannedUserDetails.channelUrl string
নিষিদ্ধ ব্যবহারকারীর YouTube চ্যানেলের URL.
snippet.userBannedDetails.bannedUserDetails.displayName string
নিষিদ্ধ ব্যবহারকারীর YouTube চ্যানেলের ডিসপ্লে নাম।
snippet.userBannedDetails.bannedUserDetails.profileImageUrl string
নিষিদ্ধ করা ব্যবহারকারীর YouTube চ্যানেলের অবতার।
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
দর্শক যত মাস (রাউন্ড আপ করা) মেম্বার হিসেবে আছেন, যার জন্য তিনি এই মেম্বার মাইলস্টোন চ্যাট পেয়েছেন। YouTube ব্যবহারকারীদের যত মাস দেখানো হচ্ছে, এটিও ঠিক তত মাস।
snippet.memberMilestoneChatDetails.memberLevelName string
দর্শক যে লেভেলের মেম্বার, সেই লেভেলের নাম। মেম্বারশিপ অফার করা YouTube চ্যানেল লেভেলের নাম নির্ধারণ করে। কিছু পরিস্থিতিতে এই ফিল্ড পূরণ করা হয় না।
snippet.newSponsorDetails object
এই অবজেক্টে নতুন মেম্বার ঘোষণা সংক্রান্ত ইভেন্টের বিবরণ থাকে। এটি শুধুমাত্র তখনই সেট করা হয় যখন ধরনটি newSponsorEvent হয়। "মেম্বার" শব্দটি "স্পনসর" শব্দের সমার্থক।
snippet.newSponsorDetails.memberLevelName string
যে লেভেলে ভিউয়ার মেম্বার, সেটির নাম। মেম্বারশিপ অফার করা YouTube চ্যানেল লেভেলের নাম নির্ধারণ করে। কিছু কিছু ক্ষেত্রে, এই ফিল্ড পূরণ করা হয় না।
snippet.newSponsorDetails.isUpgrade bool
দর্শক কি সম্প্রতি নিম্ন লেভেল থেকে আপগ্রেড করেছেন তা নির্দেশ করে। যেসব দর্শক কেনাকাটার সময় মেম্বার ছিলেন না, তাদের ক্ষেত্রে ফিল্ড ভ্যালু হল false।
snippet.superChatDetails object
এই অবজেক্টে Super Chat ইভেন্ট সম্পর্কে বিবরণ থাকে। মেসেজের ধরন 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
এই Super Chat ইভেন্টে ব্যবহারকারীর যোগ করা কমেন্ট।
snippet.superChatDetails.tier unsigned integer
পেড মেসেজের টিয়ার। মনে রাখবেন যে superChatEvent রিসোর্সে, snippet.messageType প্রপার্টিতে এই ভ্যালু থাকে।

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

Super Chat-এর টিয়ার YouTube সহায়তা কেন্দ্রে ডকুমেন্ট করা আছে। (Super Chat কেনাকাটার বিবরণ সম্পর্কে বড় করা যায় এমন বিভাগ দেখুন।) সেই তালিকায়, সবচেয়ে কম ক্রয়ের অঙ্ক সহ টিয়ার হল টিয়ার ১, এর পরের সবচেয়ে কম অঙ্ক হল টিয়ার ২ এবং এইভাবে চলতে থাকে।
snippet.superStickerDetails object
এই অবজেক্টে Super Sticker ইভেন্ট সম্পর্কিত বিবরণ থাকে। মেসেজের ধরন superStickerEvent হলে তবেই এটি দেখা যায়।
snippet.superStickerDetails.superStickerMetadata object
Super Sticker সম্পর্কিত বিবরণ।
snippet.superStickerDetails.superStickerMetadata.stickerId string
স্টিকারের ছবি শনাক্তকারী অনন্য আইডি। মনে রাখবেন, ব্যবহারকারীরা YouTube-এ চ্যাট উইন্ডো দেখলে তবেই ছবিটি Super Sticker মেসেজের অংশ হিসেবে দেখানো হয়। তবে, API ব্যবহার করে ছবির URL উপলভ্য নয়। শুধুমাত্র রেফারেন্সের জন্য, কোন স্টিকার আইডি কোন Super Sticker-এর সাথে সম্পর্কিত তা আপনি এই 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-তে মেসেজ হাইলাইট করার জন্য ব্যবহৃত রঙ, মেসেজের সর্বাধিক দৈর্ঘ্য এবং কতক্ষণ মেসেজটি টিকারের সাথে পিন করা থাকবে তা নির্ধারণ করে।

Super Chat টিয়ার, যা Super Stickers-কেও কভার করে, তা YouTube সহায়তা কেন্দ্রে ডকুমেন্ট করা আছে। (Super Chat কেনাকাটার বিবরণ সম্পর্কে বড় করা যায় এমন বিভাগ দেখুন।) ওই তালিকায়, সবচেয়ে কম কেনাকাটার পরিমাণ হল টিয়ার ১, তার পরের কম পরিমাণ হল টিয়ার ২ এবং এই ক্রমে চলতে থাকে।
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
লাইভ পোল বিকল্পের ট্যালি। চ্যানেলের মালিক API অনুরোধ অনুমোদন করলে তবেই ট্যালি দেখানো হয়।
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
ব্যবহারকারীর কেনা গিফ্ট মেম্বারশিপের লেভেলের নাম। যে YouTube চ্যানেল মেম্বারশিপ অফার করছে, সেটি লেভেলের নাম নির্ধারণ করে। কিছু কিছু ক্ষেত্রে, এই ফিল্ড পূরণ করা হয় না।
snippet.giftMembershipReceivedDetails object
এই অবজেক্টে গিফ্ট মেম্বারশিপ পাওয়ার ইভেন্ট সম্পর্কে বিবরণ থাকে। message type-এর মান giftMembershipReceivedEvent হলে তবেই এটি দেখানো হয়।
snippet.giftMembershipReceivedDetails.memberLevelName string
যে লেভেলে ভিউয়ার মেম্বার, সেটির নাম। এটি সংশ্লিষ্ট মেম্বারশিপ গিফ্টিং মেসেজের snippet.membershipGiftingDetails.giftMembershipsLevelName-এর সাথে মিলে যায়। মেম্বারশিপ অফার করা YouTube চ্যানেল লেভেলের নাম নির্ধারণ করে। কিছু কিছু ক্ষেত্রে, এই ফিল্ড পূরণ করা হয় না।
snippet.giftMembershipReceivedDetails.gifterChannelId string
মেম্বারশিপ গিফ্টিং কেনাকাটা করেছেন এমন ব্যবহারকারীর আইডি। এটি সংশ্লিষ্ট মেম্বারশিপ গিফ্টিং মেসেজের snippet.authorChannelId-এর সাথে ম্যাচ করে।
snippet.giftMembershipReceivedDetails.associatedMembershipGiftingMessageId string
মেম্বারশিপ গিফ্টিং মেসেজের আইডি যা এই গিফ্ট মেম্বারশিপের সাথে সম্পর্কিত। এই আইডি সবসময় এমন একটি মেসেজকে রেফার করবে যার type হল membershipGiftingEvent।
snippet.giftDetails object
এই অবজেক্টে গিফ্ট ইভেন্ট সম্পর্কে বিবরণ থাকে। message type-এর মান giftEvent হলে তবেই এটি দেখানো হয়।
snippet.giftDetails.jewelsAmount integer
গিফ্টের জন্য রিডিম করা Jewels-এর সংখ্যা।
snippet.giftDetails.giftName string
উপহারের নাম।
snippet.giftDetails.giftUrl string
গিফ্ট অ্যাসেটের URL।
snippet.giftDetails.giftDuration object
গিফ্ট URL দেখানোর সময়সীমা।
snippet.giftDetails.giftDuration.seconds integer
গিফ্ট URL কত সেকেন্ডের জন্য দেখানো হবে।
snippet.giftDetails.giftDuration.nanos integer
গিফ্ট URL দেখানোর জন্য ন্যানোসেকেন্ডের সংখ্যা।
snippet.giftDetails.hasVisualEffect boolean
গিফ্টে কোনও ভিজ্যুয়াল এফেক্ট আছে কিনা।
snippet.giftDetails.comboCount integer
গিফ্টের কম্বো সংখ্যা; কম্বো না হলে 0।
snippet.giftDetails.altText string
গিফ্টের বিবরণ সহ টেক্সট স্ট্রিং।
snippet.giftDetails.language string
altText প্রপার্টি ভ্যালুর ভাষা।
authorDetails object
authorDetails অবজেক্টে এই মেসেজ পোস্ট করা ব্যবহারকারীর সম্পর্কে অতিরিক্ত বিবরণ থাকে।
authorDetails.channelId string
লেখকের YouTube চ্যানেল আইডি।
authorDetails.channelUrl string
লেখকের YouTube চ্যানেলের URL।
authorDetails.displayName string
লেখকের YouTube চ্যানেলের ডিসপ্লে নাম।
authorDetails.profileImageUrl string
লেখকের YouTube চ্যানেলের অবতার URL।
authorDetails.isVerified boolean
এই ভ্যালু থেকে বোঝা যায় যে YouTube লেখকের পরিচয় যাচাই করেছে কিনা।
authorDetails.isChatOwner boolean
এই ভ্যালু থেকে বোঝা যায় যে লেখক লাইভ চ্যাটের মালিক কিনা।
authorDetails.isChatSponsor boolean
এই ভ্যালু থেকে বোঝা যায় যে লেখক লাইভ চ্যাটের স্পনসর কিনা।
authorDetails.isChatModerator boolean
এই ভ্যালু থেকে বোঝা যায় যে লেখক লাইভ চ্যাটের মডারেটর কিনা।