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

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

9 जुलाई, 2025

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

  • 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 को वीडियो के बीच में विज्ञापन दिखाने की अनुमति दें. इस विकल्प में तीन मोड काम करते हैं:
    • कम: इससे आपकी कम कमाई होगी, लेकिन दर्शकों को कॉन्टेंट देखते समय कम रुकावटें आएंगी
    • सामान्य: इससे आपकी कमाई ठीक-ठाक हो सकेगी, दर्शकों को वीडियो देखने का मिला-जुला अनुभव मिलेगा
    • ज़्यादा: इससे आपकी ज़्यादा कमाई होगी, लेकिन दर्शकों को कॉन्टेंट देखते समय ज़्यादा रुकावटें आएंगी
  • वीडियो के बीच में विज्ञापन दिखाने की रणनीति और इंटरवल को मैन्युअल तरीके से कॉन्फ़िगर करें. इस मामले में, मालिक को दो पैरामीटर सेट अप करने होंगे:
    1. विज्ञापन के लिए तय किए गए समय के हिसाब से विज्ञापन दिखाने की रणनीति. सभी दर्शकों के लिए, एक साथ क्यू पॉइंट डाले जा सकते हैं. इसके अलावा, क्यू पॉइंट का समय दर्शक के हिसाब से अलग-अलग हो सकता है. दूसरी रणनीति की मदद से, YouTube ज़्यादा से ज़्यादा क्यूपॉइंट शेड्यूल कर पाता है. इससे दर्शकों को क्यूपॉइंट तब मिलते हैं, जब वे इसके लिए ज़रूरी शर्तें पूरी करते हैं.
    2. वीडियो के बीच में दिखने वाले विज्ञापनों के बीच के अंतराल की अवधि.

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

  • 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 इनजेशन यूआरएल पूरा करना सेक्शन में ले जाया गया है. ये निर्देश इस बात से कोई फ़र्क़ नहीं डालते कि एचएलएस इनजेशन यूआरएल, YouTube API या YouTube Creator Studio से मिला है या नहीं.

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

16 अप्रैल, 2020

इस अपडेट में, नई प्रॉपर्टी और बंद होने वाली सुविधा के बारे में जानकारी शामिल है:

  • liveBroadcast संसाधन अब contentDetails.enableAutoStop प्रॉपर्टी के साथ काम करता है. इस प्रॉपर्टी से पता चलता है कि चैनल के मालिक के वीडियो स्ट्रीम करना बंद करने के करीब एक मिनट बाद, ब्रॉडकास्ट अपने-आप बंद हो जाना चाहिए या नहीं.

    ब्रॉडकास्ट की अवधि वाले दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि contentDetails.enableAutoStart या contentDetails.enableAutoStop प्रॉपर्टी को true पर सेट करने पर, YouTube पर लाइव इवेंट बनाने और मैनेज करने की सिलसिलेवार प्रोसेस में कैसे बदलाव होता है.

  • ध्यान दें: यह सुविधा बंद होने की सूचना है. ये बदलाव 1 सितंबर, 2020 को या इसके बाद लागू होंगे. बदलाव लागू होने की तारीख को यहां बंद होने की तारीख के तौर पर बताया गया है.

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

    अगर इनमें से कोई भी स्थिति सही है, तो आपके आवेदन पर असर पड़ेगा:

    • यह liveBroadcast संसाधन की isDefaultBroadcast प्रॉपर्टी की वैल्यू की जांच करता है. इस प्रॉपर्टी को बंद होने की तारीख के बाद वापस नहीं लाया जाएगा.
    • यह liveStream संसाधन की isDefaultStream प्रॉपर्टी की वैल्यू की जांच करता है. इस प्रॉपर्टी को बंद होने की तारीख के बाद वापस नहीं लाया जाएगा.
    • यह liveBroadcasts.list तरीके को कॉल करता है और broadcastType पैरामीटर की वैल्यू को persistent या all पर सेट करता है. इन बदलावों के तहत, इस पैरामीटर का इस्तेमाल बंद कर दिया जाएगा. बंद होने की तारीख तक:
      • अगर broadcastType पैरामीटर की वैल्यू persistent है, तो liveBroadcasts.list तरीके से कोई नतीजा नहीं मिलेगा.
      • अगर broadcastType पैरामीटर की वैल्यू all है, तो liveBroadcasts.list तरीके से, उस समय से पहले मौजूद ब्रॉडकास्ट नहीं दिखेंगे.

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

    बंद होने की तारीख तक:

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

    अगर आपके ऐप्लिकेशन पर इसका असर पड़ा है, तो कृपया इन दस्तावेज़ों को पढ़ें. इनसे आपको अपने ऐप्लिकेशन को अपडेट करने में मदद मिलेगी, ताकि इस बदलाव के बाद भी वह पहले की तरह काम करता रहे:

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

