LiveChatMessages

liveChatMessage रिसॉर्स, YouTube लाइव चैट में चैट मैसेज को दिखाता है. इस संसाधन में कई तरह के मैसेज के बारे में जानकारी हो सकती है. जैसे, नया पोस्ट किया गया टेक्स्ट मैसेज या फ़ैन फ़ंडिंग इवेंट.

लाइव ब्रॉडकास्ट के लिए, लाइव चैट की सुविधा डिफ़ॉल्ट रूप से चालू होती है. यह सुविधा, लाइव इवेंट के चालू रहने के दौरान उपलब्ध होती है. (इवेंट खत्म होने के बाद, लाइव चैट की सुविधा उपलब्ध नहीं होती.)

तरीके

एपीआई, liveChatMessages संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

list
इसमें किसी चैट के लाइव चैट मैसेज की सूची होती है. इसे अभी आज़माएं.
streamList
यह कुकी, सर्वर-स्ट्रीमिंग कनेक्शन चालू करती है. इससे कम इंतज़ार के समय में, किसी खास चैट के लिए लाइव चैट मैसेज पाए जा सकते हैं. इसे अभी आज़माएं.
insert
लाइव चैट में कोई मैसेज या पोल जोड़ता है. इसे अभी आज़माएं.
transition
लाइव मैसेज की स्थिति बदलता है. इसे अभी आज़माएं.
मिटाएं
चैट मैसेज मिटाता है. एपीआई अनुरोध को चैनल के मालिक या लाइव चैट के मॉडरेटर से अनुमति मिली होनी चाहिए. इसे अभी आज़माएं.

संसाधन का प्रतिनिधित्व

यहां दिए गए 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
    },
  },
  "authorDetails": {
    "channelId": string,
    "channelUrl": string,
    "displayName": string,
    "profileImageUrl": string,
    "isVerified": boolean,
    "isChatOwner": boolean,
    "isChatSponsor": boolean,
    "isChatModerator": boolean
  },
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#liveChatMessage होगी.
etag etag
इस संसाधन का ETag.
id string
यह वह आईडी है जो YouTube, मैसेज की खास तौर पर पहचान करने के लिए असाइन करता है.
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 – किसी उपयोगकर्ता ने लाइव पोल बनाया है.
snippet.liveChatId string
यह वह आईडी है जो उस लाइव चैट की खास तौर पर पहचान करता है जिससे मैसेज जुड़ा है. ब्रॉडकास्ट से जुड़ा लाइव चैट आईडी, liveBroadcast संसाधन की snippet.liveChatId प्रॉपर्टी में दिखता है.
snippet.authorChannelId string
मैसेज लिखने वाले उपयोगकर्ता का आईडी. यह फ़ील्ड सिर्फ़ इन मैसेज टाइप के लिए भरा जाता है:
  • अगर मैसेज का टाइप textMessageEvent है, तो प्रॉपर्टी वैल्यू से उस उपयोगकर्ता की पहचान होती है जिसने मैसेज लिखा है.
  • अगर मैसेज का टाइप fanFundingEvent है, तो प्रॉपर्टी की वैल्यू से उस उपयोगकर्ता की पहचान होती है जिसने ब्रॉडकास्ट के लिए फ़ंड दिया है.
  • अगर मैसेज का टाइप messageDeletedEvent है, तो प्रॉपर्टी वैल्यू उस मॉडरेटर की पहचान करती है जिसने मैसेज मिटाया है.
  • अगर मैसेज टाइप newSponsorEvent है, तो प्रॉपर्टी वैल्यू से उस उपयोगकर्ता की पहचान होती है जो अभी-अभी स्पॉन्सर बना है.
  • अगर मैसेज का टाइप memberMilestoneChatEvent है, तो प्रॉपर्टी की वैल्यू से उस सदस्य की पहचान होती है जिसने मैसेज भेजा है.
  • अगर मैसेज का टाइप userBannedEvent है, तो प्रॉपर्टी की वैल्यू से उस मॉडरेटर की पहचान होती है जिसने उपयोगकर्ता को बैन किया है.
  • अगर मैसेज का टाइप membershipGiftingEvent है, तो प्रॉपर्टी की वैल्यू से उस उपयोगकर्ता की पहचान होती है जिसने सदस्यता उपहार में देने के लिए खरीदी है.
  • अगर मैसेज का टाइप giftMembershipReceivedEvent है, तो प्रॉपर्टी की वैल्यू से उस उपयोगकर्ता की पहचान होती है जिसे तोहफ़े के तौर पर सदस्यता मिली है.
  • अगर मैसेज टाइप pollEvent है, तो प्रॉपर्टी वैल्यू से उस उपयोगकर्ता की पहचान होती है जिसने लाइव पोल बनाया है.
