LiveChatMessages

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

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

तरीके

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

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

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

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