31 मार्च, 2020

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

sponsor संसाधन और sponsors.list तरीके को बंद कर दिया गया है. इन्हें member संसाधन और members.list तरीके से बदल दिया गया है.

sponsors.list तरीका, 30 सितंबर, 2020 के बाद काम नहीं करेगा. एपीआई क्लाइंट को sponsors.list तरीके के कॉल अपडेट करने चाहिए, ताकि वे members.list तरीके का इस्तेमाल कर सकें. नए संसाधन के बारे में ज़्यादा जानने के लिए, कृपया YouTube Data API के वर्शन के इतिहास देखें.

11 मार्च, 2020

एचएलएस की मदद से YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड के डेटा भेजने का एंडपॉइंट सेक्शन को अपडेट किया गया है. इससे यह साफ़ तौर पर बताया गया है कि प्राइमरी और बैकअप के तौर पर डेटा भेजने के यूआरएल बनाते समय, एन्कोडर को file= पैरामीटर की वैल्यू को पूरा करने के लिए किस प्रोसेस का इस्तेमाल करना चाहिए.

4 फ़रवरी, 2020

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

10 जनवरी, 2020

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

  • liveBroadcast संसाधन में दो नई प्रॉपर्टी जोड़ी गई हैं. इनकी मदद से, कॉन्टेंट क्रिएटर्स और दर्शकों को "बच्चों के लिए बना" कॉन्टेंट पहचानने में मदद मिलेगी:
    • selfDeclaredMadeForKids प्रॉपर्टी की मदद से, कॉन्टेंट क्रिएटर्स यह तय कर सकते हैं कि लाइव ब्रॉडकास्ट, बच्चों के लिए बना कॉन्टेंट है या नहीं. इस प्रॉपर्टी को liveBroadcasts.insert तरीके से ब्रॉडकास्ट बनाते समय सेट किया जा सकता है. ध्यान दें कि इस प्रॉपर्टी को सिर्फ़ उन एपीआई जवाबों में शामिल किया जाता है जिनमें liveBroadcast संसाधन शामिल होते हैं. ऐसा तब होता है, जब चैनल के मालिक ने एपीआई अनुरोध को अनुमति दी हो.
    • madeForKids प्रॉपर्टी की मदद से, एपीआई का इस्तेमाल करने वाला कोई भी व्यक्ति ब्रॉडकास्ट के "बच्चों के लिए बना" स्टेटस को वापस पा सकता है. उदाहरण के लिए, selfDeclaredMadeForKids प्रॉपर्टी की वैल्यू के आधार पर स्टेटस तय किया जा सकता है. अपने चैनल, वीडियो या ब्रॉडकास्ट के लिए दर्शकों की श्रेणी तय करने के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
  • YouTube Data API में, channel रिसोर्स में नई selfDeclaredMadeForKids और madeForKids प्रॉपर्टी भी काम करती हैं.

हमने YouTube API की सेवाओं की शर्तों और डेवलपर के लिए बनी नीतियों को भी अपडेट किया है. ज़्यादा जानकारी के लिए, कृपया YouTube API की सेवाओं की शर्तों में हुए बदलाव का इतिहास देखें. YouTube API सेवाओं की सेवा की शर्तों और डेवलपर के लिए बनी नीतियों में होने वाले बदलाव, 10 जनवरी, 2020 को पैसिफ़िक समय के हिसाब से लागू होंगे.

20 अगस्त, 2019

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

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

28 जून, 2019

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

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

