LiveChatMessages: list

इस तरीके से, किसी चैट के लिए लाइव चैट मैसेज की सूची मिलती है.

चैट मैसेज वापस पाने के लिए पहली बार अनुरोध करने पर, एपीआई चैट इतिहास का कुछ हिस्सा या पूरा इतिहास वापस भेजता है. यह इस बात पर निर्भर करता है कि चैट इतिहास कितना पुराना है. जवाब में मौजूद मैसेज, सबसे पुराने से सबसे नए के क्रम में होते हैं.
  • जवाब में मौजूद nextPageToken, एक टोकन उपलब्ध कराता है. यह टोकन, आपके अगले अनुरोध में नतीजों के अगले सेट की पहचान करेगा. इस सेट को आपके एपीआई क्लाइंट को वापस पाना चाहिए.
  • pollingIntervalMillis प्रॉपर्टी से पता चलता है कि आपके एपीआई क्लाइंट को अतिरिक्त नतीजों का अनुरोध करने से पहले कितनी देर तक इंतज़ार करना चाहिए.
ज़्यादा नतीजे पाने का अनुरोध करते समय, pageToken पैरामीटर को nextPageToken वैल्यू पर सेट करें. अगर उपलब्ध हों, तो एपीआई सर्वर, चैट के अतिरिक्त मैसेज दिखाता है. इसके बाद, नतीजों के उस सेट में, मैसेज को सबसे पुराने से सबसे नए के क्रम में लगाया जाता है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

GET https://www.googleapis.com/youtube/v3/liveChat/messages

पैरामीटर

यहां दी गई टेबल में उन पैरामीटर के बारे में बताया गया है जो इस क्वेरी के साथ काम करते हैं. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
liveChatId string
liveChatId पैरामीटर, उस चैट का आईडी तय करता है जिसके मैसेज दिखाए जाएंगे. ब्रॉडकास्ट से जुड़ा लाइव चैट आईडी, liveBroadcast संसाधन की snippet.liveChatId प्रॉपर्टी में दिखता है.
part string
part पैरामीटर, liveChatMessage संसाधन के उन हिस्सों के बारे में बताता है जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाएगा. id, snippet, और authorDetails को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
ज़रूरी नहीं पैरामीटर
hl string
hl पैरामीटर, एपीआई को निर्देश देता है कि वह किसी खास ऐप्लिकेशन की भाषा के लिए, मुद्रा दिखाने वाली स्ट्रिंग को स्थानीय भाषा में दिखाए. यह भाषा, YouTube की वेबसाइट पर इस्तेमाल की जा सकती है. उदाहरण के लिए, अंग्रेज़ी में मुद्रा को $1.50 के तौर पर दिखाया जाएगा, लेकिन फ़्रेंच में इसे 1,50$ के तौर पर दिखाया जाएगा.

पैरामीटर की वैल्यू, i18nLanguages.list तरीके से मिली सूची में शामिल भाषा कोड होना चाहिए.
maxResults unsigned integer
maxResults पैरामीटर, उन मैसेज की ज़्यादा से ज़्यादा संख्या के बारे में बताता है जिन्हें नतीजे के सेट में दिखाया जाना चाहिए. मान्य वैल्यू 200 से 2000 तक हैं. इसमें 200 और 2000 भी शामिल हैं. डिफ़ॉल्ट वैल्यू 500 है.
pageToken string
pageToken पैरामीटर, नतीजों के सेट में मौजूद किसी ऐसे पेज की पहचान करता है जिसे दिखाया जाना चाहिए. एपीआई रिस्पॉन्स में, nextPageToken प्रॉपर्टी से उन अन्य पेजों की पहचान होती है जिन्हें वापस पाया जा सकता है.
profileImageSize unsigned integer
profileImageSize पैरामीटर, उपयोगकर्ता की प्रोफ़ाइल फ़ोटो का वह साइज़ तय करता है जिसे नतीजों के सेट में दिखाया जाना चाहिए. इमेज स्क्वेयर हैं. डिफ़ॉल्ट वैल्यू 88 है. इसका मतलब है कि फ़ोटो 88 पिक्सल x 88 पिक्सल की होंगी. मान्य वैल्यू, 16 से 720 के बीच की होनी चाहिए. इसमें 16 और 720 भी शामिल हैं.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका काम करता है, तो यह जवाब के मुख्य हिस्से को इस स्ट्रक्चर के साथ दिखाता है:

{
  "kind": "youtube#liveChatMessageListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pollingIntervalMillis": unsigned integer,
  "offlineAt": datetime,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveChatMessage Resource
  ],
  "activePollItem": liveChatMessage Resource
}

प्रॉपर्टी

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

प्रॉपर्टी
kind string
इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#liveChatMessageListResponse होगी.
etag etag
इस संसाधन का ETag.
nextPageToken string
यह ऐसा टोकन है जिसका इस्तेमाल pageToken पैरामीटर की वैल्यू के तौर पर किया जा सकता है. इससे नतीजों के सेट में अगला पेज वापस पाया जा सकता है.
pollingIntervalMillis unsigned integer
यह वह समय है जो क्लाइंट को नए लाइव चैट मैसेज के लिए फिर से पोल करने से पहले इंतज़ार करना चाहिए. यह समय मिलीसेकंड में होता है.
offlineAt datetime
वह तारीख और समय जब लाइवस्ट्रीम ऑफ़लाइन हो गई थी. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब स्ट्रीम पहले से ऑफ़लाइन हो. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में तय किया जाता है.
pageInfo object
pageInfo ऑब्जेक्ट, नतीजों के सेट के लिए पेजिंग की जानकारी शामिल करता है.
pageInfo.totalResults integer
नतीजे के सेट में मौजूद नतीजों की कुल संख्या.
pageInfo.resultsPerPage integer
एपीआई के जवाब में शामिल नतीजों की संख्या.
items[] list
मैसेज की सूची. सूची में मौजूद हर आइटम, liveChatMessage संसाधन होता है.
activePollItem object
मैसेज में मौजूद पोल का डेटा. हर पोल एक liveChatMessage संसाधन होता है. इसका टाइप pollEvent होता है, जो एक ऐक्टिव पोल को दिखाता है. हर चैट में सिर्फ़ एक पोल हो सकता है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) forbidden आपके पास, चुनी गई लाइव चैट के मैसेज वापस पाने के लिए ज़रूरी अनुमतियां नहीं हैं.
forbidden (403) liveChatDisabled चुने गए ब्रॉडकास्ट के लिए लाइव चैट की सुविधा चालू नहीं है.
forbidden (403) liveChatEnded चुनी गई लाइव चैट अब लाइव नहीं है.
notFound (404) liveChatNotFound आपको जिस लाइव चैट को वापस लाना है वह नहीं मिली. अनुरोध के liveChatId पैरामीटर की वैल्यू देखें और पक्का करें कि यह सही हो.
rateLimitExceeded rateLimitExceeded यह अनुरोध, पिछले अनुरोध के तुरंत बाद भेजा गया था. यह गड़बड़ी तब होती है, जब मैसेज पाने के लिए एपीआई अनुरोध, YouTube की रीफ़्रेश रेट से ज़्यादा बार भेजे जा रहे हों. इससे बैंडविथ बेवजह खर्च होती है.

इसे आज़माएं!

इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और जवाब देखें.