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

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