YouTube लाइव स्ट्रीमिंग एपीआई - बदलाव का इतिहास

इस पेज पर, YouTube Live Streaming API में हुए बदलावों और दस्तावेज़ों के अपडेट की जानकारी दी गई है. बदलावों के इस लॉग की सदस्यता लें.

12 जनवरी, 2026

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

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

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

ब्रॉडकास्ट का मालिक, अपने-आप दिखने वाले विज्ञापनों की सुविधा चालू करता है, तो उसके पास इनमें से कोई एक विकल्प चुनने का विकल्प होता है:

YouTube को वीडियो के बीच में विज्ञापन दिखाने की अनुमति दें. इस विकल्प में तीन मोड काम करते हैं:

कम: इससे आपकी कम कमाई होगी, लेकिन दर्शकों को कॉन्टेंट देखते समय कम रुकावटें आएंगी
सामान्य: इससे आपकी कमाई ठीक-ठाक हो सकेगी, दर्शकों को वीडियो देखने का मिला-जुला अनुभव मिलेगा
ज़्यादा: इससे आपकी ज़्यादा कमाई होगी, लेकिन दर्शकों को कॉन्टेंट देखते समय ज़्यादा रुकावटें आएंगी

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

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

इस सुविधा के साथ काम करने के लिए, दस्तावेज़ में एपीआई से जुड़े इन बदलावों के बारे में बताया गया है:

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

14 जुलाई, 2025

liveChatMessages.streamList तरीके के ब्यौरे को अपडेट किया गया है, ताकि streamList API के इस्तेमाल के बारे में दिशा-निर्देश दिए जा सकें.

9 अक्टूबर, 2023

सिर्फ़ जानकारी के लिए, इस CSV फ़ाइल में जाकर देखें कि कौनसे स्टिकर आईडी, किन सुपर स्टिकर से जुड़े हैं. इस जानकारी को दिखाने के लिए, 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

HLS के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करने से जुड़ी गाइड के ज़रूरी शर्तें सेक्शन में दो बदलाव किए गए हैं:

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

28 जून, 2019

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

एचएलएस की मदद से YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड में, एन्कोडर से YouTube पर लाइव कॉन्टेंट स्ट्रीम करने के लिए एचएलएस का इस्तेमाल करने से जुड़े दिशा-निर्देश दिए गए हैं. इस गाइड का मकसद, एन्कोडर वेंडर को अपने प्रॉडक्ट में एचएलएस डिलीवरी की सुविधा जोड़ने में मदद करना है.

4 अप्रैल, 2019

इस अपडेट में ये बदलाव किए गए हैं:

एपीआई के रेफ़रंस दस्तावेज़ को अपडेट किया गया है. इससे हर तरीके के इस्तेमाल के सामान्य उदाहरणों को बेहतर तरीके से समझाया जा सकेगा. साथ ही, APIs Explorer विजेट के ज़रिए डाइनैमिक और अच्छी क्वालिटी वाले कोड सैंपल उपलब्ध कराए जा सकेंगे. उदाहरण के लिए, liveBroadcasts.list तरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में बताने वाले पेजों पर, अब दो नए एलिमेंट मौजूद हैं:
- APIs Explorer विजेट की मदद से, ऑथराइज़ेशन स्कोप चुने जा सकते हैं. साथ ही, पैरामीटर और प्रॉपर्टी की सैंपल वैल्यू डाली जा सकती हैं. इसके बाद, एपीआई के असली अनुरोध भेजे जा सकते हैं और एपीआई के असली जवाब देखे जा सकते हैं. इस विजेट में फ़ुलस्क्रीन व्यू भी उपलब्ध है. इसमें कोड के पूरे सैंपल दिखते हैं. ये सैंपल, आपके डाले गए स्कोप और वैल्यू के हिसाब से डाइनैमिक तरीके से अपडेट होते हैं.
- इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताई गई विधि के इस्तेमाल के एक या उससे ज़्यादा सामान्य उदाहरणों के बारे में बताया गया है. उदाहरण के लिए, किसी ब्रॉडकास्ट के बारे में डेटा पाने के लिए या मौजूदा उपयोगकर्ता के ब्रॉडकास्ट के बारे में डेटा पाने के लिए, liveBroadcasts.list तरीके को कॉल किया जा सकता है.
  
  उस सेक्शन में दिए गए लिंक का इस्तेमाल करके, एपीआई एक्सप्लोरर में अपने इस्तेमाल के उदाहरण के लिए सैंपल वैल्यू भरी जा सकती हैं. इसके अलावा, उन वैल्यू के साथ एपीआई एक्सप्लोरर को फ़ुलस्क्रीन में खोला जा सकता है. इन बदलावों का मकसद, आपके लिए ऐसे कोड सैंपल देखना आसान बनाना है जो सीधे तौर पर उस इस्तेमाल के उदाहरण पर लागू होते हैं जिसे आपको अपने ऐप्लिकेशन में लागू करना है.
