एपीआई का संदर्भ

इस एपीआई रेफ़रंस में, YouTube Live Streaming API का इस्तेमाल करके, YouTube पर लाइव ब्रॉडकास्ट और वीडियो स्ट्रीम शेड्यूल करने का तरीका बताया गया है.

संसाधन के टाइप

LiveBroadcasts

liveBroadcast संसाधन, ऐसे इवेंट को दिखाता है जिसे YouTube पर लाइव वीडियो के ज़रिए स्ट्रीम किया जाएगा.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
bind POST /liveBroadcasts/bind इस कुकी का इस्तेमाल, YouTube ब्रॉडकास्ट को स्ट्रीम से बाइंड करने या ब्रॉडकास्ट और स्ट्रीम के बीच मौजूद बाइंडिंग को हटाने के लिए किया जाता है. ब्रॉडकास्ट को सिर्फ़ एक वीडियो स्ट्रीम से जोड़ा जा सकता है. हालांकि, एक वीडियो स्ट्रीम को एक से ज़्यादा ब्रॉडकास्ट से जोड़ा जा सकता है.
delete DELETE /liveBroadcasts ब्रॉडकास्ट मिटाता है.
insert POST /liveBroadcasts ब्रॉडकास्ट बनाता है.
list GET /liveBroadcasts यह फ़ंक्शन, एपीआई अनुरोध के पैरामीटर से मेल खाने वाले YouTube ब्रॉडकास्ट की सूची दिखाता है.
transition POST /liveBroadcasts/transition यह कुकी, YouTube पर लाइव ब्रॉडकास्ट की स्थिति बदलती है. साथ ही, नई स्थिति से जुड़ी प्रोसेस शुरू करती है. उदाहरण के लिए, जब किसी ब्रॉडकास्ट की स्थिति को testing पर सेट किया जाता है, तो YouTube उस ब्रॉडकास्ट की मॉनिटर स्ट्रीम पर वीडियो ट्रांसमिट करना शुरू कर देता है. इस तरीके को कॉल करने से पहले, आपको यह पुष्टि करनी चाहिए कि ब्रॉडकास्ट से जुड़ी स्ट्रीम के लिए status.streamStatus प्रॉपर्टी की वैल्यू active है.
update PUT /liveBroadcasts ब्रॉडकास्ट को अपडेट करता है. उदाहरण के लिए, liveBroadcast संसाधन के contentDetails ऑब्जेक्ट में तय की गई ब्रॉडकास्ट सेटिंग में बदलाव किया जा सकता है.
cuepoint POST /liveBroadcasts/cuepoint लाइव ब्रॉडकास्ट में क्यूपॉइंट डालता है. ऐसा हो सकता है कि क्यूपॉइंट की वजह से विज्ञापन विराम ट्रिगर हो जाए.

LiveChatBans

liveChatBan संसाधन, YouTube उपयोगकर्ता और YouTube लाइव चैट की पहचान करता है. इस लाइव चैट में उपयोगकर्ता को हिस्सा लेने से बैन किया गया है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /liveChat/bans इस कार्रवाई से, किसी उपयोगकर्ता पर लगा वह प्रतिबंध हट जाता है जिसकी वजह से वह लाइव चैट में हिस्सा नहीं ले पाता. इससे उपयोगकर्ता को चैट में फिर से शामिल होने की अनुमति मिल जाती है. एपीआई अनुरोध को चैनल के मालिक या उस लाइव चैट के मॉडरेटर से अनुमति मिलनी चाहिए जिस पर पाबंदी लगाई गई है.
insert POST /liveChat/bans इससे किसी उपयोगकर्ता को लाइव चैट में हिस्सा लेने से रोका जा सकता है. एपीआई अनुरोध को चैनल के मालिक या उस लाइव चैट के मॉडरेटर से अनुमति मिलनी चाहिए जिस पर पाबंदी लगाई गई है.

