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

इस एपीआई रेफ़रंस में, 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	यह किसी खास चैट के मैसेज की सूची बनाता है.

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 पर भेजा जा सकता है. इसके बाद, वह वीडियो आपके दर्शकों को ब्रॉडकास्ट किया जा सकता है.
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	किसी चैनल के लिए स्पॉन्सर की सूची दिखाता है. एपीआई अनुरोध के लिए, चैनल के मालिक से अनुमति लेनी होगी.