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
    },
    "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
इस संसाधन का ETag.
id string
यह वह आईडी है जो YouTube, मैसेज की खास तौर पर पहचान करने के लिए असाइन करता है.
नोट: GiftEvents के लिए, कॉम्बो की संख्या अपडेट करने के लिए एक ही आईडी का दोबारा इस्तेमाल किया जा सकता है.
snippet object
snippet ऑब्जेक्ट में चैट मैसेज के बारे में मुख्य जानकारी होती है.
snippet.type string
मैसेज का टाइप. यह प्रॉपर्टी हमेशा मौजूद होती है. इसकी वैल्यू से यह तय होता है कि संसाधन में कौनसे फ़ील्ड मौजूद हैं.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • chatEndedEvent – चैट खत्म हो गई है. इसके बाद, कोई और मैसेज नहीं डाला जा सकता. ब्रॉडकास्ट खत्म होने के कुछ समय बाद, यह अपने-आप हो जाएगा. इस तरह का मैसेज, किसी चैनल की डिफ़ॉल्ट ब्रॉडकास्ट की लाइव चैट के लिए नहीं भेजा जाता.
  • sponsorOnlyModeEndedEvent – चैट अब सिर्फ़ प्रायोजकों के लिए उपलब्ध नहीं है. इसका मतलब है कि अब प्रायोजक नहीं बने लोग भी मैसेज भेज सकते हैं. इस इवेंट में दिखाने के लिए कोई कॉन्टेंट नहीं है.
  • sponsorOnlyModeStartedEvent – चैट को सिर्फ़ प्रायोजकों के लिए उपलब्ध मोड में सेट किया गया है. इसका मतलब है कि सिर्फ़ प्रायोजक ही मैसेज भेज सकते हैं. इस इवेंट में दिखाने के लिए कोई कॉन्टेंट नहीं है.
  • newSponsorEvent – किसी नए उपयोगकर्ता ने उस चैनल को स्पॉन्सर किया है जिसके पास लाइव चैट का मालिकाना हक है. author फ़ील्ड में, नए स्पॉन्सर की जानकारी होती है.
  • memberMilestoneChatEvent – किसी उपयोगकर्ता ने सदस्य के लॉयल्टी मैसेज को लाइव चैट में भेजा है.
  • superChatEvent – किसी व्यक्ति ने सुपर चैट खरीदा है.
  • superStickerEvent – किसी व्यक्ति ने सुपर स्टिकर खरीदा है.
  • 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
ध्यान दें: इस ऑब्जेक्ट और इसकी चाइल्ड प्रॉपर्टी का इस्तेमाल अब नहीं किया जा सकेगा. 28 फ़रवरी, 2017 से, 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 चैनल का यूआरएल.
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
इस ऑब्जेक्ट में, सुपर चैट इवेंट के बारे में जानकारी होती है. यह सिर्फ़ तब मौजूद होता है, जब मैसेज टाइप 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 है.
snippet.giftEventDetails object
इस ऑब्जेक्ट में, उपहार देने से जुड़े इवेंट के बारे में जानकारी होती है. यह सिर्फ़ तब मौजूद होता है, जब message type giftEvent हो.
snippet.giftEventDetails.giftMetadata object
तोहफ़े से जुड़े इवेंट के बारे में जानकारी.
snippet.giftEventDetails.giftMetadata.jewelsAmount integer
तोहफ़े के लिए रिडीम किए गए Jewels की संख्या.
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
गिफ़्ट की कुल संख्या; अगर गिफ़्ट कॉम्बो नहीं है, तो 0.
snippet.giftEventDetails.giftMetadata.altText string
यह एक टेक्स्ट स्ट्रिंग है, जिसमें उपहार के बारे में बताया गया है.
snippet.giftEventDetails.giftMetadata.language string
altText प्रॉपर्टी वैल्यू की भाषा.
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
इस वैल्यू से पता चलता है कि लेखक, लाइव चैट का मॉडरेटर है या नहीं.