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

इस एपीआई रेफ़रंस में, 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 दिनों में, किसी चैनल की लाइव स्ट्रीम में हुए सुपर चैट इवेंट की सूची बनाओ.

अब काम न करने वाले संसाधन टाइप

FanFundingEvents

fanFundingEvent संसाधन, YouTube चैनल पर फ़ैन फ़ंडिंग इवेंट को दिखाता है. फ़ैन फ़ंडिंग की मदद से, YouTube क्रिएटर्स को आर्थिक तौर पर मदद की जा सकती है. जब कोई व्यक्ति किसी चैनल को एक बार अपनी इच्छा से पेमेंट करता है, तो उसे फ़ैन फ़ंडिंग इवेंट कहा जाता है. प्रशंसक निधिकरण के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.

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

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

LiveCuepoints

liveCuepoint संसाधन, ब्रॉडकास्ट वीडियो स्ट्रीम में विज्ञापन ब्रेक शुरू करता है.

ध्यान दें: क्यूपॉइंट को कंट्रोल करने के लिए एपीआई कमांड, असल में YouTube Content ID API का हिस्सा है. साथ ही, liveBroadcast और liveStream संसाधनों को मैनेज करने के अनुरोधों की तुलना में, इसके लिए अनुमति पाने की अलग-अलग ज़रूरी शर्तें हैं.

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

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

प्रायोजक

sponsor संसाधन, YouTube चैनल के स्पॉन्सर को दिखाता है. स्पॉन्सर, किसी क्रिएटर को बार-बार पैसे देता है. जैसे, सदस्यता शुल्क. इसके बदले में, उसे खास फ़ायदे मिलते हैं. उदाहरण के लिए, जब क्रिएटर चैट के लिए सिर्फ़ स्पॉन्सर के लिए उपलब्ध मोड चालू करता है, तब स्पॉन्सर चैट कर पाते हैं.

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

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