LiveChatMessages

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

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

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /liveChat/messages यह चैट मैसेज मिटाता है. एपीआई अनुरोध को चैनल के मालिक या उस लाइव चैट के मॉडरेटर से अनुमति मिलनी चाहिए जिस पर पाबंदी लगाई गई है.
insert POST /liveChat/messages लाइव चैट में कोई मैसेज जोड़ता है.
list GET /liveChat/messages इस तरीके से, किसी चैट के लिए लाइव चैट मैसेज की सूची मिलती है.
streamList यह कुकी, सर्वर-स्ट्रीमिंग कनेक्शन चालू करती है. इससे कम समय में, किसी चैट के लाइव चैट मैसेज मिल पाते हैं.

LiveChatModerators

liveChatModerator संसाधन, YouTube लाइव चैट के लिए मॉडरेटर को दिखाता है. चैट मॉडरेटर के पास, किसी उपयोगकर्ता को चैट से बैन करने या अनबैन करने, मैसेज हटाने, और लाइव चैट के लिए अन्य एडमिन कार्रवाइयां करने का अधिकार होता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /liveChat/moderators यह चैट मॉडरेटर को हटाता है. अनुरोध को लाइव ब्रॉडकास्ट के चैनल के मालिक से मंज़ूरी मिलनी चाहिए.
insert POST /liveChat/moderators इससे चैट के लिए एक नया मॉडरेटर जोड़ा जाता है. अनुरोध को लाइव ब्रॉडकास्ट के चैनल के मालिक से मंज़ूरी मिलनी चाहिए.
list GET /liveChat/moderators लाइव चैट के लिए मॉडरेटर की सूची दिखाता है. अनुरोध को लाइव ब्रॉडकास्ट के चैनल के मालिक से मंज़ूरी मिलनी चाहिए.

LiveStreams

liveStream रिसॉर्स में, YouTube पर ट्रांसमिट की जा रही वीडियो स्ट्रीम के बारे में जानकारी होती है. स्ट्रीम में वह कॉन्टेंट होता है जिसे YouTube उपयोगकर्ताओं को ब्रॉडकास्ट किया जाएगा. liveStream संसाधन बनाने के बाद, इसे एक या उससे ज़्यादा liveBroadcast संसाधनों से जोड़ा जा सकता है.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
delete DELETE /liveStreams यह वीडियो स्ट्रीम को मिटाता है.
insert POST /liveStreams इससे वीडियो स्ट्रीम बनती है. इस स्ट्रीम की मदद से, वीडियो को YouTube पर भेजा जा सकता है. इसके बाद, YouTube आपके वीडियो को आपकी ऑडियंस के लिए ब्रॉडकास्ट कर सकता है.
list GET /liveStreams इससे एपीआई अनुरोध के पैरामीटर से मेल खाने वाली वीडियो स्ट्रीम की सूची मिलती है.
update PUT /liveStreams वीडियो स्ट्रीम को अपडेट करता है. अगर आपको जिन प्रॉपर्टी में बदलाव करना है उन्हें अपडेट नहीं किया जा सकता, तो आपको सही सेटिंग के साथ नई स्ट्रीम बनानी होगी.

SuperChatEvents

superChatEvent एक संसाधन है. यह YouTube लाइव स्ट्रीम के दौरान, किसी प्रशंसक की ओर से खरीदा गया सुपर चैट मैसेज होता है. YouTube की लाइव चैट स्ट्रीम में, सुपर चैट वाले मैसेज दूसरे मैसेज से दो तरह से अलग होते हैं:

  • सुपर चैट को एक रंग से हाइलाइट किया जाता है.
  • सुपर चैट, एक तय समय तक टिकर में सबसे ऊपर दिखाई जाती हैं.

सुपर चैट का रंग, टिकर में सबसे ऊपर दिखने की अवधि, और मैसेज की ज़्यादा से ज़्यादा लंबाई, ये सभी बातें खरीदारी की रकम के हिसाब से तय होती हैं. सुपर चैट के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.

इस संसाधन के बारे में ज़्यादा जानने के लिए, इसका संसाधन प्रज़ेंटेशन और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://www.googleapis.com/youtube/v3 से जुड़े यूआरआई
list GET /superChatEvents पिछले 30 दिनों में, किसी चैनल की लाइव स्ट्रीम में हुए सुपर चैट इवेंट की सूची बनाओ.