ब्रॉडकास्ट का जीवन

परिचय

इस दस्तावेज़ में, YouTube पर लाइव ब्रॉडकास्ट के बारे में बताया गया है. इसे YouTube Live Streaming API और YouTube Content ID API का इस्तेमाल करके बनाया और मैनेज किया जाता है.

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

शुरू करना गाइड में बताया गया है कि संसाधन, एक अलग डेटा इकाई होती है. इसका यूनीक आइडेंटिफ़ायर होता है. YouTube पर लाइव इवेंट बनाने और उन्हें मैनेज करने के लिए, आपको कई तरह के संसाधनों का इस्तेमाल करना होगा. इन्हें YouTube Data API या YouTube Content ID API के हिस्से के तौर पर तय किया गया है. YouTube Live Streaming API हेडर में दिए गए संसाधन, तकनीकी तौर पर उन अन्य एपीआई में तय किए गए हैं. हालांकि, इन्हें अलग से इसलिए लिस्ट किया गया है, क्योंकि इनका इस्तेमाल सिर्फ़ लाइव ब्रॉडकास्ट के लिए किया जाता है.

YouTube Live Streaming API के संसाधन

• liveBroadcast
• liveStream
• cuepoint

YouTube Data API के संसाधन

• video

YouTube Content ID API के संसाधन

• asset
• claim
• policy
• videoAdvertisingOption

लाइव ब्रॉडकास्ट बनाना और उसे मैनेज करना

YouTube पर लाइव इवेंट बनाने और उसे मैनेज करने का तरीका यहां बताया गया है. इस प्रोसेस को इन चरणों में बांटा गया है:

1. ब्रॉडकास्ट सेट अप करना
2. अपने कॉन्टेंट पर दावा करना
3. टेस्ट
4. ब्रॉडकास्ट करें
5. ब्रॉडकास्ट खत्म करना
6. कोई रेफ़रंस बनाना

पहला चरण: ब्रॉडकास्ट सेट अप करना

चरण 1.1: ब्रॉडकास्ट बनाना

अपने ब्रॉडकास्ट को YouTube के लाइव इवेंट के शेड्यूल में जोड़ने के लिए, liveBroadcasts.insert तरीके को कॉल करें. आपको जिस liveBroadcast संसाधन को शामिल करना है उसके लिए, यहां दी गई प्रॉपर्टी की वैल्यू तय करनी होंगी.

• snippet.title
• snippet.scheduledStartTime
• status.privacyStatus

ब्रॉडकास्ट सेट अप करते समय, कृपया इन दिशा-निर्देशों का पालन करें:

• अगर आपको अपने ब्रॉडकास्ट को टेस्ट करना है, तो आपको contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी को true और contentDetails.enableAutoStart प्रॉपर्टी को false पर सेट करना होगा. इससे, आपको अपना वीडियो ब्रॉडकास्ट दिखेगा, लेकिन दूसरे दर्शकों को नहीं. ये दोनों प्रॉपर्टी के लिए डिफ़ॉल्ट वैल्यू हैं.

• अगर आपको रिकॉर्ड की गई ब्रॉडकास्ट से रेफ़रंस बनाना है, तो आपको ब्रॉडकास्ट की contentDetails.recordFromStart प्रॉपर्टी को true पर सेट करना होगा. अगर आपको ब्रॉडकास्ट खत्म होने के तुरंत बाद, रिकॉर्ड किए गए वीडियो को चलाने के लिए उपलब्ध कराना है, तो आपको contentDetails.enableDvr प्रॉपर्टी को true पर भी सेट करना होगा. (इन दोनों प्रॉपर्टी की डिफ़ॉल्ट वैल्यू true होती है.)

• अगर आपको उन इलाकों को सीमित करना है जहां आपका ब्रॉडकास्ट देखा जा सकता है, तो contentDetails.availabilityConfig प्रॉपर्टी सेट की जा सकती है. इस प्रॉपर्टी की मदद से, कुछ क्षेत्रों को ब्लॉक किया जा सकता है या प्रॉडक्ट की उपलब्धता को क्षेत्रों की तय की गई सूची तक सीमित किया जा सकता है. क्षेत्र के हिसाब से उपलब्धता के लिए, टाइम विंडो भी तय की जा सकती हैं.

