इस पेज पर, YouTube Live Streaming API में हुए बदलावों और दस्तावेज़ के अपडेट की सूची दी गई है.
12 अक्टूबर, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई से मिली जानकारी को सटीक तरीके से दिखाने के लिए,
liveChatMessageसंसाधन कीsnippet.giftEventDetailsप्रॉपर्टी को बदलकरsnippet.giftDetailsकर दिया गया है.
18 अगस्त, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
liveBroadcasts.updateतरीके के दस्तावेज़ को अपडेट कर दिया गया है, ताकि कमाई करने से जुड़ी नई गड़बड़ियों को शामिल किया जा सके:preconditionFailed (412)(वजह:videoNotEligibleForAdsMonetization) औरbackendError (503)(वजह:backendError).
17 अगस्त, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
liveBroadcastसंसाधन की नईsnippet.categoryIdप्रॉपर्टी की मदद से, लाइव ब्रॉडकास्ट से जुड़ी वीडियो कैटगरी को सेट, अपडेट, और वापस पाया जा सकता है.
20 जुलाई, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
विज्ञापनों को फिर से दिखाने के लिए, अब
monetizationDetails.cuepointSchedule.pauseAdsUntilप्रॉपर्टी को पिछली तारीख और समय या खाली वैल्यू पर सेट किया जा सकता है.
9 जुलाई, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
liveChatBans.insertके दस्तावेज़ में अब यह बताया गया है किsnippet.typeप्रॉपर्टी,permanentयाtemporaryहोनी चाहिए.liveChatMessage.insertके दस्तावेज़ से साफ़ तौर पर पता चलता है किquestionText,metadataकी डायरेक्ट प्रॉपर्टी है. साथ ही,options, ऑब्जेक्ट का एक कलेक्शन है. इसमें हर ऑब्जेक्ट में एकoptionTextफ़ील्ड होता है.
1 जून, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
liveBroadcastसंसाधन कीcontentDetails.availabilityConfigप्रॉपर्टी की मदद से, लाइव ब्रॉडकास्ट के लिए देश/इलाके के हिसाब से पाबंदियां तय की जा सकती हैं. इससे लाइव इवेंट को देश/इलाके के हिसाब से मैनेज किया जा सकता है.
26 मार्च, 2026
इस अपडेट में ये बदलाव शामिल हैं:
-
snippet.typeप्रॉपर्टी में अब नई वैल्यूgiftEventका इस्तेमाल किया जा सकता है. -
liveChatMessageसंसाधन की नईsnippet.giftEventDetailsप्रॉपर्टी और उसके चाइल्ड में, उपहार वाले इवेंट की जानकारी होती है.
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 पर अब एक और सुविधा उपलब्ध है. इसकी मदद से, ब्रॉडकास्ट के दौरान वीडियो के बीच में विज्ञापन के लिए ब्रेक, तय किए गए इंटरवल पर अपने-आप जोड़े जा सकते हैं.
अगर ब्रॉडकास्ट का मालिक, अपने-आप विज्ञापन दिखाने की सुविधा चालू करता है, तो वह विज्ञापन के व्यवहार से जुड़े ये पहलू देख सकता है:
- वीडियो के बीच में दिखने वाले विज्ञापनों के बीच का अंतराल.
- विज्ञापन के क्यू पॉइंट शेड्यूल करने की रणनीति. क्यू पॉइंट, सभी दर्शकों के लिए एक साथ डाले जा सकते हैं या फिर हर दर्शक के लिए क्यू पॉइंट का समय अलग-अलग हो सकता है. दूसरी रणनीति की मदद से, YouTube ज़्यादा तेज़ी से क्यू पॉइंट शेड्यूल कर पाता है. इससे दर्शकों को क्यू पॉइंट तब मिलते हैं, जब वे इसके लिए ज़रूरी शर्तें पूरी करते हैं.
- वह समयावधि जिसके दौरान वीडियो के बीच में विज्ञापन नहीं दिखाए जाते. इस सुविधा के लिए, ब्रॉडकास्ट का मालिक यह तय करता है कि वीडियो के बीच में विज्ञापन दिखाने की सुविधा को किसी खास समय तक के लिए रोक दिया जाए.
इस सुविधा के साथ काम करने के लिए, दस्तावेज़ में एपीआई से जुड़े ये बदलाव किए गए हैं:
liveBroadcastसंसाधन में अब एकmonetizationDetailsऑब्जेक्ट शामिल है. ऑब्जेक्ट के फ़ील्ड से पता चलता है कि ब्रॉडकास्ट के लिए, विज्ञापन अपने-आप दिखने की सुविधा चालू है या नहीं. साथ ही, क्यू पॉइंट शेड्यूल करने के लिए अतिरिक्त जानकारी दी जाती है.liveBroadcast.listतरीके केpartपैरामीटर के लिए,monetizationDetailsवैल्यू का इस्तेमाल किया जा सकता है.updateतरीके का इस्तेमाल करके, लाइव ब्रॉडकास्ट के बीच में विज्ञापन दिखाने की सुविधा को कुछ समय के लिए रोका जा सकता है. दस्तावेज़ में अब ऐसी कई गड़बड़ियों की पहचान भी की जाती है जो लाइव ब्रॉडकास्ट के लिए, कमाई करने की सुविधा से जुड़ी जानकारी अपडेट करते समय हो सकती हैं.
1 अगस्त, 2023
इस अपडेट में ये बदलाव शामिल हैं:
-
liveBroadcasts.updateतरीके के लिए, अब इन फ़ील्ड में वैल्यू डालने की ज़रूरत नहीं है:snippet.titlestatus.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.enableContentEncryptioncontentDetails.enableDvrcontentDetails.enableEmbedcontentDetails.recordFromStartcontentDetails.startWithSlate
अनुरोध में इन फ़ील्ड को शामिल न करने पर, इनमें कोई बदलाव नहीं होगा.
-
liveBroadcastके उन फ़ील्ड के लिए दस्तावेज़ हटाए गए जो अब इस्तेमाल में नहीं हैं:contentDetails.enableContentEncryptioncontentDetails.startWithSlate
1 अप्रैल, 2022
इस अपडेट में ये बदलाव शामिल हैं:
-
snippet.typeप्रॉपर्टी में अब दो नई वैल्यू इस्तेमाल की जा सकती हैं:membershipGiftingEventgiftMembershipReceivedEvent
-
liveChatMessageसंसाधन की नईsnippet.membershipGiftingDetailsप्रॉपर्टी और इसके चाइल्ड में, सदस्यता का उपहार देने वाले इवेंट की जानकारी होती है. इसी तरह, नईsnippet.giftMembershipReceivedDetailsप्रॉपर्टी और इसकी चाइल्ड प्रॉपर्टी में, उपहार में मिली सदस्यता के इवेंट की जानकारी होती है.
15 सितंबर, 2021
इस अपडेट में ये बदलाव शामिल हैं:
-
snippet.typeप्रॉपर्टी में अब दो नई वैल्यू इस्तेमाल की जा सकती हैं:newSponsorEventmemberMilestoneChatEvent
-
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 फ़ील्ड, 17 अगस्त, 2020 से काम नहीं करेगा. इसे अप्रैल 2016 में बंद कर दिया गया था. इस तारीख के बाद, इस फ़ील्ड का इस्तेमाल करने वाले अनुरोधों को प्रोसेस नहीं किया जाएगा.
अगर आपका कोड अब भी cdn.format फ़ील्ड का इस्तेमाल करता है, तो उसे अपडेट करना होगा. इसके लिए, cdn.frameRate और cdn.resolution प्रॉपर्टी का इस्तेमाल करके, फ़्रेम रेट और रिज़ॉल्यूशन की जानकारी अलग-अलग दें.
6 जुलाई, 2020
एचएलएस की मदद से YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड को अपडेट किया गया है. इसमें ये बदलाव किए गए हैं:
- मीडिया सेगमेंट के लिए सुझाई गई अवधि को अपडेट करके, एक से चार सेकंड कर दिया गया है.
- एक नए सेक्शन में, YouTube Creator Studio से एचएलएस इनजेशन यूआरएल पाने का तरीका बताया गया है.
-
fileपैरामीटर वैल्यू को फ़ॉर्मैट करने के निर्देश, नए सेक्शन एचएलएस से लाइव स्ट्रीमिंग करने के लिए यूआरएल को पूरा करना में ले जाए गए हैं. ये निर्देश इस बात पर निर्भर नहीं करते कि एचएलएस इंजेक्शन यूआरएल, 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 के साथ काम करती है. इससे एचएलएस का इस्तेमाल करके, YouTube पर डाली गई स्ट्रीम की पहचान की जा सकती है.
एचएलएस के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड में, किसी एन्कोडर से YouTube पर लाइव कॉन्टेंट स्ट्रीम करने के लिए, एचएलएस का इस्तेमाल करने से जुड़े दिशा-निर्देश दिए गए हैं. इस गाइड का मकसद, एन्कोडर वेंडर को उनके प्रॉडक्ट में एचएलएस डिलीवरी की सुविधा जोड़ने में मदद करना है.
4 अप्रैल, 2019
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई के संदर्भ दस्तावेज़ को अपडेट किया गया है, ताकि हर तरीके के सामान्य इस्तेमाल के उदाहरणों को बेहतर तरीके से समझाया जा सके. साथ ही, APIs explorer विजेट के ज़रिए डाइनैमिक और अच्छी क्वालिटी के कोड सैंपल उपलब्ध कराए जा सकें. उदाहरण के लिए,
liveBroadcasts.listतरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में बताने वाले पेजों पर, अब दो नए एलिमेंट मौजूद हैं:-
APIs Explorer विजेट की मदद से, अनुमति के स्कोप चुने जा सकते हैं. साथ ही, सैंपल पैरामीटर और प्रॉपर्टी वैल्यू डाली जा सकती हैं. इसके बाद, असल एपीआई अनुरोध भेजे जा सकते हैं और एपीआई से मिली असल जानकारी देखी जा सकती है. विजेट में फ़ुलस्क्रीन व्यू भी मिलता है. इसमें कोड के पूरे सैंपल दिखते हैं. ये सैंपल, आपके डाले गए स्कोप और वैल्यू का इस्तेमाल करने के लिए डाइनैमिक तौर पर अपडेट होते हैं.
-
इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताए गए तरीके के इस्तेमाल के एक या उससे ज़्यादा सामान्य उदाहरण दिए गए हैं. उदाहरण के लिए, किसी खास ब्रॉडकास्ट या मौजूदा उपयोगकर्ता के ब्रॉडकास्ट का डेटा पाने के लिए,
liveBroadcasts.listतरीके को कॉल किया जा सकता है.उस सेक्शन में मौजूद लिंक का इस्तेमाल करके, अपने इस्तेमाल के उदाहरण के लिए, APIs Explorer में सैंपल वैल्यू भरी जा सकती हैं. इसके अलावा, उन वैल्यू के साथ फ़ुलस्क्रीन APIs Explorer को खोला जा सकता है. इन बदलावों का मकसद, आपको ऐसे कोड सैंपल दिखाना है जो सीधे तौर पर उस इस्तेमाल के उदाहरण पर लागू होते हैं जिसे आपको अपने ऐप्लिकेशन में लागू करना है.
फ़िलहाल, कोड सैंपल Java, JavaScript, PHP, Python, और curl के लिए उपलब्ध हैं.
-
-
कोड सैंपल पेज पर भी एक नया यूज़र इंटरफ़ेस (यूआई) है. इसमें ऊपर बताई गई सभी सुविधाएं मौजूद हैं. इस टूल का इस्तेमाल करके, अलग-अलग तरीकों के इस्तेमाल के उदाहरण देखे जा सकते हैं. साथ ही, APIs Explorer में वैल्यू लोड की जा सकती हैं और फ़ुलस्क्रीन APIs Explorer को खोला जा सकता है. इससे आपको Java, JavaScript, PHP, और Python में कोड सैंपल मिल सकते हैं.
इस बदलाव के साथ ही, Java, PHP, और Python के लिए उपलब्ध कोड सैंपल की सूची वाले पेजों को हटा दिया गया है.
25 फ़रवरी, 2019
liveChatMessage और superChatEvent संसाधनों के दस्तावेज़ को अपडेट कर दिया गया है. इससे पता चलता है कि दोनों संसाधनों में अब सुपर स्टिकर्स के बारे में जानकारी शामिल हो सकती है. सुपर स्टिकर्स, सुपर चैट मैसेज का एक टाइप है. इसमें एक इमेज दिखती है. अन्य सुपर चैट की तरह, सुपर स्टिकर मैसेज को भी YouTube लाइव स्ट्रीम के दौरान कोई प्रशंसक खरीदता है.
liveChatMessageसंसाधन में,snippet.typeप्रॉपर्टी को अबsuperStickerEventपर सेट किया गया है. इससे पता चलता है कि संसाधन में सुपर स्टिकर के बारे में जानकारी है. ऐसे में, संसाधन मेंsnippet.superStickerDetailsऑब्जेक्ट भी शामिल होता है. इसमें सुपर स्टिकर के बारे में ज़्यादा जानकारी होती है.superChatEventसंसाधन में, बूलियनsnippet.isSuperStickerEventसे पता चलता है कि सुपर चैट मैसेज, सुपर स्टिकर भी है या नहीं. अगर ऐसा है, तोsnippet.superStickerMetadataऑब्जेक्ट में सुपर स्टिकर के बारे में ज़्यादा जानकारी शामिल होती है.
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.updateliveBroadcasts.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 पर लाइव कॉन्टेंट डिलीवर करना गाइड में, DASH डिलीवरी फ़ॉर्मैट का इस्तेमाल करके, एन्कोडर से YouTube पर लाइव डेटा स्ट्रीम करने के बारे में दिशा-निर्देश दिए गए हैं. इसका मकसद, एन्कोडर वेंडर को उनके प्रॉडक्ट में 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.bindliveBroadcasts.bindमेथड,403(Forbidden) गड़बड़ी दिखाता है. इससे पता चलता है कि उपयोगकर्ता ने तय समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं. गड़बड़ी की वजहuserRequestsExceedRateLimitहै.liveBroadcasts.insertऔरliveBroadcasts.updateतरीकों में पहले से ही यह गड़बड़ी मौजूद है.liveStreams.insertliveStreams.insertतरीके में चार नई400(Bad Request) गड़बड़ियां दिखती हैं. इनसे,liveStreamसंसाधन में मौजूद अमान्य प्रॉपर्टी वैल्यू की पहचान की जाती है. अनुरोध के ज़रिए, इस संसाधन को डालने की कोशिश की गई थी. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
invalidFormat:cdn.formatinvalidFrameRate:cdn.frameRateinvalidIngestionType:cdn.ingestionTypeinvalidResolution:cdn.resolution
liveStreams.insertliveStreams.insertतरीके में, दो नई400(Bad Request) गड़बड़ियां दिख सकती हैं. इनमें से हर गड़बड़ी से पता चलता है कि अनुरोध के ज़रिए जिसliveStreamसंसाधन को शामिल करने की कोशिश की गई थी उसमें ज़रूरी वैल्यू मौजूद नहीं है. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
frameRateRequired:cdn.frameRateresolutionRequired: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.formatcdn.frameRatecdn.ingestionTypecdn.resolution
reason,liveStreamModificationNotAllowedहै.
-
18 दिसंबर, 2015
यूरोपियन यूनियन (ईयू) के कानूनों के मुताबिक, ईयू में रहने वाले असली उपयोगकर्ताओं को कुछ जानकारी देना और उनसे सहमति लेना ज़रूरी है. इसलिए, यूरोपियन यूनियन में रहने वाले असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने इस ज़रूरी शर्त की सूचना, YouTube API की सेवा की शर्तों में जोड़ दी है.
17 दिसंबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
नए संसाधन और तरीके
-
इस एपीआई में कई नए संसाधन जोड़े गए हैं, ताकि लाइव ब्रॉडकास्ट के दौरान चैट की सुविधा काम कर सके. YouTube, लाइव ब्रॉडकास्ट के दौरान लाइव चैट की सुविधा देता है. इन संसाधनों और उनके तरीकों से, चैट मैसेज को वापस पाया जा सकता है. साथ ही, चैट को मैनेज करने से जुड़े काम भी किए जा सकते हैं.
संसाधन liveChatMessageयह संसाधन, YouTube लाइव चैट में मौजूद किसी मैसेज को दिखाता है. YouTube पर कई तरह के मैसेज दिखाए जा सकते हैं. इनमें टेक्स्ट मैसेज और फ़ैन फ़ंडिंग इवेंट शामिल हैं. कुछ मैसेज टाइप से चैट के किसी खास चरण की पहचान होती है. जैसे, सिर्फ़ पैसे चुकाकर बने सदस्यों के लिए चैट की सुविधा शुरू होने या चैट खत्म होने का चरण. एपीआई में लाइव चैट के मैसेज की सूची बनाने, उन्हें शामिल करने, और मिटाने के तरीके शामिल हैं. liveChatModeratorsयह संसाधन, चैट मॉडरेटर की पहचान करता है. मॉडरेटर, एडमिन से जुड़े कुछ काम कर सकते हैं. जैसे, चैट से उपयोगकर्ताओं पर पाबंदी लगाना या मैसेज हटाना. एपीआई में लाइव चैट के मॉडरेटर की सूची बनाने, उन्हें जोड़ने, और हटाने के तरीके मौजूद हैं. liveChatBansइस संसाधन से, उस उपयोगकर्ता की पहचान की जाती है जिस पर किसी लाइव चैट में मैसेज पोस्ट करने पर पाबंदी लगाई गई है. चैनल पर कुछ समय के लिए या हमेशा के लिए पाबंदी लगाई जा सकती है. इस एपीआई की मदद से, लाइव चैट पर पाबंदी लगाने और उसे हटाने के तरीके इस्तेमाल किए जा सकते हैं. fanFundingEventsयह संसाधन, YouTube चैनल पर फ़ैन फ़ंडिंग इवेंट को दिखाता है. फ़ैन फ़ंडिंग की सुविधा से, दर्शक अपनी मर्ज़ी से YouTube क्रिएटर्स को एक बार पैसे देकर उनकी मदद कर सकते हैं.
एपीआई काfanFundingEvents.listतरीका, किसी चैनल के फ़ैन फ़ंडिंग इवेंट की सूची दिखाता है. चैनल के लाइव ब्रॉडकास्ट के दौरान, लाइव चैट के ज़रिए शुरू किए गए फ़ैन फ़ंडिंग इवेंट से भी ब्रॉडकास्ट की लाइव चैट मेंfanFundingEventमैसेज ट्रिगर होता है.
फ़ैन फ़ंडिंग के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.sponsorssponsorसंसाधन, 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 Creator 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 क्रिएटर ब्लॉग देखें.
21 अगस्त, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
liveBroadcasts.controlतरीके केwalltimeपैरामीटर की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि प्रॉपर्टी की वैल्यू, ISO 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ss.sssZ) में दी गई है. -
एपीआई अब इन गड़बड़ियों के बारे में जानकारी देता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा insufficientPermissionsliveStreamingNotEnabledअगर एपीआई अनुरोध को अनुमति देने वाले उपयोगकर्ता को YouTube पर लाइव वीडियो स्ट्रीम करने की अनुमति नहीं मिली है, तो liveBroadcastऔरliveStreamसंसाधनों के लिए सभी तरीके यह गड़बड़ी दिखाते हैं. उपयोगकर्ता को लाइव वीडियो स्ट्रीम करने की अनुमति क्यों नहीं है, इस बारे में ज़्यादा जानकारी https://www.youtube.com/features पर जाकर, उपयोगकर्ता के चैनल की सेटिंग में मिल सकती है.rateLimitExceededuserRequestsExceedRateLimitliveBroadcasts.insertऔरliveStreams.insert, दोनों तरीके यह गड़बड़ी दिखाते हैं. इससे पता चलता है कि उपयोगकर्ता ने तय समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं.
2 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
liveStreamसंसाधन औरliveBroadcasts.bindतरीके के ब्यौरे अपडेट किए गए हैं. इनमें बताया गया है कि ब्रॉडकास्ट को सिर्फ़ एक वीडियो स्ट्रीम से जोड़ा जा सकता है. हालांकि, वीडियो स्ट्रीम को एक से ज़्यादा ब्रॉडकास्ट से जोड़ा जा सकता है. यह बदलाव सिर्फ़ दस्तावेज़ में किया गया है. एपीआई के काम करने के तरीके में कोई बदलाव नहीं हुआ है. -
liveBroadcastरिसॉर्स कीcontentDetails.monitorStream.enableMonitorStreamप्रॉपर्टी को अपडेट किया गया है. इससे यह जानकारी मिलती है कि अगर प्रॉपर्टी की वैल्यूtrueहै, तो आपको ब्रॉडकास्ट कोliveस्थिति में बदलने से पहले, उसेtestingस्थिति में बदलना होगा. अगर प्रॉपर्टी की वैल्यूfalseहै, तो आपके ब्रॉडकास्ट मेंtestingस्टेज नहीं हो सकता. इसलिए, ब्रॉडकास्ट को सीधेliveस्टेटस में ट्रांज़िशन किया जा सकता है. -
liveCuepointसंसाधन कीsettings.offsetTimeMsप्रॉपर्टी को अपडेट किया गया है. इससे यह पता चलता है कि अगर आपके ब्रॉडकास्ट में मॉनिटर स्ट्रीम नहीं है, तो आपको प्रॉपर्टी के लिए कोई वैल्यू नहीं देनी चाहिए. -
liveBroadcastऔरliveStreamसंसाधनों के लिए, अब सभी तरीकों मेंonBehalfOfContentOwnerऔरonBehalfOfContentOwnerChannelपैरामीटर का इस्तेमाल किया जा सकता है. इन पैरामीटर की मदद से, एक ही कॉन्टेंट के मालिक से जुड़े अलग-अलग चैनलों के लिए, एपीआई अनुरोधों को पूरा करने के लिए, एक ही अनुमति क्रेडेंशियल का इस्तेमाल किया जा सकता है. -
liveCuepoints.insertतरीके के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि उस तरीके को कॉल करते समय,settings.walltimeप्रॉपर्टी के लिए वैल्यू सेट की जा सकती है. -
गड़बड़ी के दस्तावेज़ में अब हर तरह की गड़बड़ी के लिए, एचटीटीपी रिस्पॉन्स कोड की जानकारी दी गई है.
-
अब एपीआई में यह गड़बड़ी दिखती है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा insufficientPermissionslivePermissionBlockedअगर अनुरोध को अनुमति देने वाला उपयोगकर्ता, 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, दोनों से हटा दिया गया है. -
एपीआई में ये नई गड़बड़ियां दिखती हैं:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा invalidValueconflictingTimeFieldsअगर आपके अनुरोध में offsetTimeMsऔरwalltimeपैरामीटर के लिए वैल्यू दी गई हैं, तोliveBroadcasts.controlतरीका यह गड़बड़ी दिखाता है. अनुरोध में दोनों पैरामीटर को छोड़ा जा सकता है या दोनों में से किसी एक पैरामीटर के लिए वैल्यू तय की जा सकती है.invalidValueinvalidWalltimeअगर walltimeपैरामीटर की वैल्यू अमान्य है, तोliveBroadcasts.controlतरीका यह गड़बड़ी दिखाता है.forbiddenenableClosedCaptionsModificationNotAllowedअगर contentDetails.enableClosedCaptionsवैल्यू को अपडेट करने की कोशिश की जाती है और ब्रॉडकास्ट की स्थितिcreatedयाreadyनहीं है, तोliveBroadcasts.updateतरीका यह गड़बड़ी दिखाता है.invalidValueconflictingTimeFieldsअगर आपके अनुरोध में 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की इस्तेमाल की जा सकने वाली वैल्यू की सूची से हटा दिया गया है.