इस पेज पर, YouTube Live Streaming API में हुए बदलावों और दस्तावेज़ों के अपडेट की जानकारी दी गई है. बदलावों के इस लॉग की सदस्यता लें.
14 जुलाई, 2025
liveChatMessages.streamList
तरीके के ब्यौरे को अपडेट किया गया है, ताकि streamList API के इस्तेमाल के बारे में दिशा-निर्देश दिए जा सकें.
9 अक्टूबर, 2023
सिर्फ़ जानकारी के लिए, इस CSV फ़ाइल में जाकर देखें कि कौनसे स्टिकर आईडी, किन Super Stickers से जुड़े हैं.
इस जानकारी को दिखाने के लिए, liveChatMessage
संसाधन की snippet.superStickerDetails.superStickerMetadata.stickerId
प्रॉपर्टी और superChatEvent
संसाधन की snippet.superStickerMetadata.stickerId
प्रॉपर्टी, दोनों की परिभाषाओं को अपडेट किया गया है.
15 सितंबर, 2023
एपीआई अब लाइव ब्रॉडकास्ट में विज्ञापन डालने के नए तरीके के साथ काम करता है. liveCuepoints
के अलावा, YouTube अब एक ऐसी सुविधा के साथ काम करता है जिसकी मदद से, ब्रॉडकास्ट में तय किए गए इंटरवल पर, वीडियो के बीच में दिखने वाले विज्ञापन अपने-आप जुड़ जाते हैं. liveCuepoints
की मदद से, ब्रॉडकास्ट में विज्ञापन के लिए मैन्युअल तरीके से ब्रेक तय किए जा सकते हैं.
अगर ब्रॉडकास्ट के मालिक ने अपने-आप विज्ञापन दिखाने की सुविधा चालू की है, तो उन्हें विज्ञापन के व्यवहार से जुड़ी ये जानकारी दिख सकती है:
- वीडियो के बीच में दिखने वाले विज्ञापनों के बीच के अंतराल की अवधि.
- विज्ञापन के लिए तय किए गए समय के हिसाब से विज्ञापन दिखाने की रणनीति. सभी दर्शकों के लिए, एक साथ क्यू पॉइंट डाले जा सकते हैं. इसके अलावा, दर्शकों के हिसाब से क्यू पॉइंट का समय अलग-अलग भी हो सकता है. दूसरी रणनीति की मदद से, YouTube ज़्यादा से ज़्यादा क्यूपॉइंट शेड्यूल कर पाता है. इससे दर्शकों को क्यूपॉइंट तब मिलते हैं, जब वे इसके लिए ज़रूरी शर्तें पूरी करते हैं.
- वह अवधि जिसके दौरान वीडियो के बीच में दिखने वाले विज्ञापन नहीं दिखाए जाते. इस सुविधा के लिए, ब्रॉडकास्ट के मालिक को यह तय करना होता है कि वीडियो के बीच में दिखने वाले विज्ञापन कब तक नहीं दिखाए जाएंगे.
इस सुविधा के साथ काम करने के लिए, दस्तावेज़ में एपीआई से जुड़े इन बदलावों के बारे में बताया गया है:
liveBroadcast
संसाधन में अबmonetizationDetails
ऑब्जेक्ट शामिल है. ऑब्जेक्ट के फ़ील्ड से पता चलता है कि ब्रॉडकास्ट के लिए, विज्ञापन अपने-आप डालने की सुविधा चालू है या नहीं. साथ ही, ये फ़ील्ड क्यूपॉइंट शेड्यूल करने के बारे में अतिरिक्त जानकारी देते हैं.liveBroadcast.list
तरीके काpart
पैरामीटर,monetizationDetails
वैल्यू के साथ काम करता है.update
तरीके का इस्तेमाल करके, लाइव ब्रॉडकास्ट के दौरान वीडियो के बीच में विज्ञापन दिखाने की सुविधा को कुछ समय के लिए रोका जा सकता है. दस्तावेज़ में अब उन गड़बड़ियों के बारे में भी बताया गया है जो लाइव ब्रॉडकास्ट के लिए कमाई करने की जानकारी अपडेट करते समय हो सकती हैं.
1 अगस्त, 2023
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcasts.update
तरीके में अब इन फ़ील्ड के लिए वैल्यू तय करने की ज़रूरत नहीं है:snippet.title
status.privacyStatus
अनुरोध में इन फ़ील्ड को शामिल न करने पर, इनमें कोई बदलाव नहीं होगा.
1 नवंबर, 2022
-
liveBroadcasts.cuepoint
की नई सुविधा की मदद से, YouTube पर लाइव ब्रॉडकास्ट करने वाला कोई भी चैनल मालिक, ब्रॉडकास्ट में क्यूपॉइंट डाल सकता है. इससे विज्ञापन ब्रेक ट्रिगर हो सकते हैं. इस तरीके से,liveCuepoints.insert
तरीके की जगह ली गई है. इस तरीके से, सिर्फ़ YouTube के कॉन्टेंट पार्टनर को लाइव ब्रॉडकास्ट में क्यूपॉइंट डालने की सुविधा मिलती थी.इस नए तरीके के बारे में बताने के लिए, कई गाइड अपडेट की गई हैं.
-
ध्यान दें: यह सुविधा बंद होने की सूचना है.
liveCuepoints.insert
तरीके का अब इस्तेमाल नहीं किया जा सकता.liveCuepoints.insert
तरीके से पेमेंट करने की सुविधा, 1 मई, 2023 को या इसके बाद हटा दी जाएगी. एपीआई का इस्तेमाल करने वाले लोगों को अपने ऐप्लिकेशन अपडेट करने चाहिए, ताकि वेliveBroadcasts.cuepoint
तरीके को कॉल कर सकें. -
liveBroadcasts.control
तरीके से जुड़े दस्तावेज़ हटा दिए गए हैं. इस तरीके के बंद होने की सूचना सितंबर 2020 में पोस्ट की गई थी.
1 अक्टूबर, 2022
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcasts.update
तरीके में, अब इन फ़ील्ड के लिए वैल्यू तय करने की ज़रूरत नहीं है:contentDetails.enableContentEncryption
contentDetails.enableDvr
contentDetails.enableEmbed
contentDetails.recordFromStart
contentDetails.startWithSlate
अनुरोध में इन फ़ील्ड को शामिल न करने पर, इनमें कोई बदलाव नहीं होगा.
-
इस्तेमाल न किए जा सकने वाले
liveBroadcast
फ़ील्ड के लिए दस्तावेज़ हटा दिया गया है:contentDetails.enableContentEncryption
contentDetails.startWithSlate
1 अप्रैल, 2022
इस अपडेट में ये बदलाव किए गए हैं:
-
snippet.type
प्रॉपर्टी के लिए, अब दो नई वैल्यू इस्तेमाल की जा सकती हैं:membershipGiftingEvent
giftMembershipReceivedEvent
-
liveChatMessage
संसाधन की नईsnippet.membershipGiftingDetails
प्रॉपर्टी और उसके चाइल्ड में, सदस्यता उपहार में देने से जुड़े इवेंट के बारे में जानकारी होती है. इसी तरह, नईsnippet.giftMembershipReceivedDetails
प्रॉपर्टी और उसकी चाइल्ड प्रॉपर्टी में, Gift Membership Received इवेंट के बारे में जानकारी होती है.
15 सितंबर, 2021
इस अपडेट में ये बदलाव किए गए हैं:
-
snippet.type
प्रॉपर्टी के लिए, अब दो नई वैल्यू इस्तेमाल की जा सकती हैं:newSponsorEvent
memberMilestoneChatEvent
-
liveChatMessage
संसाधन की नईsnippet.memberMilestoneChatDetails
प्रॉपर्टी और उसकी चाइल्ड प्रॉपर्टी में, सदस्य के लॉयल्टी मैसेज को लाइव चैट में भेजने की सुविधा वाले इवेंट के बारे में जानकारी होती है. इसी तरह, नईsnippet.newSponsorDetails
प्रॉपर्टी और उसकी चाइल्ड प्रॉपर्टी में, नए स्पॉन्सर इवेंट के बारे में जानकारी होती है.
1 दिसंबर, 2020
एपीआई के liveBroadcasts.transition
तरीके में एक नई 403
(Forbidden
) गड़बड़ी का पता चलता है. इससे पता चलता है कि उपयोगकर्ता ने तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं. गड़बड़ी की वजह userRequestsExceedRateLimit
है.
21 सितंबर, 2020
-
liveBroadcast
संसाधन कीstatus.madeForKids
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह साफ़ तौर पर पता चलता है कि यह प्रॉपर्टी सिर्फ़ पढ़ने के लिए है. इससे एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता.किसी लाइव ब्रॉडकास्ट को बच्चों के लिए बनी सामग्री के तौर पर सेट करने के लिए, ब्रॉडकास्ट बनाते समय
liveBroadcasts.insert
तरीके को कॉल करते समय,status.selfDeclaredMadeForKids
प्रॉपर्टी कोtrue
पर सेट करें. -
ध्यान दें: इस बदलाव में, बंद होने की सूचना और पहले बंद होने की सूचना से जुड़ा अपडेट शामिल है.
liveBroadcasts.control
तरीका 1 अक्टूबर, 2020 को या इसके बाद बंद कर दिया जाएगा. इस तारीख के बाद, इस तरीके से किए गए सभी कॉल पर, 'अनुमति नहीं है' (403) गड़बड़ी दिखेगी. इसके बाद, इस तरीके को पूरी तरह से हटा दिया जाएगा. क्लाइंट अब भी, YouTube के इनजेशन सर्वर को भेजे गए वीडियो में ओवरले जोड़कर, खुद की स्लेटिंग लागू कर सकते हैं.16 अप्रैल, 2020 को की गई सूचना के मुताबिक, 1 सितंबर, 2020 को बंद होने वाली सुविधा अब 1 अक्टूबर, 2020 को या उसके बाद बंद होगी. इसलिए, इस सूचना में शामिल सुविधाएं और
liveBroadcasts.control
तरीका, एक ही समय में बंद कर दिया जाएगा.
17 जुलाई, 2020
ध्यान दें: यह सुविधा बंद होने के बारे में पहले दी गई सूचना का अपडेट है.
liveStream
संसाधन का cdn.format
फ़ील्ड, अप्रैल 2016 में बंद कर दिया गया था. यह 17 अगस्त, 2020 से काम नहीं करेगा. उस तारीख के बाद, उस फ़ील्ड का इस्तेमाल करने वाले अनुरोध पूरे नहीं किए जाएंगे.
अगर आपके कोड में अब भी cdn.format
फ़ील्ड का इस्तेमाल किया जा रहा है, तो इसे अपडेट करना होगा. इसके लिए, cdn.frameRate
और cdn.resolution
प्रॉपर्टी का इस्तेमाल करके, फ़्रेम रेट और रिज़ॉल्यूशन को अलग-अलग सेट करना होगा.
6 जुलाई, 2020
एचएलएस के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड में कुछ बदलाव किए गए हैं:
- मीडिया सेगमेंट की अवधि को एक से चार सेकंड तक अपडेट कर दिया गया है.
- नए सेक्शन में, YouTube Creator Studio से एचएलएस इनजेशन यूआरएल पाने का तरीका बताया गया है.
-
file
पैरामीटर की वैल्यू को फ़ॉर्मैट करने के निर्देशों को नए HLS डेटा डालने के यूआरएल को पूरा करना सेक्शन में ले जाया गया है. ये निर्देश इस बात पर लागू होते हैं कि HLS इनजेस्शन यूआरएल, YouTube API या YouTube Creator Studio से मिला है या नहीं.
इसके अलावा, डेटा ट्रांसफ़र करने के प्रोटोकॉल की तुलना करने वाली नई टेबल में, YouTube पर काम करने वाले डेटा ट्रांसफ़र करने के प्रोटोकॉल, हर प्रोटोकॉल के लिए काम करने वाले कोडेक, और हर प्रोटोकॉल के लिए इस्तेमाल के सही उदाहरणों के बारे में ज़्यादा जानकारी दी गई है.
16 अप्रैल, 2020
इस अपडेट में, एक नई प्रॉपर्टी और बंद होने वाली सुविधा के बारे में सूचना शामिल है:
-
liveBroadcast
संसाधन अबcontentDetails.enableAutoStop
प्रॉपर्टी के साथ काम करता है. इस प्रॉपर्टी से यह पता चलता है कि चैनल के मालिक के वीडियो स्ट्रीम करना बंद करने के करीब एक मिनट बाद, ब्रॉडकास्ट अपने-आप बंद हो जाना चाहिए या नहीं.ब्रॉडकास्ट की अवधि वाले दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि
contentDetails.enableAutoStart
याcontentDetails.enableAutoStop
प्रॉपर्टी कोtrue
पर सेट करने पर, YouTube पर लाइव इवेंट बनाने और मैनेज करने की सिलसिलेवार प्रोसेस में कैसे बदलाव होता है. -
ध्यान दें: यह सुविधा बंद होने की सूचना है. ये बदलाव 1 सितंबर, 2020 को या उसके बाद लागू होंगे. बदलाव लागू होने की तारीख को यहां बंद होने की तारीख के तौर पर बताया गया है.
इस अपडेट में, संभावित तौर पर बड़े बदलाव के बारे में बताया गया है. इससे उन एपीआई क्लाइंट ऐप्लिकेशन पर असर पड़ता है जो YouTube पर लाइव कॉन्टेंट स्ट्रीम करने के लिए, चैनलों के डिफ़ॉल्ट
liveStream
औरliveBroadcast
संसाधनों का इस्तेमाल करते हैं. खास तौर पर, लगातार चलने वाले ब्रॉडकास्ट और स्ट्रीम से जुड़े ब्रॉडकास्ट आईडी और स्ट्रीम आईडी का इस्तेमाल करके, नए ब्रॉडकास्ट शुरू नहीं किए जा सकेंगे.अगर इनमें से कोई भी शर्त पूरी होती है, तो आपके आवेदन पर असर पड़ेगा:
- यह
liveBroadcast
संसाधन कीisDefaultBroadcast
प्रॉपर्टी की वैल्यू की जांच करता है. इस प्रॉपर्टी को बंद होने की तारीख के बाद वापस नहीं लाया जाएगा. - यह
liveStream
संसाधन कीisDefaultStream
प्रॉपर्टी की वैल्यू की जांच करता है. इस प्रॉपर्टी को बंद होने की तारीख के बाद वापस नहीं लाया जाएगा. - यह
liveBroadcasts.list
तरीके को कॉल करता है औरbroadcastType
पैरामीटर की वैल्यू कोpersistent
याall
पर सेट करता है. इन बदलावों के तहत, इस पैरामीटर का इस्तेमाल नहीं किया जा सकेगा. बंद होने की तारीख तक:- अगर
broadcastType
पैरामीटर की वैल्यूpersistent
है, तोliveBroadcasts.list
तरीके से कोई नतीजा नहीं मिलेगा. - अगर
broadcastType
पैरामीटर की वैल्यूall
है, तोliveBroadcasts.list
तरीके से, उस समय से पहले मौजूद ब्रॉडकास्ट नहीं दिखाए जाएंगे.
- अगर
पिछले कुछ सालों से, YouTube किसी चैनल के लिए लाइव स्ट्रीमिंग की सुविधा चालू होने पर, डिफ़ॉल्ट स्ट्रीम और डिफ़ॉल्ट ब्रॉडकास्ट अपने-आप बना देता है. डिफ़ॉल्ट स्ट्रीम हमेशा मौजूद रहती थी. इसके शुरू या खत्म होने का समय नहीं होता था. साथ ही, इसे मिटाया भी नहीं जा सकता था. इसी तरह, डिफ़ॉल्ट ब्रॉडकास्ट को स्थायी माना गया था. यह हमेशा से मौजूद था और किसी खास इवेंट से नहीं जुड़ा था.
बंद होने की तारीख के बाद:
- YouTube अब डिफ़ॉल्ट स्ट्रीम और ब्रॉडकास्ट नहीं बनाएगा. डिफ़ॉल्ट संसाधनों पर भरोसा करने के बजाय, एपीआई क्लाइंट को
liveBroadcast
औरliveStream
संसाधन बनाने और मैनेज करने की सुविधा मिलनी चाहिए. साथ ही, उन संसाधनों को एक साथ बाइंड करने की सुविधा भी मिलनी चाहिए. - अगर किसी चैनल का डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम, दोनों चालू हैं, तो इसका मतलब है कि चैनल, सुविधा के बंद होने के समय लाइव ब्रॉडकास्ट के लिए इनका इस्तेमाल कर रहा है. ऐसे में, चालू ब्रॉडकास्ट पर कोई असर नहीं पड़ेगा. हालांकि, ब्रॉडकास्ट खत्म होने के बाद, चैनल डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम का फिर से इस्तेमाल नहीं कर पाएगा.
- अगर किसी चैनल का डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम चालू नहीं है, तो सुविधा बंद होने के बाद YouTube, वीडियो ब्रॉडकास्ट करने के लिए उन संसाधनों का इस्तेमाल करने की कोशिशों को अनदेखा कर देगा.
अगर आपके ऐप्लिकेशन पर इसका असर पड़ा है, तो कृपया इन दस्तावेज़ों को पढ़ें. इनसे आपको अपने ऐप्लिकेशन को अपडेट करने में मदद मिलेगी, ताकि यह बदलाव के बाद भी उम्मीद के मुताबिक काम करता रहे:
- नई माइग्रेशन गाइड में, उन चरणों के बारे में बताया गया है जिन्हें डेवलपर को एपीआई क्लाइंट में पूरा करना पड़ सकता है. फ़िलहाल, ये क्लाइंट डिफ़ॉल्ट ब्रॉडकास्ट और स्ट्रीम का इस्तेमाल करते हैं.
- ब्रॉडकास्ट की लाइफ़साइकल गाइड में, आपको सिलसिलेवार तरीके से यह बताया गया है कि YouTube पर लाइव इवेंट कैसे बनाया और मैनेज किया जाता है. हर चरण में, एपीआई कॉल या अन्य ज़रूरी कार्रवाइयों के बारे में बताया गया है. इन्हें पूरा करके ही कोई खास कार्रवाई की जा सकती है. जब YouTube, डिफ़ॉल्ट स्ट्रीम और ब्रॉडकास्ट की सुविधा बंद कर देगा, तब आपके ऐप्लिकेशन को इस प्रोसेस का पालन करना होगा.
- यह
31 मार्च, 2020
ध्यान दें: यह सुविधा बंद होने की सूचना है.
sponsor
संसाधन और sponsors.list
तरीके को बंद कर दिया गया है. इन्हें member
संसाधन और members.list
तरीके से बदल दिया गया है.
sponsors.list
तरीका, 30 सितंबर, 2020 के बाद काम नहीं करेगा.
एपीआई क्लाइंट को sponsors.list
तरीके के कॉल अपडेट करने चाहिए, ताकि वे members.list
तरीके का इस्तेमाल कर सकें. नए संसाधन के बारे में ज़्यादा जानने के लिए, कृपया YouTube Data API के वर्शन के इतिहास देखें.
11 मार्च, 2020
एचएलएस की मदद से YouTube पर लाइव कॉन्टेंट डिलीवर करने से जुड़ी गाइड के डेटा भेजने का एंडपॉइंट सेक्शन को अपडेट किया गया है. इससे यह साफ़ तौर पर बताया गया है कि प्राइमरी और बैकअप के तौर पर डेटा भेजने के यूआरएल बनाते समय, एन्कोडर को file=
पैरामीटर की वैल्यू को पूरा करने के लिए किस प्रोसेस का इस्तेमाल करना चाहिए.
4 फ़रवरी, 2020
एचएलएस के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड को अपडेट किया गया है. इसमें बताया गया है कि DELETE
अनुरोध करना ज़रूरी नहीं है और YouTube का एचएलएस एंडपॉइंट इन्हें अनदेखा करता है. परफ़ॉर्मेंस बेहतर बनाए रखने के लिए, YouTube का सुझाव है कि क्लाइंट DELETE
अनुरोध न भेजें.
10 जनवरी, 2020
अब एपीआई, बच्चों के लिए बने कॉन्टेंट की पहचान कर सकता है. YouTube इसे "बच्चों के लिए बना" कॉन्टेंट कहता है. YouTube के सहायता केंद्र पर जाकर, "बच्चों के लिए बने" वीडियो के बारे में ज़्यादा जानें.
-
liveBroadcast
संसाधन में दो नई प्रॉपर्टी जोड़ी गई हैं. इनकी मदद से, कॉन्टेंट क्रिएटर्स और दर्शकों को "बच्चों के लिए बना" कॉन्टेंट की पहचान करने में मदद मिलती है:-
selfDeclaredMadeForKids
प्रॉपर्टी की मदद से, कॉन्टेंट क्रिएटर्स यह तय कर सकते हैं कि लाइव ब्रॉडकास्ट बच्चों के लिए बना कॉन्टेंट है या नहीं. इस प्रॉपर्टी को तब सेट किया जा सकता है, जबliveBroadcasts.insert
तरीके से ब्रॉडकास्ट बनाया जा रहा हो. ध्यान दें कि यह प्रॉपर्टी, एपीआई के उन जवाबों में ही शामिल होती है जिनमेंliveBroadcast
संसाधन शामिल होते हैं. ऐसा तब होता है, जब चैनल के मालिक ने एपीआई अनुरोध को अनुमति दी हो. -
madeForKids
प्रॉपर्टी की मदद से, एपीआई का इस्तेमाल करने वाला कोई भी व्यक्ति ब्रॉडकास्ट के "बच्चों के लिए बना" स्टेटस को वापस पा सकता है. उदाहरण के लिए,selfDeclaredMadeForKids
प्रॉपर्टी की वैल्यू के आधार पर स्टेटस तय किया जा सकता है. अपने चैनल, वीडियो या ब्रॉडकास्ट के लिए दर्शकों की श्रेणी तय करने के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
-
-
YouTube Data API में,
channel
रिसोर्स में नईselfDeclaredMadeForKids
औरmadeForKids
प्रॉपर्टी भी काम करती हैं.
हमने YouTube API की सेवाओं की शर्तों और डेवलपर के लिए नीतियों को भी अपडेट किया है. ज़्यादा जानकारी के लिए, कृपया YouTube API की सेवाओं की शर्तों में हुए बदलाव का इतिहास देखें. YouTube API सेवाओं की सेवा की शर्तों और डेवलपर के लिए बनी नीतियों में होने वाले बदलाव, 10 जनवरी, 2020 को पैसिफ़िक समय के हिसाब से लागू होंगे.
20 अगस्त, 2019
एचएलएस के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करने से जुड़ी गाइड के ज़रूरी शर्तें सेक्शन में दो बदलाव किए गए हैं:
- इसमें बताया गया है कि हर मीडिया प्लेलिस्ट में, पुष्टि किए गए सेगमेंट और बकाया सेगमेंट, दोनों को शामिल करना सबसे सही तरीका है. इस तरीके से, सर्वर साइड पर मीडिया प्लेलिस्ट के बंद होने पर, सेगमेंट के स्किप होने की संभावना कम हो जाती है. उदाहरण के लिए, हर मीडिया प्लेलिस्ट में ज़्यादा से ज़्यादा दो ऐसे सेगमेंट शामिल किए जा सकते हैं जिन्हें पहचान मिली है. साथ ही, ज़्यादा से ज़्यादा पांच ऐसे सेगमेंट शामिल किए जा सकते हैं जो लोकप्रिय हैं.
- अब हर मीडिया सेगमेंट के लिए, मीडिया प्लेलिस्ट भेजना ज़रूरी है. इससे सर्वर को मीडिया प्लेलिस्ट के खो जाने पर, उसे तुरंत वापस लाने में मदद मिलती है. इस तरीके को पहले सुझाव के तौर पर लिस्ट किया गया था.
28 जून, 2019
YouTube अब एचएलएस फ़ॉर्मैट में वीडियो स्ट्रीम करने की सुविधा देता है. इसलिए, liveStream
संसाधन की ingestionType
प्रॉपर्टी, नई वैल्यू hls
के साथ काम करती है. इससे, HLS का इस्तेमाल करके YouTube पर अपलोड की गई स्ट्रीम की पहचान की जा सकती है.
एचएलएस की मदद से, YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड में, एन्कोडर से YouTube पर लाइव कॉन्टेंट स्ट्रीम करने के लिए एचएलएस का इस्तेमाल करने से जुड़े दिशा-निर्देश दिए गए हैं. इस गाइड का मकसद, एन्कोडर वेंडर को अपने प्रॉडक्ट में एचएलएस डिलीवरी की सुविधा जोड़ने में मदद करना है.
4 अप्रैल, 2019
इस अपडेट में ये बदलाव किए गए हैं:
-
एपीआई के रेफ़रंस दस्तावेज़ को अपडेट किया गया है. इससे हर तरीके के इस्तेमाल के सामान्य उदाहरणों के बारे में बेहतर तरीके से बताया जा सकेगा. साथ ही, एपीआई एक्सप्लोरर विजेट के ज़रिए डाइनैमिक और बेहतर क्वालिटी वाले कोड सैंपल उपलब्ध कराए जा सकेंगे. उदाहरण के लिए,
liveBroadcasts.list
तरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में बताने वाले पेजों पर, अब दो नए एलिमेंट मौजूद हैं:-
एपीआई एक्सप्लोरर विजेट की मदद से, ऑथराइज़ेशन स्कोप चुने जा सकते हैं. साथ ही, पैरामीटर और प्रॉपर्टी की सैंपल वैल्यू डाली जा सकती हैं. इसके बाद, एपीआई के असली अनुरोध भेजे जा सकते हैं और एपीआई के असली जवाब देखे जा सकते हैं. इस विजेट में फ़ुलस्क्रीन व्यू भी उपलब्ध है. इसमें कोड के पूरे सैंपल दिखते हैं. ये सैंपल, आपके डाले गए स्कोप और वैल्यू के हिसाब से डाइनैमिक तरीके से अपडेट होते हैं.
-
इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताई गई विधि के इस्तेमाल के एक या उससे ज़्यादा सामान्य उदाहरणों के बारे में बताया गया है. उदाहरण के लिए, किसी ब्रॉडकास्ट के बारे में डेटा पाने के लिए या मौजूदा उपयोगकर्ता के ब्रॉडकास्ट के बारे में डेटा पाने के लिए,
liveBroadcasts.list
तरीके को कॉल किया जा सकता है.उस सेक्शन में दिए गए लिंक का इस्तेमाल करके, एपीआई एक्सप्लोरर में अपने इस्तेमाल के उदाहरण के लिए सैंपल वैल्यू भरी जा सकती हैं. इसके अलावा, उन वैल्यू के साथ एपीआई एक्सप्लोरर को फ़ुलस्क्रीन में खोला जा सकता है. इन बदलावों का मकसद, आपके लिए ऐसे कोड सैंपल देखना आसान बनाना है जो सीधे तौर पर उस इस्तेमाल के उदाहरण पर लागू होते हैं जिसे आपको अपने ऐप्लिकेशन में लागू करना है.
फ़िलहाल, कोड के सैंपल Java, JavaScript, PHP, Python, और curl के लिए उपलब्ध हैं.
-
-
कोड सैंपल पेज का यूज़र इंटरफ़ेस (यूआई) भी नया है. इसमें ऊपर बताई गई सभी सुविधाएं मिलती हैं. इस टूल का इस्तेमाल करके, अलग-अलग तरीकों के इस्तेमाल के उदाहरण देखे जा सकते हैं. साथ ही, एपीआई एक्सप्लोरर में वैल्यू लोड की जा सकती हैं. इसके अलावा, एपीआई एक्सप्लोरर को फ़ुलस्क्रीन मोड में खोलकर, Java, JavaScript, PHP, और Python में कोड के सैंपल पाए जा सकते हैं.
इस बदलाव के साथ ही, उन पेजों को हटा दिया गया है जिन पर पहले Java, PHP, और Python के लिए उपलब्ध कोड सैंपल की सूची दी गई थी.
25 फ़रवरी, 2019
liveChatMessage
और superChatEvent
संसाधनों के दस्तावेज़ अपडेट कर दिए गए हैं. इससे पता चलता है कि अब दोनों संसाधनों में Super Stickers के बारे में जानकारी शामिल हो सकती है. सुपर स्टिकर्स, सुपर चैट मैसेज का एक टाइप है. इसमें एक इमेज दिखती है. अन्य सुपर चैट की तरह, Super Sticker मैसेज को भी YouTube लाइव स्ट्रीम के दौरान कोई प्रशंसक खरीदता है.
liveChatMessage
संसाधन में, अबsnippet.type
प्रॉपर्टी कोsuperStickerEvent
पर सेट कर दिया गया है. इससे पता चलता है कि संसाधन में सुपर स्टिकर के बारे में जानकारी शामिल है. ऐसे में, संसाधन मेंsnippet.superStickerDetails
ऑब्जेक्ट भी शामिल होता है. इसमें सुपर स्टिकर के बारे में ज़्यादा जानकारी होती है.superChatEvent
संसाधन में, बूलियनsnippet.isSuperStickerEvent
से पता चलता है कि सुपर चैट मैसेज, सुपर स्टिकर भी है या नहीं. अगर ऐसा है, तोsnippet.superStickerMetadata
ऑब्जेक्ट में Super Sticker के बारे में अतिरिक्त जानकारी होती है.
5 अप्रैल, 2018
superChatEvents.list
तरीके के ब्यौरे को अपडेट किया गया है. इससे पता चलता है कि एपीआई के जवाब में अब fanFundingEvents
शामिल नहीं हैं. इन्हें 2017 की शुरुआत में बंद कर दिया गया था.
3 अप्रैल, 2017
नए Java कोड के सैंपल जोड़े गए हैं. इनमें लाइव चैट के मैसेज सूचीबद्ध करने, जोड़ने, और मिटाने का तरीका बताया गया है. सैंपल, इन तरीकों को कॉल करते हैं:
13 फ़रवरी, 2017
इस अपडेट में ये बदलाव किए गए हैं:
-
मौजूदा संसाधनों और तरीकों से जुड़े अपडेट
-
liveCuepoints.insert
तरीके को अपडेट किया गया है, ताकि यह पता चल सके कि फ़िलहालonBehalfOfContentOwner
पैरामीटर की ज़रूरत है. इसके अलावा, इस तरीके के ब्यौरे को अपडेट किया गया है. इसमें बताया गया है कि इस तरीके के लिए किए गए कॉल को, YouTube कॉन्टेंट के मालिक से जुड़े खाते से अनुमति मिलनी चाहिए.
-
9 फ़रवरी, 2017
इस अपडेट में ये बदलाव किए गए हैं:
-
मौजूदा संसाधनों और तरीकों से जुड़े अपडेट
-
superChatEvents.list
तरीके के नएhl
पैरामीटर की मदद से, यह तय किया जा सकता है किsnippet.displayString
प्रॉपर्टी की वैल्यू को किसी खास भाषा के नियमों के मुताबिक फ़ॉर्मैट किया जाना चाहिए. उस प्रॉपर्टी की परिभाषा को भी इसके हिसाब से अपडेट कर दिया गया है.पैरामीटर की वैल्यू, भाषा का ऐसा कोड होना चाहिए जो
i18nLanguages.list
तरीके से मिले जवाब की सूची में शामिल हो. डिफ़ॉल्ट वैल्यूen
है. इसका मतलब है कि डिसप्ले स्ट्रिंग को फ़ॉर्मैट करने का डिफ़ॉल्ट तरीका वही है जो अंग्रेज़ी में इस्तेमाल किया जाता है. उदाहरण के लिए, डिफ़ॉल्ट रूप से किसी स्ट्रिंग को$1,00
के बजाय$1.00
के तौर पर फ़ॉर्मैट किया जाता है.
-
1 फ़रवरी, 2017
इस अपडेट में ये बदलाव किए गए हैं:
-
नए संसाधन और तरीके
-
नई
superChatEvent
संसाधन, YouTube लाइव स्ट्रीम के दौरान किसी प्रशंसक की ओर से खरीदा गया सुपर चैट मैसेज दिखाता है. YouTube की लाइव चैट स्ट्रीम में, सुपर चैट दूसरे मैसेज से दो तरह से अलग होती हैं:- सुपर चैट को एक रंग से हाइलाइट किया जाता है.
- सुपर चैट, एक तय समय तक टिकर में सबसे ऊपर दिखाई जाती हैं.
सुपर चैट का रंग, टिकर में सबसे ऊपर दिखने की अवधि, और मैसेज की ज़्यादा से ज़्यादा लंबाई, ये सभी बातें खरीदारी की रकम के हिसाब से तय होती हैं. सुपर चैट के बारे में ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं.
एपीआई, पिछले 30 दिनों में किसी चैनल की लाइव स्ट्रीम के लिए, सुपर चैट इवेंट की सूची बनाने का तरीका उपलब्ध कराता है. इस तरीके से, चैनल की पिछली लाइव स्ट्रीम के फ़ैन फ़ंडिंग इवेंट (
fanFundingEvents
) के बारे में भी डेटा मिलता है.
-
-
मौजूदा संसाधनों और तरीकों से जुड़े अपडेट
-
snippet.type
प्रॉपर्टी अबsuperChatEvent
वैल्यू के साथ काम करती है. इससे पता चलता है कि संसाधन, सुपर चैट के बारे में बताता है.इसके अलावा,
liveChatMessage
संसाधन की नईsnippet.superChatDetails
प्रॉपर्टी और उसके चाइल्ड में, सुपर चैट इवेंट के बारे में जानकारी होती है. -
liveStream
संसाधन कीcdn.resolution
प्रॉपर्टी के लिए, अब2160p
वैल्यू का इस्तेमाल किया जा सकता है.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई में ये नई गड़बड़ियां दिख सकती हैं:
गड़बड़ी की जानकारी liveBroadcasts.insert
,liveBroadcasts.update
liveBroadcasts.insert
औरliveBroadcasts.update
तरीके,400
(Bad Request
) गड़बड़ियां दिखाते हैं. इससे पता चलता है कि डाली जा रही या अपडेट की जा रहीliveBroadcast
संसाधन में,contentDetails.enableEmbed
प्रॉपर्टी याcontentDetails.projection
प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद है. इन दो नई गड़बड़ियों की वजहें,invalidEmbedSetting
औरinvalidProjection
हैं.
-
12 जनवरी, 2017
ध्यान दें: यह सुविधा बंद होने की सूचना है.
सुपर चैट की नई सुविधा के लॉन्च होने के साथ ही, YouTube ने फ़ैन फ़ंडिंग की सुविधा को बंद कर दिया है. साथ ही, फ़ैन फ़ंडिंग एपीआई को 28 फ़रवरी, 2017 को बंद कर दिया जाएगा. उस तारीख तक:
liveChatMessages.list
तरीके से, अबfanFundingEvent
केsnippet.type
वाले मैसेज नहीं दिखेंगे. इसी तरह,liveChatMessage
रिसॉर्स में अबsnippet.fanFundingEventDetails
ऑब्जेक्ट नहीं होगा.fanFundingEvents.list
तरीके से अब डेटा नहीं मिलेगा.
11 अगस्त, 2016
इस अपडेट में ये बदलाव किए गए हैं:
-
हाल ही में पब्लिश की गई YouTube API सेवाओं की सेवा की शर्तों ("अपडेट की गई शर्तें") के बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर विस्तार से बताया गया है. इसमें, सेवा की मौजूदा शर्तों से जुड़े कई अपडेट दिए गए हैं. अपडेट किए गए नियमों के अलावा, इस अपडेट में कई सहायक दस्तावेज़ भी शामिल हैं. ये दस्तावेज़, उन नीतियों को समझने में मदद करेंगे जिनका पालन डेवलपर को करना होगा. ये नियम 10 फ़रवरी, 2017 से लागू होंगे.
अपडेट किए गए नियमों के लिए, बदलाव का इतिहास में नए दस्तावेज़ों के पूरे सेट के बारे में बताया गया है. इसके अलावा, अपडेट की गई शर्तों या उनसे जुड़े दस्तावेज़ों में आने वाले समय में होने वाले बदलावों के बारे में भी, बदलाव के इतिहास में बताया जाएगा. उस दस्तावेज़ में मौजूद लिंक से, बदलाव के इतिहास में हुए बदलावों की सूची वाले आरएसएस फ़ीड की सदस्यता ली जा सकती है.
20 मई, 2016
YouTube अब DASH फ़ॉर्मैट में वीडियो अपलोड करने की सुविधा देता है. इसलिए, liveStream
संसाधन की ingestionType
प्रॉपर्टी, नई वैल्यू dash
के साथ काम करती है. इससे DASH का इस्तेमाल करके YouTube पर अपलोड की गई स्ट्रीम की पहचान की जा सकती है.
नई गाइड DASH का इस्तेमाल करके, YouTube पर लाइव कॉन्टेंट डिलीवर करना में, एन्कोडर से YouTube पर लाइव डेटा स्ट्रीम करने के लिए, DASH डिलीवरी फ़ॉर्मैट का इस्तेमाल करने से जुड़े दिशा-निर्देश दिए गए हैं. इसका मकसद, एन्कोडर वेंडर को अपने प्रॉडक्ट में DASH डिलीवरी की सुविधा जोड़ने में मदद करना है.
18 अप्रैल, 2016
इस अपडेट में ये बदलाव किए गए हैं:
-
मौजूदा संसाधनों और तरीकों से जुड़े अपडेट
liveStream
संसाधन से जुड़े अपडेट-
YouTube पर अब 1440 पिक्सल रिज़ॉल्यूशन वाली स्ट्रीम को 30 या 60 फ़्रेम प्रति सेकंड पर देखा जा सकता है.
इसके अलावा,
liveStream
संसाधन में, इनबाउंड वीडियो डेटा के फ़्रेम रेट और रिज़ॉल्यूशन के बारे में बताने के लिए नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी cdn.frameRate
इनबाउंड वीडियो डेटा का फ़्रेम रेट. मान्य वैल्यू 30fps
और60fps
हैं.cdn.resolution
इनबाउंड वीडियो डेटा का रिज़ॉल्यूशन. प्रॉपर्टी की मान्य वैल्यू ये हैं: 1440p
,1080p
,720p
,480p
,360p
, और240p
. -
liveStream
संसाधन कीcdn.frameRate
औरcdn.resolution
प्रॉपर्टी के लॉन्च होने के बाद, संसाधन कीcdn.format
प्रॉपर्टी अब काम नहीं करती है.cdn.format
प्रॉपर्टी, रिज़ॉल्यूशन और फ़्रेम रेट की जानकारी एक ही वैल्यू में देती है.हमारा सुझाव है कि आप नए फ़ील्ड पर स्विच करें. इस बीच,
cdn.format
काम करता रहता है. इसके अलावा, फ़िलहाल लाइव स्ट्रीम डालने के अनुरोध तब तक पूरे किए जाते हैं, जब तक आपनेcdn.format
प्रॉपर्टी याcdn.frameRate
औरcdn.resolution
प्रॉपर्टी के लिए वैल्यू दी हों. अगर आपने तीनों प्रॉपर्टी के लिए वैल्यू दी हैं, तो हो सकता है कि एपीआई गड़बड़ी दिखाए. ऐसा तब होता है, जब वैल्यू मेल नहीं खाती हैं.ध्यान दें कि
cdn.format
प्रॉपर्टी को बंद कर दिया गया है. हालांकि, अब यह दो नई वैल्यू,1440p
और1440p_hfr
को सपोर्ट करती है. इससे एपीआई के 30 या 60 फ़्रेम प्रति सेकंड पर 1440 पिक्सल की स्ट्रीम को सपोर्ट करने की जानकारी मिलती है.
-
liveBroadcast
संसाधन से जुड़े अपडेट-
liveBroadcast
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी contentDetails.boundStreamLastUpdateTimeMs
वह तारीख और समय, जब ब्रॉडकास्ट की contentDetails.boundStreamId
प्रॉपर्टी से जुड़ी लाइव स्ट्रीम को पिछली बार अपडेट किया गया था.contentDetails.projection
ब्रॉडकास्ट का प्रोजेक्शन फ़ॉर्मैट. इस प्रॉपर्टी की डिफ़ॉल्ट वैल्यू rectangular
है. प्रॉपर्टी के लिए मान्य वैल्यू360
औरrectangular
हैं. -
liveBroadcast
संसाधन कीstatistics.totalChatCount
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब ब्रॉडकास्ट में कम से कम एक चैट मैसेज हो.
-
liveChatMessage
संसाधन से जुड़े अपडेट-
snippet.type
प्रॉपर्टी के लिए दो नई वैल्यू –messageDeletedEvent
औरuserBannedEvent
– उपलब्ध हैं. ये वैल्यू, यहां दिए गए बुलेट पॉइंट में बताई गई नई प्रॉपर्टी से मेल खाती हैं.snippet.authorChannelId
प्रॉपर्टी की परिभाषा को भी अपडेट किया गया है, ताकि यह बताया जा सके कि प्रॉपर्टी वैल्यू, मैसेज के इन नए टाइप की पहचान कैसे करती है. -
liveChatMessage
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी snippet.messageDeletedDetails
इस ऑब्जेक्ट में, उस मैसेज के बारे में जानकारी होती है जिसे चैट मॉडरेटर ने मिटाया है. यह ऑब्जेक्ट सिर्फ़ तब मौजूद होता है, जब snippet.type
प्रॉपर्टी की वैल्यूmessageDeletedEvent
हो.snippet.userBannedDetails
इस ऑब्जेक्ट में, उस उपयोगकर्ता के बारे में जानकारी होती है जिसे चैट में हिस्सा लेने से बैन कर दिया गया है. इस ऑब्जेक्ट में, पाबंदी के बारे में भी जानकारी होती है. जैसे, पाबंदी स्थायी है या अस्थायी. अगर खाता कुछ समय के लिए निलंबित किया गया है, तो ऑब्जेक्ट की किसी प्रॉपर्टी में निलंबन की अवधि के बारे में बताया जाता है.
यह ऑब्जेक्ट सिर्फ़ तब मौजूद होता है, जबsnippet.type
प्रॉपर्टी की वैल्यूuserBannedEvent
हो.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई में ये नई गड़बड़ियां दिख सकती हैं:
गड़बड़ी की जानकारी liveBroadcasts.bind
liveBroadcasts.bind
तरीके से403
(Forbidden
) गड़बड़ी का पता चलता है. इससे यह पता चलता है कि उपयोगकर्ता ने तय समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं. गड़बड़ी की वजहuserRequestsExceedRateLimit
है.liveBroadcasts.insert
औरliveBroadcasts.update
तरीकों में, यह गड़बड़ी पहले से मौजूद है.liveStreams.insert
liveStreams.insert
तरीके में चार नई400
(Bad Request
) गड़बड़ियां होती हैं. इनसेliveStream
संसाधन में मौजूद प्रॉपर्टी की अमान्य वैल्यू का पता चलता है. यह वही संसाधन होता है जिसे अनुरोध में डालने की कोशिश की गई थी. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
invalidFormat
:cdn.format
invalidFrameRate
:cdn.frameRate
invalidIngestionType
:cdn.ingestionType
invalidResolution
:cdn.resolution
liveStreams.insert
liveStreams.insert
तरीके में दो नई400
(Bad Request
) गड़बड़ियां होती हैं. इनमें से हर एक गड़बड़ी से पता चलता है कि अनुरोध में शामिलliveStream
संसाधन में ज़रूरी वैल्यू मौजूद नहीं है. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
संसाधन डाला जाता है, तब आपकोcdn.format
प्रॉपर्टी याcdn.frameRate
औरcdn.resolution
प्रॉपर्टी के लिए कोई वैल्यू तय करनी होगी.
- अगर आपने तीनों प्रॉपर्टी में से किसी के लिए भी वैल्यू नहीं दी है, तो एपीआई
formatRequired
गड़बड़ी का मैसेज दिखाता है. - अगर आपने
cdn.resolution
के लिए कोई वैल्यू तय की है, लेकिनcdn.frameRate
के लिए कोई वैल्यू तय नहीं की है, तो एपीआईframeRateRequired
गड़बड़ी का मैसेज दिखाता है. - अगर आपने
cdn.frameRate
के लिए कोई वैल्यू तय की है, लेकिनcdn.resolution
के लिए कोई वैल्यू तय नहीं की है, तो एपीआईresolutionRequired
गड़बड़ी का मैसेज दिखाता है.
liveStreams.update
अगर अनुरोध में, इन प्रॉपर्टी की वैल्यू में बदलाव करने की कोशिश की जाती है, तो liveStreams.update
तरीके से403
(Forbidden
) गड़बड़ी मिलती है:cdn.format
cdn.frameRate
cdn.ingestionType
cdn.resolution
reason
,liveStreamModificationNotAllowed
है.
-
18 दिसंबर, 2015
यूरोपीय संघ (ईयू) के कानूनों के मुताबिक, ईयू में रहने वाले असली उपयोगकर्ताओं को कुछ जानकारी देना और उनसे सहमति लेना ज़रूरी है. इसलिए, यूरोपीय संघ में रहने वाले असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने इस ज़रूरी शर्त के बारे में सूचना, YouTube API की सेवा की शर्तों में जोड़ दी है.
17 दिसंबर, 2015
इस अपडेट में ये बदलाव किए गए हैं:
-
नए संसाधन और तरीके
-
यह एपीआई, लाइव ब्रॉडकास्ट के दौरान चैट करने की सुविधा के लिए कई नए संसाधन उपलब्ध कराता है. YouTube पर लाइव ब्रॉडकास्ट के दौरान, लाइव चैट की सुविधा उपलब्ध होती है. इन संसाधनों और इनके तरीकों से, चैट मैसेज वापस पाने के साथ-साथ चैट से जुड़े एडमिन फ़ंक्शन भी इस्तेमाल किए जा सकते हैं.
संसाधन liveChatMessage
यह संसाधन, YouTube लाइव चैट में मौजूद किसी मैसेज को दिखाता है. YouTube पर कई तरह के मैसेज भेजे जा सकते हैं. जैसे, टेक्स्ट मैसेज और फ़ैन फ़ंडिंग इवेंट. कुछ मैसेज टाइप से, चैट के किसी खास फ़ेज़ की पहचान होती है. जैसे, सिर्फ़ प्रायोजकों के लिए उपलब्ध चैट की शुरुआत या चैट के खत्म होने का समय. इस एपीआई में, लाइव चैट मैसेज को सूची में शामिल करने, डालने, और मिटाने के तरीके शामिल हैं. liveChatModerators
यह संसाधन, चैट मॉडरेटर की पहचान करता है. मॉडरेटर, एडमिन से जुड़े कुछ काम कर सकते हैं. जैसे, उपयोगकर्ताओं को चैट से बैन करना या मैसेज हटाना. एपीआई, लाइव चैट के मॉडरेटर की सूची बनाने, उन्हें जोड़ने, और उन्हें हटाने के तरीकों के साथ काम करता है. liveChatBans
इस संसाधन से, उस उपयोगकर्ता की पहचान होती है जिसे किसी लाइव चैट में मैसेज पोस्ट करने से बैन किया गया है. पाबंदियां कुछ समय के लिए या हमेशा के लिए लगाई जा सकती हैं. इस एपीआई में, लाइव चैट पर पाबंदी लगाने और हटाने के तरीके काम करते हैं. fanFundingEvents
यह संसाधन, YouTube चैनल पर फ़ैन फ़ंडिंग इवेंट को दिखाता है. फ़ैन फ़ंडिंग की सुविधा की मदद से, दर्शक अपनी मर्ज़ी से YouTube क्रिएटर्स को एक बार पैसे देकर सपोर्ट कर सकते हैं.
एपीआई काfanFundingEvents.list
तरीका, चैनल के फ़ैन फ़ंडिंग इवेंट की सूची दिखाता है. चैनल के मालिकाना हक वाले लाइव ब्रॉडकास्ट के दौरान, लाइव चैट के ज़रिए शुरू किए गए फ़ैन फ़ंडिंग इवेंट से भी ब्रॉडकास्ट की लाइव चैट मेंfanFundingEvent
मैसेज ट्रिगर होता है.
YouTube सहायता केंद्र में जाकर, फ़ैन फ़ंडिंग के बारे में ज़्यादा जानें.sponsors
sponsor
संसाधन, YouTube चैनल के किसी स्पॉन्सर की पहचान करता है. कोई स्पॉन्सर, किसी चैनल को हर महीने पैसे चुकाता है. चैनल की लाइव चैट में, स्पॉन्सर के मैसेज के बगल में एक बैज दिखता है. स्पॉन्सर, चैनल के स्पॉन्सर के लिए खास तौर पर की जाने वाली लाइव चैट में भी हिस्सा ले सकते हैं.
एपीआई काsponsors.list
तरीका, किसी चैनल के स्पॉन्सर की सूची दिखाता है. जब उपयोगकर्ता, किसी चैनल के मालिकाना हक वाले लाइव ब्रॉडकास्ट के दौरान, उस चैनल को स्पॉन्सर करने के लिए साइन अप करते हैं, तो एपीआई ब्रॉडकास्ट की लाइव चैट मेंnewSponsorEvent
मैसेज भी जोड़ता है.
YouTube सहायता केंद्र में जाकर, स्पॉन्सरशिप के बारे में ज़्यादा जानें.
-
-
मौजूदा संसाधनों और तरीकों से जुड़े अपडेट
-
liveBroadcast
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी snippet.liveChatId
ब्रॉडकास्ट की YouTube लाइव चैट का आईडी. इस आईडी की मदद से, liveChatMessage
संसाधन के तरीकों का इस्तेमाल करके, चैट मैसेज वापस लाए जा सकते हैं, डाले जा सकते हैं या मिटाए जा सकते हैं. आपके पास चैट मॉडरेटर जोड़ने या हटाने, उपयोगकर्ताओं को लाइव चैट में हिस्सा लेने से रोकने या मौजूदा पाबंदियां हटाने का विकल्प भी होता है.contentDetails.closedCaptionsType
ध्यान दें: यह प्रॉपर्टी, contentDetails.enableClosedCaptions
प्रॉपर्टी की जगह इस्तेमाल की जाती है.
इस प्रॉपर्टी से पता चलता है कि आपके ब्रॉडकास्ट के लिए सबटाइटल की सुविधा चालू है या नहीं. अगर चालू है, तो किस तरह के सबटाइटल उपलब्ध कराए जा रहे हैं:closedCaptionsDisabled
: लाइव ब्रॉडकास्ट के लिए सबटाइटल की सुविधा बंद है.closedCaptionsHttpPost
: आपको एचटीटीपी पोस्ट के ज़रिए कैप्शन भेजने होंगे. इसके लिए, आपको लाइव स्ट्रीम से जुड़े इंजेशन यूआरएल का इस्तेमाल करना होगा.closedCaptionsEmbedded
: कैप्शन को EIA-608 और/या CEA-708 फ़ॉर्मैट का इस्तेमाल करके, वीडियो स्ट्रीम में कोड किया जाएगा.
contentDetails.enableClosedCaptions
यह प्रॉपर्टी 17 दिसंबर, 2015 से काम नहीं करती है. इसके बजाय, contentDetails.closedCaptionsType
प्रॉपर्टी का इस्तेमाल करें. इस प्रॉपर्टी का इस्तेमाल पहले से कर रहे API क्लाइंट के लिए:- प्रॉपर्टी की वैल्यू को
true
पर सेट करने का मतलब है किcontentDetails.closedCaptionsType
प्रॉपर्टी कोclosedCaptionsHttpPost
पर सेट किया गया है. - प्रॉपर्टी की वैल्यू को
false
पर सेट करने का मतलब है किcontentDetails.closedCaptionsType
प्रॉपर्टी कोclosedCaptionsDisabled
पर सेट किया गया है.
-
liveBroadcasts.list
तरीके के नएbroadcastType
पैरामीटर की मदद से, एपीआई के जवाब को फ़िल्टर किया जा सकता है. इससे इवेंट ब्रॉडकास्ट, लगातार ब्रॉडकास्ट या सभी ब्रॉडकास्ट शामिल किए जा सकते हैं.स्थायी ब्रॉडकास्ट ऐसा ब्रॉडकास्ट होता है जो हमेशा मौजूद रहता है और किसी इवेंट से नहीं जुड़ा होता. खास तौर पर, किसी चैनल का डिफ़ॉल्ट ब्रॉडकास्ट एक लगातार चलने वाला ब्रॉडकास्ट होता है. इसे YouTube Studio में लाइव डैशबोर्ड के ज़रिए ऐक्सेस किया जा सकता है. चैनल के अन्य ब्रॉडकास्ट, इवेंट ब्रॉडकास्ट होते हैं.
-
-
liveStream
संसाधन केstatus.healthStatus.configurationIssues[].type
फ़ील्ड में, सेहत की स्थिति से जुड़ी ये नई गड़बड़ियां रिपोर्ट की जाती हैं:गड़बड़ियां audioTooManyChannels
ऑडियो में दो से ज़्यादा चैनल हैं, लेकिन केवल एक (मोनो) या दो (स्टीरियो) चैनल समर्थित हैं. कृपया ऑडियो चैनलों की संख्या सही करें. frameRateHigh
मौजूदा फ़्रेम रेट बहुत ज़्यादा है. कृपया फ़्रेम रेट को एफ़पीएस (फ़्रेम प्रति सेकंड) या इससे कम पर सेट करें.%(framerate)s
-
दस्तावेज़ के पिछले अपडेट की पब्लिश करने की तारीख को ठीक किया गया है.
-
नई और अपडेट की गई गड़बड़ियां
-
ऊपर दी गई नई सुविधाओं के लिए तय की गई गड़बड़ियों के अलावा, एपीआई इन नई गड़बड़ियों के बारे में भी बताता है:
गड़बड़ी की जानकारी liveBroadcasts.update
एचटीटीपी रिस्पॉन्स कोड forbidden (403)
कारण closedCaptionsTypeModificationNotAllowed
ब्यौरा contentDetails.closedCaptionsType
की वैल्यू में सिर्फ़ तब बदलाव किया जा सकता है, जब ब्रॉडकास्टcreated
याready
स्टेटस में हो.liveBroadcasts.update
एचटीटीपी रिस्पॉन्स कोड invalidValue (400)
कारण invalidEnableClosedCaptions
ब्यौरा liveBroadcast संसाधन में, contentDetails.enableClosedCaptions
प्रॉपर्टी की वैल्यू,contentDetails.closedCaptionType
सेटिंग की वैल्यू के साथ काम नहीं करती. संसाधन में बदलाव करके, दोनों प्रॉपर्टी में से सिर्फ़ एक को शामिल करें. इसके बाद, अनुरोध फिर से सबमिट करें.
-
19 अगस्त, 2015
इस अपडेट में ये बदलाव किए गए हैं:
-
नए संसाधन और तरीके
-
ध्यान दें:
liveChat
संसाधन और उसके तरीकों से जुड़ा दस्तावेज़ गोपनीय है. यह सिर्फ़ चुनिंदा YouTube पार्टनर को दिखता है.नई
liveChat
संसाधन में, YouTube पर लाइव ब्रॉडकास्ट के दौरान पोस्ट की गई टिप्पणी शामिल है. एपीआई, इस संसाधन के लिए दो तरीके इस्तेमाल करता है:तरीके liveChats.list
किसी ब्रॉडकास्ट के लिए लाइव चैट मैसेज की सूची बनाएं. liveChats.insert
नया चैट मैसेज बनाएं. लाइव चैट के मैसेज सिर्फ़ लाइव ब्रॉडकास्ट के दौरान ही वापस पाए जा सकते हैं और पोस्ट किए जा सकते हैं.
-
-
मौजूदा संसाधनों और तरीकों से जुड़े अपडेट
-
liveStream
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी snippet.isDefaultStream
इससे पता चलता है कि यह स्ट्रीम, चैनल की डिफ़ॉल्ट स्ट्रीम है या नहीं. किसी चैनल की डिफ़ॉल्ट स्ट्रीम हमेशा मौजूद रहती है. इसके शुरू या खत्म होने का कोई समय नहीं होता. साथ ही, इसे मिटाया भी नहीं जा सकता. डिफ़ॉल्ट स्ट्रीम के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, प्रॉपर्टी की परिभाषा देखें. status.healthStatus
इस ऑब्जेक्ट में ऐसी जानकारी होती है जिसका इस्तेमाल, स्ट्रीमिंग से जुड़ी समस्याओं की पहचान करने, उनका पता लगाने, और उन्हें हल करने के लिए किया जा सकता है. इस ऑब्जेक्ट में कई चाइल्ड प्रॉपर्टी होती हैं. इनसे आपको लाइव वीडियो स्ट्रीम की क्वालिटी का आकलन करने में मदद मिलती है.
खास तौर पर,status.healthStatus.configurationIssues[]
ऑब्जेक्ट में उन समस्याओं की सूची होती है जो वीडियो स्ट्रीम पर असर डालती हैं. लाइव स्ट्रीम के संसाधनों के कॉन्फ़िगरेशन से जुड़ी समस्याएं नाम के नए दस्तावेज़ में, एपीआई से जुड़ी सभी समस्याओं की सूची दी गई है.contentDetails.isReusable
इससे पता चलता है कि स्ट्रीम का दोबारा इस्तेमाल किया जा सकता है या नहीं. इसका मतलब है कि इसे कई ब्रॉडकास्ट से जोड़ा जा सकता है. अगर ब्रॉडकास्ट अलग-अलग समय पर होते हैं, तो ब्रॉडकास्टर के लिए एक ही स्ट्रीम का इस्तेमाल कई अलग-अलग ब्रॉडकास्ट के लिए करना आम बात है. -
liveBroadcast
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी snippet.isDefaultBroadcast
इससे पता चलता है कि यह ब्रॉडकास्ट, चैनल के लिए डिफ़ॉल्ट ब्रॉडकास्ट है या नहीं. जब किसी YouTube चैनल पर लाइव स्ट्रीमिंग की सुविधा चालू होती है, तो YouTube उस चैनल के लिए डिफ़ॉल्ट स्ट्रीम और डिफ़ॉल्ट ब्रॉडकास्ट बनाता है. स्ट्रीम से यह तय होता है कि चैनल का मालिक, YouTube पर लाइव वीडियो कैसे भेजेगा. वहीं, ब्रॉडकास्ट से यह तय होता है कि दर्शक डिफ़ॉल्ट स्ट्रीम को कैसे देख सकते हैं. डिफ़ॉल्ट ब्रॉडकास्ट के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, प्रॉपर्टी की परिभाषा देखें. contentDetails.enableLowLatency
इससे पता चलता है कि इस ब्रॉडकास्ट को कम समय में स्ट्रीम करने के लिए, एन्कोड किया जाना चाहिए या नहीं. कम समय में बफ़र होने वाली स्ट्रीम से, ब्रॉडकास्ट देखने वाले लोगों को वीडियो दिखने में कम समय लगता है. हालांकि, इससे स्ट्रीम देखने वाले लोगों के लिए वीडियो के रिज़ॉल्यूशन पर भी असर पड़ सकता है. statistics.totalChatCount
ब्रॉडकास्ट से जुड़े लाइव चैट मैसेज की कुल संख्या. अगर ब्रॉडकास्ट, उपयोगकर्ता को दिखता है और उसमें लाइव चैट की सुविधा चालू है, तो यह प्रॉपर्टी और इसकी वैल्यू मौजूद होती है. ध्यान दें कि ब्रॉडकास्ट खत्म होने के बाद, इस प्रॉपर्टी की कोई वैल्यू नहीं होगी. इसलिए, यह प्रॉपर्टी पूरी हो चुकी लाइव ब्रॉडकास्ट के संग्रहित वीडियो के लिए, चैट मैसेज की संख्या का पता नहीं लगा पाएगी.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई,
liveChat
नए संसाधन के लिए तय की गई गड़बड़ियों के अलावा, इस नई गड़बड़ी का भी समर्थन करता है:गड़बड़ी की जानकारी liveStreams.update
एचटीटीपी रिस्पॉन्स कोड forbidden (403)
कारण liveStreamModificationNotAllowed
ब्यौरा API की मदद से, बार-बार इस्तेमाल की जा सकने वाली स्ट्रीम को बार-बार इस्तेमाल न की जा सकने वाली स्ट्रीम में नहीं बदला जा सकता. इसके अलावा, बार-बार इस्तेमाल न की जा सकने वाली स्ट्रीम को बार-बार इस्तेमाल की जा सकने वाली स्ट्रीम में भी नहीं बदला जा सकता. ज़्यादा जानकारी के लिए, ब्रॉडकास्ट और स्ट्रीम के बारे में जानकारी लेख पढ़ें
-
21 मई, 2015
इस अपडेट में ये बदलाव किए गए हैं:
-
YouTube पर अब 60 फ़्रेम प्रति सेकंड (एफ़पीएस) पर लाइव वीडियो स्ट्रीम किया जा सकता है. इसका मतलब है कि गेमिंग और तेज़ी से होने वाली अन्य गतिविधियों वाले वीडियो को ज़्यादा आसानी से चलाया जा सकता है. YouTube पर 60 फ़्रेम प्रति सेकंड (एफ़पीएस) पर लाइव स्ट्रीम शुरू करने पर, YouTube उस स्ट्रीम को 30 एफ़पीएस पर भी उपलब्ध कराता है. ऐसा उन डिवाइसों पर किया जाता है जिन पर ज़्यादा फ़्रेम रेट पर वीडियो देखने की सुविधा अभी उपलब्ध नहीं है.
liveStream
संसाधन कीcdn.format
प्रॉपर्टी के लिए, इस सुविधा की दो नई वैल्यू उपलब्ध हैं:720p_hfr
और1080p_hfr
.इस सुविधा के बारे में ज़्यादा जानने के लिए, YouTube Creators Blog पर जाएं.
21 अगस्त, 2014
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcasts.control
तरीके केwalltime
पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि प्रॉपर्टी की वैल्यू, आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ss.sssZ
) में दी गई है. -
अब एपीआई में ये गड़बड़ियां दिखती हैं:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा insufficientPermissions
liveStreamingNotEnabled
अगर एपीआई अनुरोध को अनुमति देने वाले उपयोगकर्ता के पास, YouTube पर लाइव वीडियो स्ट्रीम करने की सुविधा चालू नहीं है, तो liveBroadcast
औरliveStream
संसाधनों के सभी तरीकों से यह गड़बड़ी दिखती है. उपयोगकर्ता को लाइव वीडियो स्ट्रीम करने की अनुमति क्यों नहीं है, इसकी जानकारी https://www.youtube.com/features पर जाकर, उपयोगकर्ता के चैनल की सेटिंग में देखी जा सकती है.rateLimitExceeded
userRequestsExceedRateLimit
liveBroadcasts.insert
औरliveStreams.insert
, दोनों ही तरीके इस गड़बड़ी को दिखाते हैं. इससे पता चलता है कि उपयोगकर्ता ने तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं.
2 मई, 2014
इस अपडेट में ये बदलाव किए गए हैं:
-
liveStream
रिसॉर्स औरliveBroadcasts.bind
तरीके के ब्यौरे को अपडेट किया गया है. इसमें बताया गया है कि किसी ब्रॉडकास्ट को सिर्फ़ एक वीडियो स्ट्रीम से जोड़ा जा सकता है. हालांकि, किसी वीडियो स्ट्रीम को एक से ज़्यादा ब्रॉडकास्ट से जोड़ा जा सकता है. यह बदलाव सिर्फ़ दस्तावेज़ में किया गया है. एपीआई की बुनियादी सुविधा में कोई बदलाव नहीं हुआ है. -
liveBroadcast
संसाधन कीcontentDetails.monitorStream.enableMonitorStream
प्रॉपर्टी को अपडेट किया गया है. इसमें बताया गया है कि अगर प्रॉपर्टी की वैल्यूtrue
है, तो आपको ब्रॉडकास्ट कोtesting
स्थिति में बदलना होगा. इसके बाद ही, इसेlive
स्थिति में बदला जा सकेगा. (अगर प्रॉपर्टी की वैल्यूfalse
है, तो आपके ब्रॉडकास्ट मेंtesting
स्टेज नहीं हो सकती. इसलिए, ब्रॉडकास्ट को सीधेlive
स्थिति में बदला जा सकता है. -
liveCuepoint
रिसॉर्स कीsettings.offsetTimeMs
प्रॉपर्टी को अपडेट किया गया है. इससे यह पता चलता है कि अगर आपके ब्रॉडकास्ट में मॉनिटर स्ट्रीम नहीं है, तो आपको प्रॉपर्टी के लिए कोई वैल्यू नहीं देनी चाहिए. -
liveBroadcast
औरliveStream
संसाधनों के सभी तरीके, अबonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करते हैं. इन पैरामीटर की मदद से, एक ही कॉन्टेंट के मालिक से जुड़े अलग-अलग चैनलों के लिए, एपीआई के अनुरोध पूरे करने के लिए एक ही ऑथराइज़ेशन क्रेडेंशियल का इस्तेमाल किया जा सकता है. -
liveCuepoints.insert
तरीके के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि इस तरीके को कॉल करते समय,settings.walltime
प्रॉपर्टी के लिए वैल्यू सेट की जा सकती है. -
गड़बड़ी से जुड़े दस्तावेज़ में अब हर तरह की गड़बड़ी के लिए, एचटीटीपी रिस्पॉन्स कोड दिया गया है.
-
अब यह एपीआई, इस गड़बड़ी के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा insufficientPermissions
livePermissionBlocked
अगर अनुरोध करने वाला उपयोगकर्ता, YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता, तो liveBroadcasts.insert
,liveBroadcasts.transition
, औरliveStreams.insert
तरीके यह गड़बड़ी दिखाते हैं. उपयोगकर्ता को लाइव वीडियो स्ट्रीम करने की अनुमति क्यों नहीं है, इसकी जानकारी https://www.youtube.com/features पर जाकर, उपयोगकर्ता के चैनल की सेटिंग में देखी जा सकती है. -
liveBroadcasts.insert
तरीके कीinvalidScheduledStartTime
गड़बड़ी को अपडेट किया गया है. इससे यह साफ़ तौर पर पता चलता है कि शेड्यूल किए गए शुरू होने के समय को मौजूदा तारीख के आस-पास होना चाहिए, ताकि उस समय ब्रॉडकास्ट को भरोसेमंद तरीके से शेड्यूल किया जा सके.
13 दिसंबर, 2013
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcast
संसाधन की नईstatus.recordingStatus
प्रॉपर्टी से, ब्रॉडकास्ट की मौजूदा स्थिति के बारे में पता चलता है. -
liveBroadcast
संसाधन की नईcontentDetails.enableClosedCaptions
प्रॉपर्टी से पता चलता है कि ब्रॉडकास्ट के लिए सबटाइटल शामिल किए जा सकते हैं या नहीं. ब्रॉडकास्ट डालते या अपडेट करते समय, प्रॉपर्टी की वैल्यू सेट की जा सकती है. हालांकि, ब्रॉडकास्ट केtesting
याlive
स्थिति में होने पर, इसे अपडेट नहीं किया जा सकता. इस प्रॉपर्टी कोtrue
पर सेट करने पर, ब्रॉडकास्ट से जुड़ीliveStream
रिसॉर्स, ब्रॉडकास्ट के सबटाइटल के लिए इस्तेमाल किए जाने वाले इनजेशन यूआरएल के बारे में बताएगा. -
liveBroadcast
संसाधन कीsnippet.scheduledEndTime
प्रॉपर्टी अब उन ब्रॉडकास्ट के साथ काम करती है जिन्हें अनिश्चित काल तक जारी रखने के लिए शेड्यूल किया गया है. इस बदलाव के बाद,liveBroadcasts.insert
औरliveBroadcasts.update
अनुरोधों में इस प्रॉपर्टी की ज़रूरत नहीं होगी.
अगर आपको कोई ऐसीliveBroadcast
संसाधन मिलता है जिसमें इस प्रॉपर्टी के लिए कोई वैल्यू नहीं दी गई है, तो ब्रॉडकास्ट को अनिश्चित काल तक जारी रखने के लिए शेड्यूल किया जाता है. इसी तरह, अगर आपनेliveBroadcasts.insert
याliveBroadcasts.update
तरीके को कॉल किया है और इस प्रॉपर्टी के लिए कोई वैल्यू नहीं दी है, तो ब्रॉडकास्ट को अनिश्चित काल तक जारी रखने के लिए शेड्यूल किया जाएगा. -
liveBroadcast
रिसॉर्स कीcontentDetails.recordFromStart
प्रॉपर्टी की डिफ़ॉल्ट वैल्यू पहले से हीtrue
पर सेट है. अब इसे सिर्फ़false
पर सेट किया जा सकता है. हालांकि, ऐसा तब ही किया जा सकता है, जब ब्रॉडकास्ट करने वाले चैनल को लाइव ब्रॉडकास्ट की रिकॉर्डिंग बंद करने की अनुमति हो.अगर आपके चैनल के पास रिकॉर्डिंग बंद करने की अनुमति नहीं है और आपने
recordFromStart
प्रॉपर्टी कोfalse
पर सेट करके ब्रॉडकास्ट डालने की कोशिश की है, तो एपीआईForbidden
गड़बड़ी दिखाएगा. इसके अलावा, अगर आपके चैनल के पास यह अनुमति नहीं है और आपने ब्रॉडकास्ट को अपडेट करकेrecordFromStart
प्रॉपर्टी कोfalse
पर सेट करने की कोशिश की, तो एपीआईmodificationNotAllowed
गड़बड़ी दिखाएगा. -
liveBroadcast
रिसॉर्स में अबenableArchive
प्रॉपर्टी नहीं है. इसका ज़िक्रcontentDetails.enableDvr
औरcontentDetails.enableEmbed
प्रॉपर्टी की जानकारी में किया गया था. -
liveBroadcast
संसाधन कीstatus.lifeCycleStatus
प्रॉपर्टी के लिए मान्य वैल्यू की सूची को अपडेट कर दिया गया है. इसमें हर स्टेटस की जानकारी शामिल है. -
liveCuepoint
संसाधन की नईsettings.walltime
प्रॉपर्टी, वह तारीख और समय तय करती है जिस पर क्यूपॉइंट डाला जाना चाहिए. अगर कोई अनुरोध, ऐसा क्यूपॉइंट डालने की कोशिश करता है जो इस प्रॉपर्टी औरsettings.offsetTimeMs
प्रॉपर्टी के लिए वैल्यू तय करता है, तो एपीआई एक गड़बड़ी दिखाता है. -
liveStream
संसाधन में मौजूद नएcontentDetails
ऑब्जेक्ट में स्ट्रीम के बारे में जानकारी होती है. फ़िलहाल, ऑब्जेक्ट की सिर्फ़ एक प्रॉपर्टी है:contentDetails.closedCaptionsIngestionUrl
. यह वीडियो स्ट्रीम से जुड़े सबटाइटल के लिए, डेटा ट्रांसफ़र करने का यूआरएल तय करती है. -
liveStream
संसाधन कीstatus.streamStatus
प्रॉपर्टी के लिए मान्य वैल्यू की सूची को अपडेट कर दिया गया है. इसमें हर स्टेटस की जानकारी शामिल है. -
liveBroadcasts.control
तरीके के नएwalltime
पैरामीटर की मदद से, यह तय किया जा सकता है कि स्लेट कब बदलेगी. अगर किसी अनुरोध में इस पैरामीटर औरoffsetTimeMs
पैरामीटर, दोनों के लिए वैल्यू दी जाती है, तो एपीआई गड़बड़ी दिखाता है. -
liveBroadcasts.list
अनुरोध के जवाब में,kind
प्रॉपर्टी की वैल्यूyoutube#liveBroadcastList
से बदलकरyoutube#liveBroadcastListResponse
हो गई है. -
liveStreams.list
अनुरोध के जवाब में,kind
प्रॉपर्टी की वैल्यूyoutube#liveStreamList
से बदलकरyoutube#liveStreamListResponse
हो गई है. -
eventId
प्रॉपर्टी कोliveBroadcastListResponse
औरliveStreamListResponse
, दोनों से हटा दिया गया है. -
एपीआई में ये नई गड़बड़ियां दिख सकती हैं:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा invalidValue
conflictingTimeFields
अगर आपके अनुरोध में offsetTimeMs
औरwalltime
पैरामीटर के लिए वैल्यू दी गई हैं, तोliveBroadcasts.control
तरीके से यह गड़बड़ी दिखती है. अनुरोध में, दोनों पैरामीटर को हटाया जा सकता है या दोनों में से किसी एक पैरामीटर के लिए वैल्यू तय की जा सकती है.invalidValue
invalidWalltime
अगर walltime
पैरामीटर की वैल्यू अमान्य है, तोliveBroadcasts.control
तरीके से यह गड़बड़ी दिखती है.forbidden
enableClosedCaptionsModificationNotAllowed
अगर आपने contentDetails.enableClosedCaptions
वैल्यू को अपडेट करने की कोशिश की है और ब्रॉडकास्ट की स्थितिcreated
याready
नहीं है, तोliveBroadcasts.update
तरीके से यह गड़बड़ी दिखती है.invalidValue
conflictingTimeFields
अगर आपके अनुरोध में settings.offsetTimeMs
औरsettings.walltime
प्रॉपर्टी के लिए वैल्यू दी गई हैं, तोliveCuepoints.insert
तरीके से यह गड़बड़ी दिखती है. अनुरोध में, दोनों प्रॉपर्टी की वैल्यू शामिल नहीं की जा सकती हैं. हालांकि, दोनों में से किसी एक प्रॉपर्टी की वैल्यू दी जा सकती है.इसके अलावा,
liveStreams.update
तरीके में अबcdnRequired
जैसी गड़बड़ी नहीं होती. यह गड़बड़ीliveStreams.insert
तरीके में होती है.
10 मई, 2013
इस अपडेट में ये बदलाव किए गए हैं:
-
YouTube अब एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई की सुविधाओं और सेवाओं की पहचान नहीं करता है. हालांकि, अब हम उन YouTube API की सूची उपलब्ध कराते हैं जिन पर बंद होने से जुड़ी नीति लागू होती है.
2 मई, 2013
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcasts.control
नई सुविधा की मदद से, ब्रॉडकास्ट स्ट्रीम में दिखने वाले स्लेट के लिए डिसप्ले सेटिंग को टॉगल किया जा सकता है. यह सुविधा, पहले से चल रहे ब्रॉडकास्ट के लिए उपलब्ध है. अगर आपकी ब्रॉडकास्ट स्ट्रीम में देरी हो रही है, तो इस तरीके का इस्तेमाल करके, टाइम ऑफ़सेट भी तय किया जा सकता है. इससे यह तय किया जा सकेगा कि स्लेट में बदलाव कब होगा. -
इन प्रॉपर्टी की परिभाषाओं को अपडेट किया गया है. इससे यह पता चलता है कि अगर आपको
liveBroadcast
संसाधन केcontentDetails
हिस्से को अपडेट करना है, तो प्रॉपर्टी की वैल्यू सेट करनी होंगी: -
liveStream
संसाधन केstatus.streamStatus
में, स्ट्रीम की स्थिति के तौर परdeleted
वैल्यू का इस्तेमाल अब नहीं किया जा सकता. -
एपीआई, कई गड़बड़ी के मैसेज के लिए जो जानकारी देता है उसे अपडेट किया गया है. इससे यह बेहतर तरीके से बताया जा सकेगा कि गड़बड़ियां क्यों हुईं. एपीआई में कई नई गड़बड़ियों को भी ठीक किया गया है.
27 मार्च, 2013
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcast
संसाधन में इन प्रॉपर्टी की वैल्यू बदल गई हैं:startWithSlateCuepoint
प्रॉपर्टी का नाम बदलकरstartWithSlate
कर दिया गया है.enableArchive
प्रॉपर्टी का नाम बदलकरrecordFromStart
कर दिया गया है.slateSettings
ऑब्जेक्ट को बंद कर दिया गया है और इसे दस्तावेज़ से हटा दिया गया है.slateSettings
ऑब्जेक्ट या उसकी प्रॉपर्टी से जुड़े गड़बड़ी के मैसेज भी हटा दिए गए हैं. आखिर में, शुरू करें गाइड से "स्लेट दिखाना" सेक्शन हटा दिया गया है.
-
एपीआई अब
liveCuepoints.insert
तरीके का इस्तेमाल करके, स्ट्रीम में दिखने वाली स्लेट डालने की सुविधा नहीं देता. यह परिवर्तन दर्शाने के लिए निम्नलिखित दस्तावेज़ अपडेट कर दिए गए हैं:-
इंडेक्स पेज, शुरुआती निर्देश गाइड, और ब्रॉडकास्ट की अवधि ट्यूटोरियल में अब इस सुविधा के बारे में जानकारी नहीं दी गई है.
-
liveCuepoint
संसाधन कीsettings.cueType
प्रॉपर्टी, अब प्रॉपर्टी वैल्यू के तौर परslate
के साथ काम नहीं करती. (सिर्फ़ad
वैल्यू का इस्तेमाल किया जा सकता है. -
liveCuepoint
संसाधन कीsettings.eventState
प्रॉपर्टी अब काम नहीं करती है. साथ ही, इसे दस्तावेज़ से हटा दिया गया है.
-
18 मार्च, 2013
इस अपडेट में ये बदलाव किए गए हैं:
-
एपीआई के सभी गड़बड़ी वाले मैसेज को अपडेट कर दिया गया है. इससे संभावित गड़बड़ियों के बारे में ज़्यादा साफ़ तौर पर बताया जा सकेगा. साथ ही, जहां भी मुमकिन होगा, उन्हें ठीक करने के बारे में दिशा-निर्देश दिए जा सकेंगे.
-
एपीआई अब कई नई गड़बड़ियां दिखा सकता है. यहां दी गई सूची में, गड़बड़ी और उस एपीआई तरीके के बारे में बताया गया है जिससे वह गड़बड़ी दिख सकती है:
liveBroadcasts.insert
– ब्रॉडकास्ट के शेड्यूल किए गए खत्म होने का समय, उसके शेड्यूल किए गए शुरू होने के समय के बाद का होना चाहिए.liveBroadcasts.insert
– ब्रॉडकास्ट के लिए निजता की स्थिति अमान्य है.liveBroadcasts.update
– रिसॉर्स मेंcontentDetails.enableArchive
प्रॉपर्टी के लिए कोई वैल्यू मौजूद नहीं है या सेट नहीं की गई है.liveBroadcasts.update
– रिसॉर्स मेंcontentDetails.enableContentEncryption
प्रॉपर्टी के लिए कोई वैल्यू मौजूद नहीं है या सेट नहीं की गई है.liveBroadcasts.update
– रिसॉर्स मेंcontentDetails.enableDvr
प्रॉपर्टी के लिए कोई वैल्यू मौजूद नहीं है या सेट नहीं की गई है.liveStreams.insert
– स्निपेट का टाइटल 1 से 128 वर्णों के बीच होना चाहिए.liveStreams.update
– रिसॉर्स मेंsnippet.title
प्रॉपर्टी के लिए कोई वैल्यू मौजूद नहीं है या सेट नहीं की गई है.
-
liveStream
संसाधन के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि मल्टीकास्ट और WebM, कॉन्टेंट को शामिल करने के ऐसे तरीके नहीं हैं जिनके बारे में पहले बताया गया था.cdn.format
प्रॉपर्टी के फ़ॉर्मैट की सूची को अपडेट कर दिया गया है. साथ ही,cdn.multicastIngestionInfo
ऑब्जेक्ट और उसकी चाइल्ड प्रॉपर्टी को संसाधन के दस्तावेज़ से हटा दिया गया है. इसके अलावा,http
कोcdn.ingestionType
एट्रिब्यूट की इस्तेमाल की जा सकने वाली वैल्यू की सूची से हटा दिया गया है.