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

इस एपीआई रेफ़रंस में, 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 के किसी उपयोगकर्ता और उस लाइव चैट की पहचान करता है जिसमें उपयोगकर्ता को हिस्सा लेने से प्रतिबंधित किया गया है.

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

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