• snippet.categoryId प्रॉपर्टी का इस्तेमाल करके, ब्रॉडकास्ट के लिए वीडियो कैटगरी तय की जा सकती है. हालांकि, ऐसा करना ज़रूरी नहीं है. अगर कोई कैटगरी तय नहीं की गई है, तो डिफ़ॉल्ट रूप से Entertainment कैटगरी लागू हो जाती है.

• जब तक आपके ब्रॉडकास्ट का स्टेटस created या ready है, तब तक contentDetails प्रॉपर्टी में से किसी को भी अपडेट किया जा सकता है.

• ब्रॉडकास्ट के शुरू और खत्म होने के शेड्यूल किए गए समय को तब तक अपडेट किया जा सकता है, जब तक ब्रॉडकास्ट की स्थिति created, ready या testing है.

• ब्रॉडकास्ट के टाइटल, ब्यौरे, कैटगरी, निजता की स्थिति, और अन्य मेटाडेटा फ़ील्ड को कभी भी अपडेट किया जा सकता है. ये फ़ील्ड, ब्रॉडकास्ट के video रिसॉर्स का हिस्सा होते हैं.
  
  ध्यान दें: अगर आपको सिर्फ़ YouTube के कुछ उपयोगकर्ताओं के लिए अपना वीडियो उपलब्ध कराना है, तो status.privacyStatus प्रॉपर्टी की वैल्यू को अपनी ज़रूरत के हिसाब से unlisted या private पर सेट करें.

एपीआई से मिली जानकारी को प्रोसेस करना

liveBroadcasts.insert तरीके को कॉल करने पर, एपीआई से मिली जानकारी में वह liveBroadcast संसाधन शामिल होता है जिसे आपने बनाया है. आपके कोड को उस संसाधन से id को एक्सट्रैक्ट और सेव करना चाहिए. आपको इस वैल्यू की ज़रूरत होगी, ताकि आने वाले समय में एपीआई के अनुरोधों में ब्रॉडकास्ट की पहचान की जा सके. (आपके पास video संसाधन की पहचान करने का विकल्प भी है. इसके लिए, liveBroadcast संसाधन से जुड़े आईडी का इस्तेमाल करें.)

चरण 1.2: स्ट्रीम बनाना

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

अपने इवेंट के लिए वीडियो स्ट्रीम बनाने के लिए, liveStreams.insert तरीके का इस्तेमाल करें. स्ट्रीम बनाते समय, आपको यहां दी गई प्रॉपर्टी के लिए वैल्यू सेट करनी होंगी:

• snippet.title
• cdn.frameRate
• cdn.ingestionType
• cdn.resolution

स्ट्रीम का टाइटल छोड़कर, स्ट्रीम बनाने के बाद इन वैल्यू को अपडेट नहीं किया जा सकता. अगर आपको इन्हें बदलना है, तो आपको यह चरण दोहराकर एक अलग स्ट्रीम बनानी होगी. इस दस्तावेज़ में आगे, तीसरे चरण के पांचवें हिस्से में इस प्रोसेस के बारे में ज़्यादा जानकारी दी गई है.

आपके पास इन प्रॉपर्टी के लिए भी वैल्यू सेट करने का विकल्प होता है:

• snippet.description - स्ट्रीम का टाइटल और ब्यौरा, स्ट्रीम बनाने के बाद भी अपडेट किया जा सकता है. YouTube के उपयोगकर्ताओं को न तो टाइटल दिखता है और न ही ब्यौरा.