फ़िलहाल, कोड के सैंपल Java, JavaScript, PHP, Python, और curl के लिए उपलब्ध हैं.
कोड सैंपल पेज का यूज़र इंटरफ़ेस (यूआई) भी नया है. इसमें ऊपर बताई गई सभी सुविधाएं मिलती हैं. इस टूल का इस्तेमाल करके, अलग-अलग तरीकों के इस्तेमाल के उदाहरण देखे जा सकते हैं. साथ ही, APIs Explorer में वैल्यू लोड की जा सकती हैं. इसके अलावा, Java, JavaScript, PHP, और Python में कोड के सैंपल पाने के लिए, APIs Explorer को फ़ुलस्क्रीन मोड में खोला जा सकता है.

इस बदलाव के साथ ही, उन पेजों को हटा दिया गया है जिन पर Java, PHP, और Python के लिए उपलब्ध कोड सैंपल की सूची दी गई थी.

25 फ़रवरी, 2019

liveChatMessage और superChatEvent संसाधनों के दस्तावेज़ अपडेट कर दिए गए हैं. इससे पता चलता है कि अब दोनों संसाधनों में Super Stickers के बारे में जानकारी शामिल हो सकती है. सुपर स्टिकर्स, सुपर चैट मैसेज का एक टाइप है. इसमें एक इमेज दिखती है. अन्य सुपर चैट की तरह, Super Sticker मैसेज को भी YouTube लाइव स्ट्रीम के दौरान कोई प्रशंसक खरीदता है.

liveChatMessage संसाधन में, अब snippet.type प्रॉपर्टी को superStickerEvent पर सेट कर दिया गया है. इससे पता चलता है कि संसाधन में सुपर स्टिकर के बारे में जानकारी शामिल है. ऐसे में, संसाधन में snippet.superStickerDetails ऑब्जेक्ट भी शामिल होता है. इसमें Super Sticker के बारे में ज़्यादा जानकारी होती है.
superChatEvent संसाधन में, बूलियन snippet.isSuperStickerEvent से पता चलता है कि सुपर चैट मैसेज, सुपर स्टिकर भी है या नहीं. अगर ऐसा है, तो snippet.superStickerMetadata ऑब्जेक्ट में Super Sticker के बारे में अतिरिक्त जानकारी होती है.

5 अप्रैल, 2018

superChatEvents.list तरीके के ब्यौरे को अपडेट कर दिया गया है. इससे पता चलता है कि एपीआई के जवाब में अब fanFundingEvents शामिल नहीं हैं. इन्हें 2017 की शुरुआत में बंद कर दिया गया था.

3 अप्रैल, 2017

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

13 फ़रवरी, 2017

इस अपडेट में ये बदलाव किए गए हैं:

मौजूदा संसाधनों और तरीकों में हुए अपडेट
- liveCuepoints.insert तरीके को अपडेट किया गया है, ताकि यह पता चल सके कि onBehalfOfContentOwner पैरामीटर की जानकारी देना ज़रूरी है. इसके अलावा, इस तरीके के बारे में दी गई जानकारी को अपडेट किया गया है. इसमें बताया गया है कि इस तरीके को कॉल करने के लिए, YouTube Content Owner से जुड़े खाते से अनुमति लेनी होगी.

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 हैं.

गड़बड़ी की जानकारी
`liveBroadcasts.insert`, `liveBroadcasts.update`	`liveBroadcasts.insert` और `liveBroadcasts.update` तरीके, `400` (`Bad Request`) गड़बड़ियां दिखाते हैं. इससे पता चलता है कि डाली जा रही या अपडेट की जा रही `liveBroadcast` रिसॉर्स में, `contentDetails.enableEmbed` प्रॉपर्टी या `contentDetails.projection` प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद है. इन दो नई गड़बड़ियों की वजहें, `invalidEmbedSetting` और `invalidProjection` हैं.

12 जनवरी, 2017

ध्यान दें: यह सुविधा बंद होने की सूचना है.

सुपर चैट की नई सुविधा के रिलीज़ होने के साथ ही, YouTube ने फ़ैन फ़ंडिंग की सुविधा को बंद कर दिया है. साथ ही, फ़ैन फ़ंडिंग API को 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 हो.

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

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 एट्रिब्यूट की इस्तेमाल की जा सकने वाली वैल्यू की सूची से हटा दिया गया है.