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

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

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

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

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 फ़ील्ड, 17 अगस्त, 2020 से काम नहीं करेगा. इसे अप्रैल 2016 में बंद कर दिया गया था. इस तारीख के बाद, उस फ़ील्ड का इस्तेमाल करने वाले अनुरोध पूरे नहीं होंगे.

अगर आपका कोड अब भी cdn.format फ़ील्ड का इस्तेमाल करता है, तो उसे अपडेट करना होगा. इससे, cdn.frameRate और cdn.resolution प्रॉपर्टी का इस्तेमाल करके, फ़्रेम रेट और रिज़ॉल्यूशन की जानकारी अलग-अलग दी जा सकेगी.

6 जुलाई, 2020

एचएलएस की मदद से YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड को अपडेट किया गया है. इसमें ये बदलाव किए गए हैं:

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

16 अप्रैल, 2020

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

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

    ब्रॉडकास्ट की अवधि वाले दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि true पर contentDetails.enableAutoStart या contentDetails.enableAutoStop प्रॉपर्टी सेट करने पर, 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 में वैल्यू लोड की जा सकती हैं. इसके अलावा, Java, JavaScript, PHP, और Python में कोड सैंपल पाने के लिए, APIs Explorer को फ़ुलस्क्रीन मोड में खोला जा सकता है.

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

12 जनवरी, 2017

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

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

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 अब 30 या 60 फ़्रेम प्रति सेकंड पर 1440 पिक्सल रिज़ॉल्यूशन वाली स्ट्रीम के साथ काम करता है.

        इसके अलावा, 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 क्रिएटर्स को एक बार पैसे देकर उनकी मदद कर सकते हैं.

      API का 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 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 पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि प्रॉपर्टी की वैल्यू, आईएसओ 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 अगर ब्रॉडकास्ट का स्टेटस created या ready नहीं है और contentDetails.enableClosedCaptions वैल्यू को अपडेट करने की कोशिश की जाती है, तो 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 की इस्तेमाल की जा सकने वाली वैल्यू की सूची से हटा दिया गया है.