• [contentDetails.isReusable](

  /youtube/data/live/reference/rest/v3/liveStreams#contentDetails.isReusable)

  इससे पता चलता है कि स्ट्रीम को फिर से इस्तेमाल किया जा सकता है या नहीं. इसका मतलब है कि इसे कई ब्रॉडकास्ट से जोड़ा जा सकता है. इस प्रॉपर्टी की वैल्यू से यह तय होता है कि किसी चैनल के liveBroadcast और liveStream संसाधनों के बीच, एक से ज़्यादा चैनल/एक चैनल या एक चैनल/एक चैनल का संबंध है या नहीं:

  • अगर प्रॉपर्टी की डिफ़ॉल्ट वैल्यू true का इस्तेमाल किया जाता है, तो चैनल के सभी ब्रॉडकास्ट के लिए एक ही liveStream संसाधन का इस्तेमाल किया जा सकता है. इसका मतलब है कि आपको हर ब्रॉडकास्ट के लिए, यह चरण (1.2) दोहराने की ज़रूरत नहीं है. इसके बजाय, बाद के ब्रॉडकास्ट के लिए, स्ट्रीम आईडी का फिर से इस्तेमाल किया जा सकता है.
  • अगर प्रॉपर्टी की वैल्यू false पर सेट की जाती है, तो आपको हर ब्रॉडकास्ट के लिए एक नई स्ट्रीम बनानी होगी.

स्ट्रीम के लिए एपीआई अनुरोध करने के बाद, एपीआई से मिली जानकारी में वह liveStream संसाधन शामिल होता है जिसे आपने बनाया है. आपके कोड को उस संसाधन से id को एक्सट्रैक्ट और सेव करना चाहिए. आने वाले समय में एपीआई अनुरोधों में स्ट्रीम की पहचान करने के लिए, आपको उस वैल्यू की ज़रूरत होगी.

पहला चरण: ब्रॉडकास्ट को स्ट्रीम से बाइंड करना

liveBroadcast और liveStream रिसॉर्स बनाने के बाद, अब आपको liveBroadcasts.bind तरीके का इस्तेमाल करके, दोनों को जोड़ना होगा. इस कार्रवाई से, वीडियो के वे बिट लिंक हो जाते हैं जिन्हें YouTube पर उस वीडियो के इवेंट ब्रॉडकास्ट के साथ ट्रांसमिट किया जाएगा.

liveBroadcasts.bind तरीके को कॉल करते समय, id पैरामीटर को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें. साथ ही, streamId पैरामीटर को पहले चरण में मिले स्ट्रीम आईडी पर सेट करें.

दूसरा चरण: अपने कॉन्टेंट पर दावा करना

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

ध्यान दें कि इस चरण में बताए गए सभी एपीआई कॉल, YouTube Content ID API में तय किए गए हैं.

दूसरा चरण: ऐसेट बनाना

asset संसाधन, बौद्धिक संपत्ति के किसी हिस्से को दिखाता है. इस मामले में, ऐसेट आपका ब्रॉडकास्ट है. अपनी ऐसेट बनाने के लिए, assets.insert तरीके को कॉल करें.

एपीआई से मिली जानकारी में, आपके बनाए गए asset संसाधन की जानकारी शामिल होगी. आपके कोड को उस रिसॉर्स से id को निकालना और सेव करना चाहिए. ऐसा इसलिए, क्योंकि आने वाले समय में एपीआई अनुरोधों में ऐसेट की पहचान करने के लिए, आपको उस वैल्यू की ज़रूरत होगी.

दूसरा चरण: ऐसेट के मालिकाना हक के बारे में बताना

किसी ऐसेट के मालिकाना हक के डेटा से, ऐसेट के मालिकों के साथ-साथ उन देशों/इलाकों की जानकारी मिलती है जहां उनके पास ऐसेट का मालिकाना हक है. YouTube इस डेटा का इस्तेमाल यह तय करने के लिए करता है कि कोई मालिक, दावा किए गए वीडियो के लिए नीति कहां सेट कर सकता है.

उदाहरण के लिए, अगर आपके पास अमेरिका में किसी इवेंट को ब्रॉडकास्ट करने का अधिकार है और किसी दूसरे ब्रॉडकास्टर के पास कनाडा में उसी इवेंट को ब्रॉडकास्ट करने का अधिकार है, तो आपके पास ब्रॉडकास्ट किए गए वीडियो और उपयोगकर्ता के अपलोड किए गए उन वीडियो के लिए अलग-अलग नीतियां तय करने का विकल्प होता है जो ब्रॉडकास्ट किए गए वीडियो से मिलते-जुलते हैं. मिलते-जुलते वीडियो से जुड़ी आपकी नीति, अमेरिका में उपयोगकर्ता के अपलोड किए गए मिलते-जुलते वीडियो पर लागू होगी. वहीं, दूसरे मालिक की नीति, कनाडा में मिलते-जुलते वीडियो पर लागू होगी.

किसी ऐसेट के लिए, मालिकाना हक वाले देशों/इलाकों की जानकारी देने के लिए, ownership.update तरीके को कॉल करें. उस अनुरोध में, assetId पैरामीटर को उस id पर सेट करें जिसे आपने चरण 2.1 में सेव किया था.

चरण 2.3: ऐसेट के लिए, मिलते-जुलते वीडियो से जुड़ी नीति सेट करना

किसी ऐसेट की मिलते-जुलते वीडियो से जुड़ी नीति से पता चलता है कि जब कोई उपयोगकर्ता ऐसा वीडियो अपलोड करता है जो ऐसेट से जुड़े रेफ़रंस से मिलता-जुलता हो, तो YouTube को क्या करना चाहिए. ऐसे में, मिलते-जुलते वीडियो से जुड़ी नीति से यह पता चलेगा कि YouTube को आपके लाइव ब्रॉडकास्ट से मिलते-जुलते वीडियो को कैसे मैनेज करना चाहिए.

ध्यान दें: अगर आपको ब्रॉडकास्ट किए गए वीडियो से रेफ़रंस बनाना है और उस रेफ़रंस का इस्तेमाल, उपयोगकर्ता के अपलोड किए गए उन वीडियो की पहचान करने के लिए करना है जो आपके ब्रॉडकास्ट से मिलते-जुलते हैं, तो आपको मिलते-जुलते वीडियो से जुड़ी नीति सेट करनी चाहिए. अगर आपको ऐसा नहीं करना है, तो आप यह चरण छोड़ सकते हैं.

मिलते-जुलते वीडियो से जुड़ी नीति सेट करने के लिए, आपको सबसे पहले वह नीति चुननी होगी जिसे आपको लागू करना है. policies.list तरीके का इस्तेमाल करके, मौजूदा नीतियों की सूची वापस पाई जा सकती है. इसके अलावा, policies.insert तरीके का इस्तेमाल करके, नई नीति तय की जा सकती है. दोनों ही मामलों में, आपको उस नीति का id कैप्चर करना होगा जिसे लागू करना है.

नीति की पहचान करने के बाद, assetMatchPolicy.update तरीके को कॉल करें. उस अनुरोध में, assetId पैरामीटर को उस id पर सेट करें जिसे आपने चरण 2.1 में सेव किया था.

चरण 2.4: अपने वीडियो पर दावा करना

इस चरण में, आपको एक दावा बनाना होगा. इससे, ब्रॉडकास्ट किए जाने वाले वीडियो को उस ऐसेट से लिंक किया जा सकेगा जिसे आपने चरण 2.1 में बनाया था. दावे के तहत एक नीति सेट की जाती है. यह नीति सिर्फ़ आपके ब्रॉडकास्ट किए गए वीडियो पर लागू होती है. (उपयोगकर्ता के अपलोड किए गए जो वीडियो आपके ब्रॉडकास्ट वीडियो से मिलते-जुलते हैं उन पर, पिछले चरण में सेट की गई मिलती-जुलती नीति लागू होती है.)

दावा बनाने के लिए, claims.insert तरीके का इस्तेमाल करें. आपने जिस claim रिसोर्स को डाला है उसमें आपको इन प्रॉपर्टी के लिए वैल्यू सेट करनी होंगी:

• assetId – आपको यह वैल्यू, चरण 2.1 में मिली थी.
• videoId – यह ब्रॉडकास्ट आईडी है, जो आपको पहले चरण में मिला था.
• policy – This is a policy resource. किसी मौजूदा नीति को लागू करने के लिए, उस संसाधन की id प्रॉपर्टी को मौजूदा नीति के आईडी पर सेट करें. पिछले चरण में, किसी मौजूदा नीति का आईडी वापस पाने का तरीका बताया गया है.
• contentType – इस वैल्यू को audiovisual पर सेट करें.

एपीआई से मिली जानकारी को प्रोसेस करना

दावा डालने पर, एपीआई से मिली जानकारी में वह claim संसाधन शामिल होगा जिसे आपने बनाया है. आपके कोड को उस संसाधन से id को निकालना और सेव करना चाहिए. इस वैल्यू का इस्तेमाल, बाद में प्रोसेस किए गए वीडियो से रेफ़रंस बनाने के लिए किया जाएगा.

ढाईवां चरण: ब्रॉडकास्ट के लिए विज्ञापन की सेटिंग अपडेट करना

अगर आपको दर्शकों के ब्रॉडकास्ट देखना शुरू करने पर, पहले दिखाए जाने वाले विज्ञापन चलाने हैं या ब्रॉडकास्ट के दौरान ब्रेक में विज्ञापन चलाने हैं, तो आपको अपने वीडियो के लिए विज्ञापन दिखाने के विकल्प सेट करने होंगे.

• अगर आपने ब्रॉडकास्ट के लिए, वीडियो से पहले दिखने वाले विज्ञापन दिखाने की सुविधा चालू की है, तो सभी दर्शकों को ब्रॉडकास्ट शुरू होने पर एक विज्ञापन दिखेगा. भले ही, वे ब्रॉडकास्ट के बीच में देखना शुरू करें.
• अगर आपने ब्रॉडकास्ट के बीच में विज्ञापन दिखाने की सुविधा चालू की है, तो ब्रॉडकास्ट के दौरान विज्ञापन के क्यू पॉइंट डाले जा सकेंगे.

विज्ञापनों को चालू करने के लिए, videoAdvertisingOptions.update तरीके को कॉल करें. अपने अनुरोध में, videoId पैरामीटर को उस ब्रॉडकास्ट id पर सेट करें जो आपको चरण 1.1 में मिला था. videoAdvertisingOption संसाधन की adFormats[] प्रॉपर्टी का इस्तेमाल करके, उन विज्ञापन फ़ॉर्मैट (preroll, midroll या postroll) की पहचान करें जिन्हें आपको चालू करना है.

तीसरा स्टेज: टेस्टिंग

ध्यान दें: यह चरण ज़रूरी नहीं है. अगर आपको टेस्टिंग स्टेज नहीं रखनी है, तो स्ट्रीमिंग की प्रोसेस को आसान बनाने के लिए, liveBroadcast संसाधन की contentDetails.enableAutoStart और contentDetails.enableAutoStop प्रॉपर्टी को true पर सेट करें. जब इन प्रॉपर्टी को true पर सेट किया जाता है, तो बाउंड लाइव स्ट्रीम पर वीडियो स्ट्रीमिंग शुरू करने पर, YouTube अपने-आप ब्रॉडकास्ट शुरू कर देता है. साथ ही, वीडियो ट्रांसमिट करना बंद करने के करीब एक मिनट बाद, ब्रॉडकास्ट अपने-आप खत्म हो जाता है.

इस चरण के दौरान, आपको एक ऐसा प्लेयर एम्बेड करना होगा जो आपके ब्रॉडकास्ट के लिए मॉनिटर स्ट्रीम दिखाता हो. इससे आपको वीडियो देखने के अनुभव की जांच करने में मदद मिलेगी. मॉनिटर स्ट्रीम एक निजी स्ट्रीम होती है. इसकी मदद से, ब्रॉडकास्ट किए जा रहे वीडियो की झलक देखी जा सकती है. इससे आपको पता चलता है कि YouTube पर दर्शकों को वीडियो कैसा दिखेगा.

ध्यान दें कि वीडियो ब्रॉडकास्ट को सिर्फ़ तब टेस्ट किया जा सकता है, जब उसकी मॉनिटर स्ट्रीम चालू हो. डिफ़ॉल्ट रूप से, ब्रॉडकास्ट की मॉनिटर स्ट्रीम चालू होती हैं. ब्रॉडकास्ट बनाते या अपडेट करते समय, contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी को false पर सेट करके, ब्रॉडकास्ट की मॉनिटर स्ट्रीम को बंद किया जा सकता है.

तीसरा चरण: मॉनिटर स्ट्रीम प्लेयर को एम्बेड करना

liveBroadcasts.list तरीके का इस्तेमाल करके, अपना ब्रॉडकास्ट वापस पाएं. इसके बाद, contentDetails.streamDetails.monitorStreamEmbedHtml प्रॉपर्टी की वैल्यू निकालें. इस वैल्यू में वह एचटीएमएल शामिल होता है जो आपको मॉनिटर स्ट्रीम दिखाने वाले YouTube प्लेयर को एम्बेड करने के लिए चाहिए.

तीसरा चरण: वीडियो शुरू करना

अपनी वीडियो स्ट्रीम पर वीडियो ट्रांसमिट करना शुरू करें.

तीसरा चरण: पुष्टि करें कि वीडियो स्ट्रीम चालू है

अपने ब्रॉडकास्ट से जुड़े liveStream संसाधन को वापस पाने के लिए, liveStreams.list तरीके को कॉल करें. पुष्टि करें कि status.streamStatus प्रॉपर्टी की वैल्यू active है. इससे पता चलता है कि YouTube के सर्वर को आपके एन्कोडर से सही तरीके से डेटा मिल रहा है.

तीसरा चरण: ब्रॉडकास्ट की स्थिति को 'टेस्टिंग' में बदलना

ब्रॉडकास्ट का स्टेटस अपडेट करने के लिए, liveBroadcasts.transition तरीके का इस्तेमाल करें. id पैरामीटर की वैल्यू को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें.साथ ही, broadcastStatus पैरामीटर की वैल्यू को testing पर सेट करें.

liveBroadcasts.transition तरीके को कॉल करने के बाद, ट्रांज़िशन पूरा होने में कुछ सेकंड या एक मिनट तक लग सकता है. इस दौरान, आपको ब्रॉडकास्ट की स्थिति देखने के लिए, एपीआई को पोल करना चाहिए. जब तक ट्रांज़िशन पूरा नहीं हो जाता, तब तक ब्रॉडकास्ट का स्टेटस testStarting रहेगा. ट्रांज़िशन पूरा होने के बाद, स्टेटस testing हो जाएगा.

तीसरा चरण: टेस्टिंग पूरी करना

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

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

1. वीडियो स्ट्रीम को अनबाइंड करने के लिए, पहले चरण के तीसरे सब-स्टेप में बताए गए liveBroadcasts.bind तरीके को कॉल करें. एपीआई अनुरोध में, id पैरामीटर को id पर सेट करें.यह वैल्यू, पहले चरण में मिली थी. अनुरोध में streamId पैरामीटर शामिल न करें.

2. वीडियो स्ट्रीम मिटाने के लिए, liveStreams.delete मेथड को कॉल करें. अनुरोध में, id पैरामीटर को पहले चरण के दूसरे हिस्से में मिले id पर सेट करें.

3. सही तरीके से कॉन्फ़िगर किया गया नया liveStream संसाधन बनाने के लिए, चरण 1.2 को दोहराएं. इसके बाद, नई स्ट्रीम को अपने ब्रॉडकास्ट से जोड़ने के लिए, पहले चरण का तीसरा सब-स्टेप दोहराएं. साथ ही, नई स्ट्रीम को टेस्ट करने के लिए, तीसरे चरण के पहले से तीसरे सब-स्टेप दोहराएं.

तीसरा चरण: autoStart और autoStop प्रॉपर्टी चालू करना

ध्यान दें: यह चरण ज़रूरी नहीं है.

टेस्टिंग स्टेज पूरा होने के बाद, आपके पास ब्रॉडकास्ट की contentDetails.enableAutoStart और contentDetails.enableAutoStop प्रॉपर्टी को true पर सेट करने का विकल्प होता है. ऐसा ब्रॉडकास्ट शुरू होने से पहले किया जा सकता है. जांच के चरण से पहले, इन प्रॉपर्टी को true पर सेट नहीं किया जा सकता. ऐसा इसलिए, क्योंकि जांच की वजह से ब्रॉडकास्ट शुरू हो जाएगा.

चौथा स्टेज: ब्रॉडकास्ट

इस दौरान, ब्रॉडकास्ट किया गया वीडियो आपकी ऑडियंस को दिखता है.

चौथा चरण: वीडियो रिकॉर्ड करना शुरू करें

अपनी वीडियो स्ट्रीम पर वीडियो ट्रांसमिट करना शुरू करें.

चौथा चरण 2: पुष्टि करें कि आपकी वीडियो स्ट्रीम चालू है

अपने ब्रॉडकास्ट से जुड़े liveStream संसाधन को वापस पाने के लिए, liveStreams.list तरीके को कॉल करें. पुष्टि करें कि status.streamStatus प्रॉपर्टी की वैल्यू active है. इससे पता चलता है कि YouTube सर्वर को आपके एनकोडर से सही तरीके से डेटा मिल रहा है.

चौथा चरण: अपने ब्रॉडकास्ट की स्थिति को लाइव में बदलना

अहम जानकारी: इस चरण को पूरा करने के बाद, आपका वीडियो दर्शकों को दिखने लगेगा.

ब्रॉडकास्ट का स्टेटस अपडेट करने के लिए, liveBroadcasts.transition तरीके को कॉल करें. id पैरामीटर की वैल्यू को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें.साथ ही, broadcastStatus पैरामीटर की वैल्यू को live पर सेट करें.

अगर आपने liveBroadcast रिसॉर्स की contentDetails.enableAutoStart प्रॉपर्टी को true पर सेट किया है, तो आपको liveBroadcasts.transition तरीके को कॉल करने की ज़रूरत नहीं है.

इस एपीआई कॉल के बाद या अगर आपने contentDetails.enableAutoStart प्रॉपर्टी को true पर सेट किया है, तो स्ट्रीमिंग शुरू करने के बाद, आपको आम तौर पर ट्रांज़िशन पूरा होने के लिए पांच से 10 सेकंड इंतज़ार करना होगा. ट्रांज़िशन में एक मिनट तक लग सकता है. इस दौरान, आपको ब्रॉडकास्ट की स्थिति देखने के लिए, एपीआई को पोल करना चाहिए. ट्रांज़िशन पूरा होने तक, ब्रॉडकास्ट का स्टेटस liveStarting रहेगा. ट्रांज़िशन पूरा होने के बाद, स्टेटस live हो जाएगा. इसके बाद, दर्शक मॉनिटर स्ट्रीम के उस पॉइंट से आपका ब्रॉडकास्ट देख पाएंगे.

इस निर्देश के इन असर पर ध्यान दें:

• अगर आपने अपने ब्रॉडकास्ट के लिए मॉनिटर स्ट्रीम चालू की है, तो आपको एम्बेड किए गए प्लेयर में मॉनिटर स्ट्रीम दिखेगी. इसके लिए, चरण 3.1 देखें.
• अगर आपने ब्रॉडकास्ट की contentDetails.streamDetails.broadcastStreamDelayMs प्रॉपर्टी के लिए कोई वैल्यू सेट की है, तो अन्य दर्शकों को दिखने वाली ब्रॉडकास्ट स्ट्रीम, उस वैल्यू के हिसाब से देर से दिखेगी.

चौथा चरण: अपने ब्रॉडकास्ट में विज्ञापन के लिए ब्रेक जोड़ना

कोई क्यूपॉइंट डालने के लिए, liveBroadcasts.cuepoint मेथड को कॉल करें. क्यू पॉइंट की वजह से, विज्ञापन के लिए ब्रेक ट्रिगर हो सकता है. अनुरोध के मुख्य हिस्से में दिए गए cuepoint रिसॉर्स में, durationSecs प्रॉपर्टी को ब्रेक की उस अवधि (सेकंड में) पर सेट करें जो आपको दिखानी है. (डिफ़ॉल्ट वैल्यू 30 होती है.)

इस समय, YouTube उन सभी दर्शकों के लिए वीडियो प्लेयर में विज्ञापन चलाने की कोशिश करता है जो विज्ञापन का क्यू पॉइंट डाले जाने के समय ब्रॉडकास्ट देख रहे थे. कोई विज्ञापन चलेगा या नहीं, यह कई बातों पर निर्भर करता है. जैसे, विज्ञापन की उपलब्धता और दर्शक के विज्ञापन देखने का इतिहास. जिन दर्शकों को विज्ञापन के लिए ब्रेक दिखता है वे ब्रेक खत्म होने के बाद, आपके ब्रॉडकास्ट पर वापस आ जाते हैं. वहीं, जिन दर्शकों को विज्ञापन नहीं दिखता है वे ब्रेक के दौरान भी ब्रॉडकास्ट स्ट्रीम देखते रहते हैं.

शुरू करें गाइड में, लाइव ब्रॉडकास्ट के दौरान विज्ञापन के लिए ब्रेक के दौरान वीडियो देखने के अनुभव के बारे में ज़्यादा जानकारी दी गई है.

पांचवां चरण: ब्रॉडकास्ट खत्म करना

पाँचवाँ चरण: स्ट्रीमिंग बंद करना

YouTube के लाइव ब्रॉडकास्ट सिस्टम की जांच पूरी हो गई है.

पांचवां चरण: ब्रॉडकास्ट की स्थिति को 'पूरा हुआ' पर सेट करना

ध्यान दें: अगर आपने liveBroadcast संसाधन की contentDetails.enableAutoStop प्रॉपर्टी को true पर सेट किया है, तो आपको यह चरण पूरा करने की ज़रूरत नहीं है. लिंक की गई लाइव स्ट्रीम पर वीडियो भेजना बंद करने के करीब एक मिनट बाद, YouTube ब्रॉडकास्ट अपने-आप बंद कर देगा.

जब आपको ब्रॉडकास्ट रोकना हो, तो ब्रॉडकास्ट का स्टेटस अपडेट करने के लिए, एपीआई के liveBroadcasts.transition तरीके को कॉल करें. id पैरामीटर की वैल्यू को पहले चरण में मिले ब्रॉडकास्ट आईडी पर सेट करें.साथ ही, broadcastStatus पैरामीटर की वैल्यू को complete पर सेट करें.

अगर आपने ब्रॉडकास्ट की contentDetails.recordFromStart और contentDetails.enableDvr प्रॉपर्टी को true पर सेट किया है, तो लाइव इवेंट खत्म होने पर, आपके दर्शक तुरंत लाइव इवेंट का प्लेबैक देख सकते हैं.

छठा चरण: रेफ़रंस बनाना

लाइव रिकॉर्डिंग पूरी होने के बाद, रिकॉर्ड किए गए वीडियो से रेफ़रंस बनाया जा सकता है. इस कार्रवाई से YouTube को, उपयोगकर्ताओं के अपलोड किए गए ऐसे वीडियो ढूंढने का निर्देश मिलता है जो ब्रॉडकास्ट से मिलते-जुलते हों. साथ ही, चरण 2.3 में सेट की गई, मिलते-जुलते वीडियो से जुड़ी नीति के मुताबिक उन वीडियो को मैनेज करने का निर्देश मिलता है.

अहम जानकारी: रेफ़रंस बनाने के लिए, आपको ब्रॉडकास्ट की contentDetails.recordFromStart प्रॉपर्टी को true पर सेट करना होगा.

छठा चरण: वीडियो का स्टेटस जानने के लिए, Data API को पोल करना

किसी वीडियो से रेफ़रंस बनाने से पहले, YouTube को उस वीडियो की प्रोसेसिंग पूरी करनी होगी. भले ही, वह वीडियो ब्रॉडकास्ट किया गया हो या अपलोड किया गया हो. यह पता लगाने के लिए कि वीडियो की प्रोसेसिंग पूरी हो गई है या नहीं, YouTube Data API के videos.list तरीके को पोल करें. इसके लिए, part पैरामीटर को status पर और id पैरामीटर को उस ब्रॉडकास्ट आईडी पर सेट करें जिसे आपने चरण 1.1 में सेव किया था.

पोलिंग के आपके अनुरोध के जवाब में, एपीआई से मिली जानकारी में video संसाधन होगा. जब उस संसाधन की status.uploadStatus प्रॉपर्टी की वैल्यू processed हो, तब छठे चरण पर जाएं.

छठा चरण 2: प्रोसेस किए गए वीडियो से रेफ़रंस बनाना

अपना रेफ़रंस बनाने के लिए, Content ID API के references.insert तरीके को कॉल करें. साथ ही, claimId पैरामीटर को उस दावे के आईडी पर सेट करें जिसे आपने चरण 2.4 में सेव किया था.

लाइव कॉन्टेंट के लिए Content ID की डिलीवरी

कुछ YouTube पार्टनर, ब्रॉडकास्ट के testing स्थिति में आने से पहले रेफ़रंस बना सकते हैं. हालांकि, यह सुविधा सभी पार्टनर के लिए उपलब्ध नहीं है. इस प्रोसेस में, ब्रॉडकास्ट के दौरान YouTube, आपके लाइव इवेंट के ब्रॉडकास्ट स्ट्रीम का रेफ़रंस जनरेट करता है और उसे लगातार अपडेट करता रहता है. इसके अलावा, YouTube ब्रॉडकास्ट के दौरान भी, उपयोगकर्ताओं के अपलोड किए गए मिलते-जुलते वीडियो ढूंढता है. ध्यान दें कि ब्रॉडकास्ट शुरू होने से पहले रेफ़रंस बनाने पर, ब्रॉडकास्ट की रिकॉर्डिंग अपने-आप चालू हो जाती है. साथ ही, रेफ़रंस बनाने के बाद रिकॉर्डिंग को बंद नहीं किया जा सकता.

लाइव कॉन्टेंट के लिए Content ID की डिलीवरी की सुविधा चालू करने के लिए, चरण 2.4 में वीडियो पर दावा करने के बाद, चरण 6.2 में बताई गई कार्रवाइयां करें. अगर आपके पार्टनर खाते को लाइव ब्रॉडकास्ट शुरू होने से पहले, उसके लिए रेफ़रंस बनाने की अनुमति नहीं मिली है, तो एपीआई fingerprintingNotAllowed गड़बड़ी दिखाएगा. ऐसे में, आपको ब्रॉडकास्ट पूरा होने तक इंतज़ार करना होगा. इसके बाद ही, रेफ़रंस बनाया जा सकेगा. ब्रॉडकास्ट पूरा होने की जानकारी, ऊपर दिए गए चरण 6.1 और 6.2 में दी गई है.