snippet.publishedAt datetime
मैसेज को पहली बार पब्लिश करने की तारीख और समय. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में तय किया जाता है.
snippet.hasDisplayContent boolean
इससे पता चलता है कि मैसेज में ऐसा कॉन्टेंट है जिसे उपयोगकर्ताओं को दिखाया जाना चाहिए.
snippet.displayMessage string
इसमें एक स्ट्रिंग होती है, जो उपयोगकर्ताओं को दिखती है. अगर मैसेज का टाइप chatEndedEvent या tombstone है, तो यह फ़ील्ड मौजूद नहीं होता.
snippet.fanFundingEventDetails object
ध्यान दें: इस ऑब्जेक्ट और इसकी चाइल्ड प्रॉपर्टी का इस्तेमाल अब नहीं किया जा सकेगा. liveChatMessage संसाधन, 28 फ़रवरी, 2017 से फ़ैन फ़ंडिंग इवेंट की जानकारी नहीं दिखाएंगे.

इस ऑब्जेक्ट में फ़ंडिंग इवेंट के बारे में जानकारी होती है. यह सिर्फ़ तब मौजूद होता है, जब मैसेज टाइप 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
पाबंदी वाले उपयोगकर्ता का YouTube चैनल आईडी.
snippet.userBannedDetails.bannedUserDetails.channelUrl string
पाबंदी वाले उपयोगकर्ता के YouTube चैनल का यूआरएल.
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
दर्शक ने जितने महीनों तक सदस्यता ली है उसकी कुल संख्या. अगर दर्शक ने 1.5 महीने तक सदस्यता ली है, तो इसे दो महीने माना जाएगा. यह उतने ही महीनों की अवधि होती है जितनी YouTube उपयोगकर्ताओं को दिखाई जाती है.
snippet.memberMilestoneChatDetails.memberLevelName string
यह उस लेवल का नाम है जिस पर दर्शक सदस्य है. लेवल के नाम, पैसे चुकाकर ली जाने वाली सदस्यता की सुविधा देने वाला YouTube चैनल तय करता है. कुछ स्थितियों में, यह फ़ील्ड नहीं भरा जाता.
snippet.newSponsorDetails object
इस ऑब्जेक्ट में, नए सदस्य के शामिल होने की सूचना वाले इवेंट के बारे में जानकारी होती है. यह वैल्यू सिर्फ़ तब सेट की जाती है, जब टाइप newSponsorEvent हो. "सदस्य" शब्द का इस्तेमाल "स्पॉन्सर" के लिए किया जाता है.
snippet.newSponsorDetails.memberLevelName string
यह उस लेवल का नाम है जिस पर दर्शक सदस्य है. लेवल के नाम, पैसे चुकाकर ली जाने वाली सदस्यता की सुविधा देने वाला YouTube चैनल तय करता है. कुछ मामलों में, यह फ़ील्ड नहीं भरा जाता.
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 प्रॉपर्टी में यह वैल्यू शामिल होती है.

टियर, मैसेज खरीदने के लिए खर्च की गई रकम के आधार पर तय होता है. इससे यह भी तय होता है कि लाइव चैट के यूज़र इंटरफ़ेस (यूआई) में मैसेज को हाइलाइट करने के लिए किस रंग का इस्तेमाल किया जाएगा, मैसेज की ज़्यादा से ज़्यादा लंबाई कितनी होगी, और मैसेज को टिकर में कितने समय तक पिन किया जाएगा.