4 अप्रैल, 2019

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

  • एपीआई के रेफ़रंस दस्तावेज़ को अपडेट किया गया है. इससे हर तरीके के इस्तेमाल के सामान्य उदाहरणों को बेहतर तरीके से समझाया जा सकेगा. साथ ही, एपीआई एक्सप्लोरर विजेट के ज़रिए डाइनैमिक और बेहतर क्वालिटी वाले कोड के सैंपल उपलब्ध कराए जा सकेंगे. उदाहरण के लिए, liveBroadcasts.list तरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में बताने वाले पेजों पर, अब दो नए एलिमेंट मौजूद हैं:

    • 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 कॉन्टेंट के मालिक से जुड़े खाते से अनुमति मिलनी चाहिए.

9 फ़रवरी, 2017

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

  • मौजूदा संसाधनों और तरीकों से जुड़े अपडेट

    • superChatEvents.list तरीके के नए hl पैरामीटर की मदद से, यह तय किया जा सकता है कि snippet.displayString प्रॉपर्टी की वैल्यू को किसी खास भाषा के नियमों के मुताबिक फ़ॉर्मैट किया जाना चाहिए. उस प्रॉपर्टी की परिभाषा को भी इसके हिसाब से अपडेट कर दिया गया है.

      पैरामीटर की वैल्यू, i18nLanguages.list तरीके से दिखाई गई सूची में शामिल भाषा कोड होना चाहिए. डिफ़ॉल्ट वैल्यू en है. इसका मतलब है कि डिसप्ले स्ट्रिंग को डिफ़ॉल्ट रूप से उसी तरह फ़ॉर्मैट किया जाता है जिस तरह अंग्रेज़ी में किया जाता है. उदाहरण के लिए, डिफ़ॉल्ट रूप से किसी स्ट्रिंग को $1,00 के बजाय $1.00 के तौर पर फ़ॉर्मैट किया जाता है.

1 फ़रवरी, 2017

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

  • नए संसाधन और तरीके

    • नई superChatEvent संसाधन, YouTube लाइव स्ट्रीम के दौरान किसी प्रशंसक की ओर से खरीदा गया सुपर चैट मैसेज दिखाता है. YouTube लाइव चैट स्ट्रीम में, सुपर चैट वाले मैसेज दूसरे मैसेज से दो तरह से अलग होते हैं:

      • सुपर चैट को किसी रंग से हाइलाइट किया जाता है.
      • सुपर चैट, टिकर में एक तय समय तक पिन रहती हैं.

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

      एपीआई, पिछले 30 दिनों में किसी चैनल की लाइव स्ट्रीम के लिए, सुपर चैट इवेंट की सूची बनाने का तरीका उपलब्ध कराता है. इस तरीके से, चैनल की पिछली लाइव स्ट्रीम के फ़ैन फ़ंडिंग इवेंट (fanFundingEvents) के बारे में भी डेटा मिलता है.

  • मौजूदा संसाधनों और तरीकों से जुड़े अपडेट

    • snippet.type प्रॉपर्टी अब superChatEvent वैल्यू के साथ काम करती है. इससे पता चलता है कि संसाधन, सुपर चैट के बारे में बताता है.

      इसके अलावा, liveChatMessage संसाधन की नई snippet.superChatDetails प्रॉपर्टी और उसके चाइल्ड में, सुपर चैट इवेंट के बारे में जानकारी होती है.

    • liveStream संसाधन की cdn.resolution प्रॉपर्टी के लिए, अब 2160p वैल्यू का इस्तेमाल किया जा सकता है.

  • नई और अपडेट की गई गड़बड़ियां

    • एपीआई में ये नई गड़बड़ियां दिख सकती हैं:

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

12 जनवरी, 2017

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

सुपर चैट की नई सुविधा के लॉन्च होने के साथ ही, YouTube ने फ़ैन फ़ंडिंग की सुविधा को बंद कर दिया है. साथ ही, फ़ैन फ़ंडिंग API को 28 फ़रवरी, 2017 को बंद कर दिया जाएगा. उस तारीख तक:

11 अगस्त, 2016

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

  • हाल ही में पब्लिश की गई YouTube API सेवाओं की सेवा की शर्तों ("अपडेट की गई शर्तें") के बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर विस्तार से बताया गया है. इसमें, सेवा की मौजूदा शर्तों से जुड़े कई अपडेट दिए गए हैं. अपडेट किए गए नियमों के अलावा, इस अपडेट में कई सहायक दस्तावेज़ भी शामिल हैं. ये दस्तावेज़, उन नीतियों को समझने में मदद करेंगे जिनका पालन डेवलपर को करना होगा. अपडेट किए गए नियम, 10 फ़रवरी, 2017 से लागू होंगे.

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

20 मई, 2016

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

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

18 अप्रैल, 2016

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

  • मौजूदा संसाधनों और तरीकों से जुड़े अपडेट

    • liveStream संसाधन से जुड़े अपडेट
      • YouTube पर अब 1440 पिक्सल रिज़ॉल्यूशन वाली स्ट्रीम को 30 या 60 फ़्रेम प्रति सेकंड पर देखा जा सकता है.

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

        प्रॉपर्टी
        cdn.frameRate इनबाउंड वीडियो डेटा का फ़्रेम रेट. मान्य वैल्यू 30fps और 60fps हैं.
        cdn.resolution इनबाउंड वीडियो डेटा का रिज़ॉल्यूशन. प्रॉपर्टी की मान्य वैल्यू ये हैं: 1440p, 1080p, 720p, 480p, 360p, और 240p.
      • liveStream संसाधन की cdn.frameRate और cdn.resolution प्रॉपर्टी के लॉन्च होने के बाद, संसाधन की cdn.format प्रॉपर्टी अब काम नहीं करती है. cdn.format प्रॉपर्टी, रिज़ॉल्यूशन और फ़्रेम रेट की जानकारी एक ही वैल्यू में देती है.

        हमारा सुझाव है कि आप नए फ़ील्ड पर स्विच करें. इस दौरान, cdn.format काम करता रहता है. इसके अलावा, फ़िलहाल लाइव स्ट्रीम डालने के अनुरोध तब तक पूरे किए जाते हैं, जब तक आपने cdn.format प्रॉपर्टी या cdn.frameRate और cdn.resolution प्रॉपर्टी के लिए वैल्यू दी हों. अगर आपने तीनों प्रॉपर्टी के लिए वैल्यू दी हैं, तो हो सकता है कि एपीआई गड़बड़ी दिखाए. ऐसा तब होता है, जब वैल्यू मेल नहीं खाती हैं.

        ध्यान दें कि cdn.format प्रॉपर्टी को बंद कर दिया गया है. हालांकि, अब यह दो नई वैल्यू, 1440p और 1440p_hfr को सपोर्ट करती है. इससे यह पता चलता है कि एपीआई, 30 या 60 फ़्रेम प्रति सेकंड पर 1440 पिक्सल रिज़ॉल्यूशन वाली स्ट्रीम को सपोर्ट करता है.

    • liveBroadcast संसाधन से जुड़े अपडेट
      • liveBroadcast संसाधन में ये नई प्रॉपर्टी शामिल हैं:

        प्रॉपर्टी
        contentDetails.boundStreamLastUpdateTimeMs ब्रॉडकास्ट की contentDetails.boundStreamId प्रॉपर्टी से रेफ़र की गई लाइव स्ट्रीम को पिछली बार कब अपडेट किया गया था.
        contentDetails.projection ब्रॉडकास्ट का प्रोजेक्शन फ़ॉर्मैट. इस प्रॉपर्टी की डिफ़ॉल्ट वैल्यू rectangular है. इस प्रॉपर्टी के लिए मान्य वैल्यू 360 और rectangular हैं.
      • liveBroadcast संसाधन की statistics.totalChatCount प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब ब्रॉडकास्ट में कम से कम एक चैट मैसेज हो.

    • liveChatMessage संसाधन से जुड़े अपडेट
      • snippet.type प्रॉपर्टी के लिए दो नई वैल्यू – messageDeletedEvent और userBannedEvent – उपलब्ध हैं. ये वैल्यू, यहां बुलेट पॉइंट में बताई गई नई प्रॉपर्टी से मेल खाती हैं. snippet.authorChannelId प्रॉपर्टी की परिभाषा को भी अपडेट किया गया है, ताकि यह बताया जा सके कि प्रॉपर्टी वैल्यू, मैसेज के इन नए टाइप की पहचान कैसे करती है.

      • liveChatMessage संसाधन में ये नई प्रॉपर्टी शामिल हैं:

        प्रॉपर्टी
        snippet.messageDeletedDetails इस ऑब्जेक्ट में, उस मैसेज के बारे में जानकारी होती है जिसे चैट मॉडरेटर ने मिटाया है. यह ऑब्जेक्ट सिर्फ़ तब मौजूद होता है, जब snippet.type प्रॉपर्टी की वैल्यू messageDeletedEvent हो.
        snippet.userBannedDetails इस ऑब्जेक्ट में, उस उपयोगकर्ता के बारे में जानकारी होती है जिसे चैट में हिस्सा लेने से बैन कर दिया गया है. इस ऑब्जेक्ट में, पाबंदी के बारे में भी जानकारी होती है. जैसे, पाबंदी स्थायी है या अस्थायी. अगर खाता कुछ समय के लिए निलंबित किया गया है, तो ऑब्जेक्ट की किसी प्रॉपर्टी में निलंबन की अवधि के बारे में बताया जाता है.

        यह ऑब्जेक्ट सिर्फ़ तब मौजूद होता है, जब snippet.type प्रॉपर्टी की वैल्यू userBannedEvent हो.
  • नई और अपडेट की गई गड़बड़ियां

    • एपीआई में ये नई गड़बड़ियां दिख सकती हैं:

      गड़बड़ी की जानकारी
      liveBroadcasts.bind liveBroadcasts.bind तरीके से 403 (Forbidden) गड़बड़ी का मैसेज मिलता है. इससे पता चलता है कि उपयोगकर्ता ने तय समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं. गड़बड़ी की वजह userRequestsExceedRateLimit है.

      liveBroadcasts.insert और liveBroadcasts.update तरीकों में पहले से ही एक जैसी गड़बड़ी होती है.
      liveStreams.insert liveStreams.insert तरीके में चार नई 400 (Bad Request) गड़बड़ियां होती हैं. इनसे liveStream संसाधन में मौजूद प्रॉपर्टी की अमान्य वैल्यू का पता चलता है. यह वही संसाधन है जिसे अनुरोध में डालने की कोशिश की गई थी. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
      liveStreams.insert liveStreams.insert तरीके में दो नई 400 (Bad Request) गड़बड़ियां होती हैं. इनमें से हर एक गड़बड़ी से पता चलता है कि अनुरोध में शामिल liveStream संसाधन में कोई ज़रूरी वैल्यू मौजूद नहीं है. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
      खास तौर पर, जब कोई liveStream संसाधन डाला जाता है, तब आपको cdn.format प्रॉपर्टी या cdn.frameRate और cdn.resolution प्रॉपर्टी में से किसी एक के लिए वैल्यू तय करनी होगी.
      • अगर आपने तीनों प्रॉपर्टी में से किसी के लिए भी वैल्यू नहीं दी है, तो एपीआई formatRequired गड़बड़ी का मैसेज दिखाता है.
      • अगर आपने cdn.resolution के लिए कोई वैल्यू तय की है, लेकिन cdn.frameRate के लिए कोई वैल्यू तय नहीं की है, तो एपीआई frameRateRequired गड़बड़ी का मैसेज दिखाता है.
      • अगर आपने cdn.frameRate के लिए कोई वैल्यू तय की है, लेकिन cdn.resolution के लिए कोई वैल्यू तय नहीं की है, तो एपीआई resolutionRequired गड़बड़ी का मैसेज दिखाता है.
      liveStreams.update अगर अनुरोध में, नीचे दी गई किसी भी ऐसी प्रॉपर्टी की वैल्यू में बदलाव करने की कोशिश की जाती है जिसे बदला नहीं जा सकता, तो liveStreams.update तरीके से 403 (Forbidden) गड़बड़ी मिलती है: गड़बड़ी के जवाब में मौजूद 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

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

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