सुपर चैट के टियर के बारे में जानकारी, YouTube के सहायता केंद्र में दी गई है. (सुपर चैट खरीदने के बारे में जानकारी देने वाला सेक्शन बड़ा करके देखें.) उस सूची में, खरीदारी के लिए सबसे कम कीमत वाला टियर 1 है. इसके बाद, टियर 2 में खरीदारी के लिए कीमत थोड़ी ज़्यादा है. इसी तरह, अन्य टियर में खरीदारी के लिए कीमत बढ़ती जाती है.
snippet.superStickerDetails object
इस ऑब्जेक्ट में, सुपर स्टिकर इवेंट के बारे में जानकारी होती है. यह सिर्फ़ तब मौजूद होता है, जब मैसेज टाइप superStickerEvent हो.
snippet.superStickerDetails.superStickerMetadata object
Super Sticker के बारे में जानकारी.
snippet.superStickerDetails.superStickerMetadata.stickerId string
यह एक यूनीक आईडी है, जो स्टिकर इमेज की पहचान करता है. ध्यान दें कि यह इमेज, Super Sticker के मैसेज के साथ ही दिखती है. ऐसा तब होता है, जब लोग YouTube पर चैट विंडो देखते हैं. हालांकि, एपीआई का इस्तेमाल करके इमेज का यूआरएल नहीं देखा जा सकता. सिर्फ़ जानकारी के लिए, इस 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 प्रॉपर्टी में यह वैल्यू शामिल होती है.

टियर, मैसेज खरीदने के लिए खर्च की गई रकम के आधार पर तय होता है. इससे यह भी तय होता है कि लाइव चैट के यूज़र इंटरफ़ेस (यूआई) में मैसेज को हाइलाइट करने के लिए किस रंग का इस्तेमाल किया जाएगा, मैसेज की ज़्यादा से ज़्यादा लंबाई कितनी होगी, और मैसेज को टिकर में कितने समय तक पिन किया जाएगा.

सुपर चैट के टियर, सुपर स्टिकर्स को भी कवर करते हैं. इनके बारे में YouTube के सहायता केंद्र में बताया गया है. (सुपर चैट खरीदने के बारे में जानकारी देने वाला सेक्शन बड़ा करके देखें.) उस सूची में, खरीदारी के लिए सबसे कम कीमत वाला टियर 1 है. इसके बाद, टियर 2 में खरीदारी के लिए कीमत थोड़ी ज़्यादा है. इसी तरह, अन्य टियर में खरीदारी के लिए कीमत बढ़ती जाती है.
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
उपयोगकर्ता ने सदस्यता के उपहार के जिस लेवल को खरीदा है उसका नाम. लेवल के नाम, पैसे चुकाकर ली जाने वाली सदस्यता की सुविधा देने वाला 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 है.
authorDetails object
authorDetails ऑब्जेक्ट में, मैसेज पोस्ट करने वाले उपयोगकर्ता के बारे में ज़्यादा जानकारी होती है.
authorDetails.channelId string
लेखक के YouTube चैनल का आईडी.
authorDetails.channelUrl string
लेखक के YouTube चैनल का यूआरएल.
authorDetails.displayName string
लेखक के YouTube चैनल का डिसप्ले नेम.
authorDetails.profileImageUrl string
लेखक के YouTube चैनल के अवतार का यूआरएल.
authorDetails.isVerified boolean
इस वैल्यू से पता चलता है कि YouTube ने लेखक की पहचान की पुष्टि की है या नहीं.
authorDetails.isChatOwner boolean
इस वैल्यू से पता चलता है कि लेखक, लाइव चैट का मालिक है या नहीं.
authorDetails.isChatSponsor boolean
इस वैल्यू से पता चलता है कि लेखक ने लाइव चैट को स्पॉन्सर किया है या नहीं.
authorDetails.isChatModerator boolean
इस वैल्यू से पता चलता है कि लेखक, लाइव चैट का मॉडरेटर है या नहीं.