इस पेज पर, YouTube Live Streaming API में हुए बदलावों और दस्तावेज़ से जुड़े अपडेट की जानकारी दी गई है. बदलावों के इस लॉग की सदस्यता लें.
9 अक्टूबर, 2023
सिर्फ़ रेफ़रंस के लिए, इस CSV फ़ाइल में यह पता लगाया जा सकता है कि कौनसे स्टिकर आईडी, किन सुपर स्टिकर से जुड़े हैं.
इस जानकारी को दिखाने के लिए, liveChatMessage
संसाधन की
snippet.superStickerDetails.superStickerMetadata.stickerId
प्रॉपर्टी और superChatEvent
संसाधन की
snippet.superStickerMetadata.stickerId
प्रॉपर्टी, दोनों की परिभाषाएं अपडेट की गई हैं.
15 सितंबर, 2023
अब एपीआई, लाइव स्ट्रीम में विज्ञापन डालने का नया तरीका इस्तेमाल करता है. YouTube पर अब एक ऐसी सुविधा उपलब्ध है जिसकी मदद से, ब्रॉडकास्ट के बीच में विज्ञापन दिखाने के लिए ब्रेक अपने-आप तय किए जा सकते हैं. यह सुविधा, liveCuepoints
के साथ काम करती है. 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
प्रॉपर्टी और उसकी चाइल्ड प्रॉपर्टी में, उपहार में मिली सदस्यता के इवेंट की जानकारी होती है.
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 Studio से एचएलएस इनजेशन यूआरएल पाने का तरीका बताया गया है.
-
file
पैरामीटर वैल्यू को फ़ॉर्मैट करने के निर्देशों को, नए एचएलएस डेटा डालने के यूआरएल को पूरा करना सेक्शन में ले जाया गया है. ये निर्देश तब भी लागू होते हैं, जब एचएलएस डालने का यूआरएल, YouTube API या YouTube Creator Studio से लिया गया हो.
इसके अलावा, डेटा डालने के प्रोटोकॉल की तुलना करने वाले नए टूल में, डेटा डालने के उन प्रोटोकॉल की सूची होती है जिनका इस्तेमाल YouTube करता है. साथ ही, हर प्रोटोकॉल के लिए इस्तेमाल के सही उदाहरणों के बारे में ज़्यादा जानकारी और हर प्रोटोकॉल के लिए काम करने वाले कोडेक की जानकारी भी होती है.
16 अप्रैल, 2020
इस अपडेट में एक नई प्रॉपर्टी और बंद होने की सूचना शामिल है:
-
liveBroadcast
संसाधन अबcontentDetails.enableAutoStop
प्रॉपर्टी के साथ काम करता है. इस प्रॉपर्टी से पता चलता है कि चैनल के मालिक के, बाउंड की गई वीडियो स्ट्रीम पर वीडियो स्ट्रीमिंग बंद करने के करीब एक मिनट बाद, ब्रॉडकास्ट अपने-आप बंद होना चाहिए या नहीं.ब्रॉडकास्ट की लाइफ़ दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि
contentDetails.enableAutoStart
याcontentDetails.enableAutoStop
प्रॉपर्टी कोtrue
पर सेट करने पर, YouTube पर लाइव इवेंट बनाने और उसे मैनेज करने की सिलसिलेवार प्रोसेस में क्या बदलाव होता है. -
ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है. ये बदलाव 1 सितंबर, 2020 को या उसके बाद से लागू होंगे. बदलाव लागू होने की तारीख को यहां, बंद होने की तारीख के तौर पर बताया गया है.
इस अपडेट में, ऐसे बदलाव के बारे में बताया गया है जो आपके लिए समस्या पैदा कर सकता है. इससे उन एपीआई क्लाइंट ऐप्लिकेशन पर असर पड़ता है जो YouTube पर लाइव कॉन्टेंट स्ट्रीम करने के लिए, चैनलों के डिफ़ॉल्ट
liveStream
औरliveBroadcast
संसाधनों का इस्तेमाल करते हैं. खास तौर पर, हमेशा चलने वाले ब्रॉडकास्ट और स्ट्रीम से जुड़ा ब्रॉडकास्ट आईडी और स्ट्रीम आईडी, अब नए ब्रॉडकास्ट शुरू करने के लिए काम नहीं करेगा.इनमें से कोई भी स्थिति सही होने पर, आपके ऐप्लिकेशन पर असर पड़ेगा:
- यह
liveBroadcast
रिसॉर्स कीisDefaultBroadcast
प्रॉपर्टी की वैल्यू की जांच करता है. बंद होने की तारीख के बाद, यह प्रॉपर्टी वापस नहीं मिलेगी. - यह
liveStream
रिसॉर्स कीisDefaultStream
प्रॉपर्टी की वैल्यू की जांच करता है. बंद होने की तारीख के बाद, यह प्रॉपर्टी वापस नहीं मिलेगी. - यह
liveBroadcasts.list
तरीके को कॉल करता है औरbroadcastType
पैरामीटर की वैल्यू कोpersistent
याall
पर सेट करता है. इन बदलावों के तहत, इस पैरामीटर का इस्तेमाल नहीं किया जा सकेगा. बंद होने की तारीख तक:- अगर
broadcastType
पैरामीटर की वैल्यूpersistent
है, तोliveBroadcasts.list
तरीका कोई नतीजा नहीं दिखाएगा. - अगर
broadcastType
पैरामीटर की वैल्यूall
है, तोliveBroadcasts.list
तरीका, उस समय से पहले मौजूद रहने वाले ब्रॉडकास्ट नहीं दिखाएगा.
- अगर
पिछले कुछ सालों से, YouTube किसी चैनल के लिए लाइव स्ट्रीमिंग की सुविधा चालू होने पर, उसके लिए डिफ़ॉल्ट स्ट्रीम और डिफ़ॉल्ट ब्रॉडकास्ट अपने-आप बनाता है. डिफ़ॉल्ट स्ट्रीम हमेशा मौजूद रहती थी. इसकी शुरुआत या खत्म होने का समय नहीं होता था और इसे मिटाया नहीं जा सकता था. इसी तरह, डिफ़ॉल्ट ब्रॉडकास्ट को लगातार माना जाता था. यह हमेशा मौजूद रहा और किसी खास इवेंट से जुड़ा नहीं था.
बंद होने की तारीख तक:
- YouTube अब डिफ़ॉल्ट स्ट्रीम और ब्रॉडकास्ट नहीं बनाएगा. डिफ़ॉल्ट संसाधनों पर भरोसा करने के बजाय, एपीआई क्लाइंट को
liveBroadcast
औरliveStream
संसाधन बनाने और मैनेज करने के साथ-साथ, उन संसाधनों को एक साथ जोड़ने की ज़रूरत होती है. - अगर किसी चैनल का डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम लाइव है, तो इसका मतलब है कि चैनल, डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम का इस्तेमाल लाइव ब्रॉडकास्ट के लिए कर रहा है. ऐसे में, चैनल के लाइव ब्रॉडकास्ट पर कोई असर नहीं पड़ेगा. हालांकि, उस ब्रॉडकास्ट के खत्म होने के बाद, चैनल डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम का फिर से इस्तेमाल नहीं कर पाएगा.
- अगर किसी चैनल का डिफ़ॉल्ट ब्रॉडकास्ट और डिफ़ॉल्ट स्ट्रीम लाइव नहीं है, तो इस सुविधा के बंद होने के बाद, YouTube उन संसाधनों का इस्तेमाल करके वीडियो ब्रॉडकास्ट करने की कोशिशों को अनदेखा कर देगा.
अगर आपके ऐप्लिकेशन पर असर पड़ा है, तो कृपया नीचे दिए गए दस्तावेज़ देखें. इनसे आपको अपने ऐप्लिकेशन को अपडेट करने में मदद मिलेगी, ताकि इस बदलाव के बाद भी वह उम्मीद के मुताबिक काम करता रहे:
- माइग्रेशन के लिए बनी नई गाइड में, उन चरणों के बारे में बताया गया है जिन्हें डेवलपर को एपीआई क्लाइंट में ठीक करना पड़ सकता है. फ़िलहाल, ये क्लाइंट डिफ़ॉल्ट ब्रॉडकास्ट और स्ट्रीम का इस्तेमाल करते हैं.
- लाइव स्ट्रीम की प्रोसेस की गाइड में, आपको सिलसिलेवार तरीके से बताया गया है कि YouTube पर लाइव इवेंट कैसे बनाया और मैनेज किया जा सकता है. हर चरण में, एपीआई कॉल या किसी खास कार्रवाई को पूरा करने के लिए ज़रूरी अन्य चीज़ों के बारे में बताया गया है. जब YouTube डिफ़ॉल्ट स्ट्रीम और ब्रॉडकास्ट के साथ काम करना बंद कर देगा, तब आपके ऐप्लिकेशन को उस प्रोसेस का पालन करना होगा.
- यह
31 मार्च, 2020
ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.
sponsor
संसाधन और
sponsors.list
तरीके का इस्तेमाल अब नहीं किया जा सकता. इन्हें member
संसाधन और members.list
तरीके से बदल दिया गया है.
sponsors.list
तरीका, 30 सितंबर, 2020 या उसके बाद काम नहीं करेगा.
एपीआई क्लाइंट को sponsors.list
तरीके के कॉल अपडेट करने चाहिए, ताकि वे members.list
तरीके का इस्तेमाल कर सकें. नए संसाधन के बारे में ज़्यादा जानकारी के लिए, कृपया
YouTube Data API के बदलाव का इतिहास देखें.
11 मार्च, 2020
एचएलएस के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड के वीडियो डालने के लिए एंडपॉइंट सेक्शन को अपडेट किया गया है. इससे, एन्कोडर को प्राइमरी और बैकअप वीडियो डालने के लिए, file=
पैरामीटर की वैल्यू डालने की प्रोसेस के बारे में साफ़ तौर पर पता चलेगा.
4 फ़रवरी, 2020
एचएलएस के ज़रिए YouTube लाइव कॉन्टेंट डिलीवर करना के बारे में बताने वाली गाइड को अपडेट किया गया है. इसमें बताया गया है कि DELETE
अनुरोध करना ज़रूरी नहीं है और YouTube का एचएलएस एंडपॉइंट इन अनुरोधों को अनदेखा करता है. परफ़ॉर्मेंस को बेहतर बनाने के लिए, YouTube का सुझाव है कि क्लाइंट DELETE
अनुरोध न भेजें.
10 जनवरी, 2020
एपीआई अब बच्चों के लिए बनाए गए वीडियो की पहचान कर सकता है. YouTube इसे "बच्चों के लिए बना" कहता है. YouTube के सहायता केंद्र पर जाकर, "बच्चों के लिए बने" कॉन्टेंट के बारे में ज़्यादा जानें.
-
liveBroadcast
संसाधन में दो नई प्रॉपर्टी शामिल की गई हैं. इनकी मदद से, कॉन्टेंट क्रिएटर्स और दर्शक, "बच्चों के लिए बना" कॉन्टेंट की पहचान कर सकते हैं:-
selfDeclaredMadeForKids
प्रॉपर्टी की मदद से, क्रिएटर्स यह बता सकते हैं कि लाइव स्ट्रीम में बच्चों के लिए कॉन्टेंट दिखाया जा रहा है या नहीं.liveBroadcasts.insert
तरीके का इस्तेमाल करके, ब्रॉडकास्ट बनाते समय, इस प्रॉपर्टी को सेट किया जा सकता है. ध्यान दें कि यह प्रॉपर्टी सिर्फ़ उन एपीआई रिस्पॉन्स में शामिल होती है जिनमेंliveBroadcast
संसाधन होते हैं. ऐसा तब होता है, जब चैनल के मालिक ने एपीआई अनुरोध को अनुमति दी हो. -
madeForKids
प्रॉपर्टी की मदद से, एपीआई का इस्तेमाल करने वाला कोई भी व्यक्ति ब्रॉडकास्ट के "बच्चों के लिए बना" स्टेटस को वापस पा सकता है. उदाहरण के लिए,selfDeclaredMadeForKids
प्रॉपर्टी की वैल्यू के आधार पर स्थिति तय की जा सकती है. अपने चैनल, वीडियो या ब्रॉडकास्ट के लिए दर्शकों की कैटगरी सेट करने के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
-
-
YouTube Data API में,
channel
रिसॉर्स में नईselfDeclaredMadeForKids
औरmadeForKids
प्रॉपर्टी भी काम करती हैं.
हमने YouTube API की सेवाओं की शर्तें और डेवलपर के लिए बनी नीतियों को भी अपडेट किया है. ज़्यादा जानकारी के लिए, कृपया YouTube API की सेवाओं की शर्तें - बदलाव का इतिहास देखें. YouTube API की सेवाओं की शर्तों और डेवलपर के लिए बनी नीतियों में किए गए बदलाव, पैसिफ़िक टाइम के मुताबिक 10 जनवरी, 2020 से लागू होंगे.
20 अगस्त, 2019
एचएलएस के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करने से जुड़ी गाइड के ज़रूरी शर्तें सेक्शन में दो बदलाव किए गए हैं:
- इसमें बताया गया है कि हर मीडिया प्लेलिस्ट में, स्वीकार किए गए सेगमेंट और बाकी बचे सेगमेंट, दोनों को शामिल करना सबसे सही तरीका है. इस तरीके से, किसी सेगमेंट को स्किप किए जाने की संभावना कम हो जाती है अगर सर्वर साइड पर मीडिया प्लेलिस्ट का डेटा उपलब्ध नहीं होता. उदाहरण के लिए, हर मीडिया प्लेलिस्ट में ज़्यादा से ज़्यादा दो ऐसे सेगमेंट शामिल किए जा सकते हैं जिन्हें स्वीकार किया गया है और ज़्यादा से ज़्यादा पांच ऐसे सेगमेंट शामिल किए जा सकते हैं जिन्हें स्वीकार नहीं किया गया है.
- अब हर मीडिया सेगमेंट के लिए मीडिया प्लेलिस्ट भेजना ज़रूरी है. इससे, अगर कोई मीडिया प्लेलिस्ट मिट जाती है, तो सर्वर को उसे तुरंत वापस लाने में मदद मिलती है. पहले इस तरीके को सुझाव के तौर पर शामिल किया गया था.
28 जून, 2019
YouTube अब एचएलएस इनजेशन की सुविधा देता है. इसलिए, liveStream
रिसॉर्स की ingestionType
प्रॉपर्टी, HLS का इस्तेमाल करके YouTube में डाली गई स्ट्रीम की पहचान करने के लिए, नई वैल्यू hls
के साथ काम करती है.
एचएलएस की मदद से YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड में, एन्कोडर से YouTube पर लाइव कॉन्टेंट स्ट्रीम करने के लिए, एचएलएस का इस्तेमाल करने के दिशा-निर्देश दिए गए हैं. इस गाइड का मकसद, एन्कोडर वेंडर को अपने प्रॉडक्ट में एचएलएस डिलीवरी की सुविधा जोड़ने में मदद करना है.
4 अप्रैल, 2019
इस अपडेट में ये बदलाव किए गए हैं:
-
एपीआई रेफ़रंस दस्तावेज़ को अपडेट किया गया है, ताकि हर तरीके के इस्तेमाल के सामान्य उदाहरणों के बारे में बेहतर तरीके से बताया जा सके. साथ ही, APIs Explorer विजेट की मदद से डाइनैमिक और अच्छी क्वालिटी के कोड सैंपल उपलब्ध कराए जा सकें. उदाहरण के लिए,
liveBroadcasts.list
तरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में बताने वाले पेजों पर, अब दो नए एलिमेंट हैं:-
एपीआई एक्सप्लोरर विजेट की मदद से, अनुमति के दायरे चुने जा सकते हैं, सैंपल पैरामीटर और प्रॉपर्टी वैल्यू डाली जा सकती हैं. इसके बाद, एपीआई के असल अनुरोध भेजे जा सकते हैं और एपीआई के असल रिस्पॉन्स देखे जा सकते हैं. विजेट में फ़ुलस्क्रीन व्यू भी उपलब्ध होता है. इसमें पूरे कोड सैंपल दिखते हैं. ये सैंपल, आपके डाले गए स्कोप और वैल्यू का इस्तेमाल करने के लिए डाइनैमिक तौर पर अपडेट होते हैं.
-
इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताए गए तरीके के एक या एक से ज़्यादा सामान्य उदाहरण दिए गए हैं. उदाहरण के लिए, किसी खास ब्रॉडकास्ट का डेटा पाने या मौजूदा उपयोगकर्ता के ब्रॉडकास्ट का डेटा पाने के लिए,
liveBroadcasts.list
तरीके को कॉल किया जा सकता है.उस सेक्शन में मौजूद लिंक का इस्तेमाल करके, एपीआई एक्सप्लोरर में अपने इस्तेमाल के उदाहरण के लिए सैंपल वैल्यू डाली जा सकती हैं. इसके अलावा, एपीआई एक्सप्लोरर को फ़ुलस्क्रीन मोड में खोला जा सकता है, जिसमें पहले से ही वैल्यू डाली गई होती हैं. इन बदलावों का मकसद, आपको ऐसे कोड सैंपल आसानी से दिखाना है जो सीधे तौर पर उस इस्तेमाल के उदाहरण पर लागू होते हैं जिसे आपको अपने ऐप्लिकेशन में लागू करना है.
फ़िलहाल, कोड के सैंपल Java, JavaScript, PHP, Python, और curl के लिए उपलब्ध हैं.
-
-
कोड सैंपल पेज का भी नया यूज़र इंटरफ़ेस (यूआई) है. इसमें ऊपर बताई गई सभी सुविधाएं मौजूद हैं. इस टूल का इस्तेमाल करके, अलग-अलग तरीकों के इस्तेमाल के उदाहरणों को एक्सप्लोर किया जा सकता है. साथ ही, एपीआई एक्सप्लोरर में वैल्यू लोड की जा सकती हैं. इसके अलावा, Java, JavaScript, PHP, और Python में कोड के सैंपल पाने के लिए, फ़ुलस्क्रीन एपीआई एक्सप्लोरर खोला जा सकता है.
इस बदलाव के साथ-साथ, Java, PHP, और Python के लिए उपलब्ध कोड सैंपल की सूची वाले पेजों को हटा दिया गया है.
25 फ़रवरी, 2019
liveChatMessage
और superChatEvent
संसाधनों के दस्तावेज़ों को अपडेट किया गया है. इससे यह पता चलता है कि अब दोनों संसाधनों में Super Stickers की जानकारी शामिल हो सकती है. सुपर स्टिकर्स, सुपर चैट मैसेज का एक टाइप होता है. इसमें एक इमेज दिखती है. अन्य सुपर चैट की तरह, Super Sticker मैसेज को भी YouTube लाइव स्ट्रीम के दौरान कोई प्रशंसक खरीदता है.
liveChatMessage
रिसॉर्स में,snippet.type
प्रॉपर्टी अबsuperStickerEvent
पर सेट है. इससे पता चलता है कि रिसॉर्स में सुपर स्टिकर की जानकारी शामिल है. ऐसे में, संसाधन मेंsnippet.superStickerDetails
ऑब्जेक्ट भी शामिल होता है. इसमें सुपर स्टिकर के बारे में ज़्यादा जानकारी होती है.superChatEvent
रिसॉर्स में, बूलियनsnippet.isSuperStickerEvent
से पता चलता है कि सुपर चैट मैसेज, सुपर स्टिकर भी है या नहीं. अगर ऐसा है, तोsnippet.superStickerMetadata
ऑब्जेक्ट में सुपर स्टिकर के बारे में ज़्यादा जानकारी होती है.
5 अप्रैल, 2018
superChatEvents.list
तरीके की जानकारी को अपडेट किया गया है, ताकि यह जानकारी दी जा सके कि एपीआई के जवाब में अब fanFundingEvents
नहीं है. इसे 2017 की शुरुआत में बंद कर दिया गया था.
3 अप्रैल, 2017
लाइव चैट मैसेज को सूची में शामिल करने, शामिल करने, और मिटाने का तरीका बताने वाले नए Java कोड सैंपल जोड़े गए हैं. सैंपल, इन तरीकों को कॉल करते हैं:
13 फ़रवरी, 2017
इस अपडेट में ये बदलाव किए गए हैं:
-
मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट
-
liveCuepoints.insert
तरीके को अपडेट किया गया है, ताकि यह दिखाया जा सके कि फ़िलहालonBehalfOfContentOwner
पैरामीटर की ज़रूरत है. इसके अलावा, इस तरीके के ब्यौरे को अपडेट किया गया है, ताकि यह पता चल सके कि इस तरीके को कॉल करने के लिए, YouTube कॉन्टेंट के मालिक से जुड़े खाते से अनुमति लेनी होगी.
-
9 फ़रवरी, 2017
इस अपडेट में ये बदलाव किए गए हैं:
-
मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट
-
superChatEvents.list
तरीके के नएhl
पैरामीटर की मदद से, यह तय किया जा सकता है किsnippet.displayString
प्रॉपर्टी की वैल्यू को किसी खास भाषा के नियमों के मुताबिक फ़ॉर्मैट किया जाना चाहिए. उस प्रॉपर्टी की परिभाषा भी अपडेट कर दी गई है.पैरामीटर की वैल्यू,
i18nLanguages.list
तरीके से लौटाई गई सूची में शामिल भाषा कोड होनी चाहिए. डिफ़ॉल्ट वैल्यूen
है. इसका मतलब है कि डिफ़ॉल्ट रूप से, डिसप्ले स्ट्रिंग को अंग्रेज़ी में इस्तेमाल करने के हिसाब से फ़ॉर्मैट किया जाता है. उदाहरण के लिए, डिफ़ॉल्ट रूप से, किसी स्ट्रिंग को$1,00
के बजाय$1.00
के तौर पर फ़ॉर्मैट किया जाता है.
-
1 फ़रवरी, 2017
इस अपडेट में ये बदलाव किए गए हैं:
-
नए संसाधन और तरीके
-
नया
superChatEvent
रिसॉर्स, YouTube लाइव स्ट्रीम के दौरान किसी प्रशंसक के खरीदे गए सुपर चैट मैसेज की जानकारी दिखाता है. YouTube लाइव चैट स्ट्रीम में, सुपर चैट दूसरे मैसेज से दो तरह से अलग होते हैं:- सुपर चैट को किसी रंग से हाइलाइट किया जाता है.
- सुपर चैट, एक तय समय तक टिकर में सबसे ऊपर दिखते रहते हैं.
सुपर चैट का रंग, टिकर में पिन रहने की अवधि, और मैसेज की ज़्यादा से ज़्यादा लंबाई, इन सभी पर सुपर चैट की खरीदारी की रकम का असर पड़ता है. सुपर चैट के बारे में ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं.
एपीआई, पिछले 30 दिनों में चैनल की लाइव स्ट्रीम के लिए सुपर चैट इवेंट की सूची बनाने का तरीका इस्तेमाल करता है. इस तरीके से, चैनल की पिछली लाइव स्ट्रीम से, फ़ैन फ़ंडिंग इवेंट (
fanFundingEvents
) का डेटा भी मिलता है.
-
-
मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट
-
snippet.type
प्रॉपर्टी में अबsuperChatEvent
वैल्यू का इस्तेमाल किया जा सकता है. इससे पता चलता है कि रिसॉर्स में सुपर चैट की जानकारी दी गई है.इसके अलावा,
liveChatMessage
रिसॉर्स की नईsnippet.superChatDetails
प्रॉपर्टी और उसके चाइल्ड एलिमेंट में, सुपर चैट इवेंट की जानकारी होती है. -
liveStream
रिसॉर्स कीcdn.resolution
प्रॉपर्टी में अब2160p
वैल्यू का इस्तेमाल किया जा सकता है.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई में ये नई गड़बड़ियां शामिल हैं:
गड़बड़ी की जानकारी liveBroadcasts.insert
,liveBroadcasts.update
liveBroadcasts.insert
औरliveBroadcasts.update
तरीके,400
(Bad Request
) गड़बड़ियां दिखाते हैं. इससे पता चलता है कि डाले जा रहे या अपडेट किए जा रहेliveBroadcast
संसाधन में,contentDetails.enableEmbed
प्रॉपर्टी याcontentDetails.projection
प्रॉपर्टी के लिए अमान्य वैल्यू है. दो नई गड़बड़ियों की वजहें क्रमशःinvalidEmbedSetting
औरinvalidProjection
हैं.
-
12 जनवरी, 2017
ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.
सुपर चैट की नई सुविधा रिलीज़ करने के साथ ही, YouTube ने फ़ैन फ़ंडिंग की सुविधा बंद कर दी है. साथ ही, फ़ैन फ़ंडिंग एपीआई को 28 फ़रवरी, 2017 को बंद कर दिया जाएगा. उस तारीख तक:
liveChatMessages.list
तरीके से, अबfanFundingEvent
केsnippet.type
वाले मैसेज नहीं मिलेंगे. इसी तरह,liveChatMessage
रिसॉर्स में अबsnippet.fanFundingEventDetails
ऑब्जेक्ट नहीं होगा.fanFundingEvents.list
तरीका अब डेटा नहीं दिखाएगा.
11 अगस्त, 2016
इस अपडेट में ये बदलाव किए गए हैं:
-
YouTube API की सेवाओं की शर्तों ("अपडेट की गई शर्तें") को हाल ही में पब्लिश किया गया है. इन शर्तों के बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर पूरी जानकारी दी गई है. इनमें, सेवा की मौजूदा शर्तों में किए गए कई अपडेट के बारे में बताया गया है. इस अपडेट में, बदली गई शर्तें शामिल हैं. ये शर्तें 10 फ़रवरी, 2017 से लागू होंगी. साथ ही, इसमें उन नीतियों के बारे में बताने वाले कई दस्तावेज़ भी शामिल हैं जिनका डेवलपर को पालन करना होगा.
नए दस्तावेज़ों का पूरा सेट, अपडेट किए गए नियमों के बदलाव के इतिहास में बताया गया है. इसके अलावा, बदलाव के इतिहास में यह भी बताया जाएगा कि आने वाले समय में, अपडेट की गई शर्तों या उनसे जुड़े दस्तावेज़ों में क्या बदलाव किए जाएंगे. उस दस्तावेज़ में मौजूद लिंक से, बदलावों के इतिहास में हुए बदलावों की सूची वाले आरएसएस फ़ीड की सदस्यता ली जा सकती है.
20 मई, 2016
YouTube पर अब DASH इनजेशन की सुविधा काम करती है. इसलिए, liveStream
रिसॉर्स की ingestionType
प्रॉपर्टी में नई वैल्यू dash
का इस्तेमाल किया जा सकता है. इससे, DASH का इस्तेमाल करके YouTube पर डाली गई स्ट्रीम की पहचान की जा सकती है.
DASH के ज़रिए YouTube पर लाइव कॉन्टेंट डिलीवर करना गाइड में, एन्कोडर से YouTube पर लाइव डेटा स्ट्रीम करने के लिए, DASH डिलीवरी फ़ॉर्मैट का इस्तेमाल करने के दिशा-निर्देश दिए गए हैं. इसका मकसद, एन्कोडर वेंडर को अपने प्रॉडक्ट में DASH डिलीवरी की सुविधा जोड़ने में मदद करना है.
18 अप्रैल, 2016
इस अपडेट में ये बदलाव किए गए हैं:
-
मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट
liveStream
संसाधन से जुड़े अपडेट-
YouTube पर अब 1440 पिक्सल रिज़ॉल्यूशन वाली स्ट्रीम, 30 या 60 फ़्रेम प्रति सेकंड पर देखी जा सकती हैं.
इसके अलावा,
liveStream
रिसॉर्स में इनबाउंड वीडियो डेटा के फ़्रेम रेट और रिज़ॉल्यूशन की जानकारी देने के लिए नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी cdn.frameRate
इनबाउंड वीडियो डेटा का फ़्रेम रेट. मान्य वैल्यू 30fps
और60fps
हैं.cdn.resolution
इनबाउंड वीडियो डेटा का रिज़ॉल्यूशन. प्रॉपर्टी की मान्य वैल्यू: 1440p
,1080p
,720p
,480p
,360p
, और240p
. -
liveStream
संसाधन कीcdn.frameRate
औरcdn.resolution
प्रॉपर्टी के लॉन्च के बाद, संसाधन कीcdn.format
प्रॉपर्टी अब काम नहीं करती.cdn.format
प्रॉपर्टी, रिज़ॉल्यूशन और फ़्रेम रेट की जानकारी एक ही वैल्यू में देती है.हमारा सुझाव है कि आप नए फ़ील्ड का इस्तेमाल करें. इस दौरान,
cdn.format
काम करता रहेगा. इसके अलावा, लाइव स्ट्रीम डालने के अनुरोध तब तक पूरे होते रहेंगे, जब तकcdn.format
प्रॉपर्टी याcdn.frameRate
औरcdn.resolution
प्रॉपर्टी की वैल्यू दी जाती है. अगर आपने तीनों प्रॉपर्टी के लिए वैल्यू दी हैं, तो हो सकता है कि एपीआई गड़बड़ी दिखाए. ऐसा तब होगा, जब वैल्यू एक-दूसरे से मेल न खाती हों.ध्यान दें कि
cdn.format
प्रॉपर्टी का इस्तेमाल अब नहीं किया जा सकता. हालांकि, अब इसमें दो नई वैल्यू,1440p
और1440p_hfr
इस्तेमाल की जा सकती हैं. इससे यह पता चलता है कि एपीआई, 1440 पिक्सल वाली स्ट्रीम को 30 या 60 फ़्रेम प्रति सेकंड पर चला सकता है.
-
liveBroadcast
संसाधन से जुड़े अपडेट-
liveBroadcast
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी contentDetails.boundStreamLastUpdateTimeMs
ब्रॉडकास्ट की contentDetails.boundStreamId
प्रॉपर्टी से रेफ़र की गई लाइव स्ट्रीम को आखिरी बार अपडेट किए जाने की तारीख और समय.contentDetails.projection
ब्रॉडकास्ट का प्रोजेक्शन फ़ॉर्मैट. प्रॉपर्टी की डिफ़ॉल्ट वैल्यू rectangular
है. इस प्रॉपर्टी के लिए मान्य वैल्यू360
औरrectangular
हैं. -
liveBroadcast
रिसॉर्स कीstatistics.totalChatCount
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब ब्रॉडकास्ट में कम से कम एक चैट मैसेज हो.
-
liveChatMessage
संसाधन से जुड़े अपडेट-
snippet.type
प्रॉपर्टी में दो नई वैल्यू –messageDeletedEvent
औरuserBannedEvent
– इस्तेमाल की जा सकती हैं. ये वैल्यू, नीचे दिए गए बुलेट पॉइंट में बताई गई नई प्रॉपर्टी से मेल खाती हैं.snippet.authorChannelId
प्रॉपर्टी की परिभाषा को भी अपडेट किया गया है, ताकि यह बताया जा सके कि इन नए मैसेज टाइप के लिए प्रॉपर्टी वैल्यू क्या बताती है. -
liveChatMessage
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी snippet.messageDeletedDetails
इस ऑब्जेक्ट में, चैट मॉडरेटर के मिटाए गए मैसेज की जानकारी होती है. ऑब्जेक्ट सिर्फ़ तब मौजूद होता है, जब snippet.type
प्रॉपर्टी की वैल्यूmessageDeletedEvent
हो.snippet.userBannedDetails
इस ऑब्जेक्ट में उस उपयोगकर्ता की जानकारी होती है जिसे चैट में हिस्सा लेने से प्रतिबंधित किया गया है. इस ऑब्जेक्ट में, पाबंदी के बारे में भी जानकारी होती है. जैसे, पाबंदी हमेशा के लिए है या कुछ समय के लिए. अगर पाबंदी कुछ समय के लिए है, तो ऑब्जेक्ट की किसी प्रॉपर्टी से पाबंदी की अवधि का पता चलता है.
यह ऑब्जेक्ट सिर्फ़ तब मौजूद होता है, जबsnippet.type
प्रॉपर्टी की वैल्यूuserBannedEvent
हो.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई में ये नई गड़बड़ियां शामिल हैं:
गड़बड़ी की जानकारी liveBroadcasts.bind
liveBroadcasts.bind
तरीका,403
(Forbidden
) गड़बड़ी दिखाता है. इससे पता चलता है कि उपयोगकर्ता ने तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं. गड़बड़ी की वजहuserRequestsExceedRateLimit
है.liveBroadcasts.insert
औरliveBroadcasts.update
तरीके पहले से ही एक ही गड़बड़ी के लिए काम करते हैं.liveStreams.insert
liveStreams.insert
तरीका, चार नई400
(Bad Request
) गड़बड़ियों के साथ काम करता है. ये गड़बड़ियां,liveStream
संसाधन में अमान्य प्रॉपर्टी वैल्यू की पहचान करती हैं. इस संसाधन को अनुरोध में डालने की कोशिश की गई थी. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
invalidFormat
:cdn.format
invalidFrameRate
:cdn.frameRate
invalidIngestionType
:cdn.ingestionType
invalidResolution
:cdn.resolution
liveStreams.insert
liveStreams.insert
तरीका, दो नई400
(Bad Request
) गड़बड़ियों के साथ काम करता है. इनमें से हर एक से पता चलता है कि अनुरोध में जिसliveStream
संसाधन को डालने की कोशिश की गई है उसमें ज़रूरी वैल्यू मौजूद नहीं है. यहां दी गई सूची में, गड़बड़ी की वजहों और उनसे जुड़ी प्रॉपर्टी के बारे में बताया गया है:
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
रिसॉर्स डालते समय, आपकोcdn.format
प्रॉपर्टी याcdn.frameRate
औरcdn.resolution
प्रॉपर्टी में से किसी एक के लिए वैल्यू देनी होगी.
- अगर तीनों में से किसी भी प्रॉपर्टी के लिए वैल्यू नहीं दी जाती है, तो एपीआई
formatRequired
गड़बड़ी का मैसेज दिखाता है. - अगर आपने
cdn.resolution
के लिए वैल्यू दी है, लेकिनcdn.frameRate
के लिए नहीं दी है, तो एपीआईframeRateRequired
गड़बड़ी का मैसेज दिखाता है. - अगर आपने
cdn.frameRate
के लिए वैल्यू दी है, लेकिनcdn.resolution
के लिए नहीं दी है, तो एपीआईresolutionRequired
गड़बड़ी का मैसेज दिखाता है.
liveStreams.update
अगर अनुरोध, नीचे दी गई किसी भी ऐसी प्रॉपर्टी की वैल्यू में बदलाव करने की कोशिश करता है जिसे बदला नहीं जा सकता, तो liveStreams.update
तरीका403
(Forbidden
) गड़बड़ी दिखाता है:cdn.format
cdn.frameRate
cdn.ingestionType
cdn.resolution
reason
,liveStreamModificationNotAllowed
है.
-
18 दिसंबर, 2015
यूरोपियन यूनियन (ईयू) के कानूनों के मुताबिक, ईयू में असली उपयोगकर्ताओं को कुछ जानकारी देना और उनसे सहमति लेना ज़रूरी है. इसलिए, यूरोपीय संघ के असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने YouTube API की सेवा की शर्तों में, इस ज़रूरी शर्त की सूचना जोड़ी है.
17 दिसंबर, 2015
इस अपडेट में ये बदलाव किए गए हैं:
-
नए संसाधन और तरीके
-
लाइव स्ट्रीम के लिए चैट की सुविधा देने के लिए, एपीआई कई नए संसाधनों के साथ काम करता है. YouTube पर लाइव स्ट्रीम के दौरान, लाइव चैट की सुविधा काम करती है. इन संसाधनों और उनके तरीकों की मदद से, चैट मैसेज वापस पाए जा सकते हैं. साथ ही, चैट के लिए एडमिन से जुड़े फ़ंक्शन भी इस्तेमाल किए जा सकते हैं.
संसाधन liveChatMessage
यह संसाधन, YouTube लाइव चैट में मौजूद किसी मैसेज को दिखाता है. YouTube पर कई तरह के मैसेज भेजे जा सकते हैं. इनमें टेक्स्ट मैसेज और फ़ैन फ़ंडिंग इवेंट शामिल हैं. कुछ मैसेज टाइप से चैट के किसी खास चरण की पहचान होती है. जैसे, सिर्फ़ स्पॉन्सर के लिए चैट शुरू होने या चैट खत्म होने की जानकारी. एपीआई, लाइव चैट मैसेज की सूची बनाने, उन्हें डालने, और मिटाने के तरीकों के साथ काम करता है. liveChatModerators
यह संसाधन, चैट मॉडरेटर की पहचान करता है. मॉडरेटर, एडमिन के कुछ काम कर सकते हैं. जैसे, चैट में उपयोगकर्ताओं को बैन करना या मैसेज हटाना. एपीआई, लाइव चैट के मॉडरेटर की सूची बनाने, उन्हें जोड़ने, और मिटाने के तरीकों के साथ काम करता है. liveChatBans
इस संसाधन से उस उपयोगकर्ता की पहचान की जाती है जिसे किसी खास लाइव चैट में मैसेज पोस्ट करने से प्रतिबंधित किया गया है. पाबंदियां कुछ समय के लिए या हमेशा के लिए लगाई जा सकती हैं. इस एपीआई की मदद से, लाइव चैट में पाबंदियां लगाई और हटाई जा सकती हैं. fanFundingEvents
यह संसाधन, YouTube चैनल पर फ़ैन फ़ंडिंग इवेंट के बारे में बताता है. फ़ैन फ़ंडिंग की सुविधा की मदद से, दर्शक YouTube क्रिएटर्स को एक बार में पैसे देकर उनकी मदद कर सकते हैं.
एपीआई केfanFundingEvents.list
तरीके से, चैनल के फ़ैन फ़ंडिंग इवेंट की सूची देखी जा सकती है. अगर चैनल के मालिकाना हक वाले लाइव ब्रॉडकास्ट के दौरान, लाइव चैट से फ़ैन फ़ंडिंग इवेंट शुरू किए जाते हैं, तो ब्रॉडकास्ट की लाइव चैट मेंfanFundingEvent
मैसेज भी ट्रिगर होता है.
फ़ैन फ़ंडिंग के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.sponsors
sponsor
संसाधन, YouTube चैनल के प्रायोजक की पहचान करता है. स्पॉन्सर, चैनल को हर महीने पैसे चुकाता है. चैनल की लाइव चैट में, स्पॉन्सर के मैसेज के बगल में एक बैज दिखता है. साथ ही, स्पॉन्सर सिर्फ़ स्पॉन्सर के लिए उपलब्ध लाइव चैट में भी हिस्सा ले सकते हैं.
एपीआई केsponsors.list
मेथड से, चैनल के प्रायोजकों की सूची मिलती है. जब उपयोगकर्ता किसी चैनल के मालिकाना हक वाले लाइव ब्रॉडकास्ट के दौरान, उस चैनल को प्रायोजित करने के लिए साइन अप करते हैं, तो एपीआई उस ब्रॉडकास्ट की लाइव चैट मेंnewSponsorEvent
मैसेज भी जोड़ता है.
प्रायोजन के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
-
-
मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट
-
liveBroadcast
संसाधन में ये नई प्रॉपर्टी शामिल हैं:प्रॉपर्टी snippet.liveChatId
ब्रॉडकास्ट की YouTube लाइव चैट का आईडी. इस आईडी की मदद से, चैट मैसेज वापस पाने, डालने या मिटाने के लिए, liveChatMessage
रिसॉर्स के तरीकों का इस्तेमाल किया जा सकता है. आपके पास चैट मॉडरेटर जोड़ने या हटाने का विकल्प भी होता है. साथ ही, लाइव चैट में हिस्सा लेने से उपयोगकर्ताओं को प्रतिबंधित किया जा सकता है या मौजूदा प्रतिबंध हटाए जा सकते हैं.contentDetails.closedCaptionsType
ध्यान दें: यह प्रॉपर्टी, contentDetails.enableClosedCaptions
प्रॉपर्टी की जगह ले लेती है.
इस प्रॉपर्टी से पता चलता है कि आपके ब्रॉडकास्ट के लिए सबटाइटल की सुविधा चालू है या नहीं. अगर चालू है, तो किस तरह के सबटाइटल उपलब्ध कराए जा रहे हैं:closedCaptionsDisabled
: लाइव स्ट्रीम के लिए सबटाइटल की सुविधा बंद है.closedCaptionsHttpPost
: आपको एचटीटीपी पोस्ट के ज़रिए, अपनी लाइव स्ट्रीम से जुड़े इनजेशन यूआरएल पर कैप्शन भेजने होंगे.closedCaptionsEmbedded
: कैप्शन को EIA-608 और/या CEA-708 फ़ॉर्मैट का इस्तेमाल करके, वीडियो स्ट्रीम में एन्कोड किया जाएगा.
contentDetails.enableClosedCaptions
इस प्रॉपर्टी का इस्तेमाल 17 दिसंबर, 2015 से नहीं किया जा सकता. इसके बजाय, contentDetails.closedCaptionsType
प्रॉपर्टी का इस्तेमाल करें. इस प्रॉपर्टी का इस्तेमाल पहले से कर रहे एपीआई क्लाइंट के लिए:- प्रॉपर्टी की वैल्यू को
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 पर 60fps में लाइव स्ट्रीम करने पर, YouTube उस स्ट्रीम को उन डिवाइसों पर 30fps में भी उपलब्ध कराता है जहां फ़िलहाल हाई फ़्रेम रेट में वीडियो देखने की सुविधा उपलब्ध नहीं है.
liveStream
रिसॉर्स कीcdn.format
प्रॉपर्टी, इस सुविधा के लिए दो नई वैल्यू के साथ काम करती है:720p_hfr
और1080p_hfr
.इस सुविधा के बारे में ज़्यादा जानने के लिए, YouTube Creators ब्लॉग देखें.
21 अगस्त, 2014
इस अपडेट में ये बदलाव किए गए हैं:
-
liveBroadcasts.control
तरीके केwalltime
पैरामीटर की परिभाषा को अपडेट किया गया है, ताकि यह पता चल सके कि प्रॉपर्टी की वैल्यू, ISO 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
है, तो ब्रॉडकास्ट कोlive
स्टेटस पर ट्रांज़िशन करने से पहले, आपको उसेtesting
स्टेटस पर ट्रांज़िशन करना होगा. (अगर प्रॉपर्टी की वैल्यूfalse
है, तो आपके ब्रॉडकास्ट मेंtesting
स्टेज नहीं हो सकता. इसलिए, ब्रॉडकास्ट को सीधेlive
स्टेटस पर ट्रांज़िशन किया जा सकता है. -
liveCuepoint
रिसॉर्स कीsettings.offsetTimeMs
प्रॉपर्टी को अपडेट कर दिया गया है. इससे यह पता चलता है कि अगर आपके ब्रॉडकास्ट में मॉनिटर स्ट्रीम नहीं है, तो आपको प्रॉपर्टी के लिए कोई वैल्यू नहीं देनी चाहिए. -
liveBroadcast
औरliveStream
संसाधनों के सभी तरीके अबonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करते हैं. इन पैरामीटर की मदद से, एक ही कॉन्टेंट के मालिक से जुड़े अलग-अलग चैनलों के लिए एपीआई अनुरोधों को पूरा करने के लिए, अनुमति वाले एक ही क्रेडेंशियल का इस्तेमाल किया जा सकता है. -
liveCuepoints.insert
तरीके के दस्तावेज़ को अपडेट किया गया है, ताकि यह पता चल सके कि उस तरीके को कॉल करते समय,settings.walltime
प्रॉपर्टी के लिए वैल्यू सेट की जा सकती है. -
गड़बड़ी से जुड़े दस्तावेज़ में, अब हर तरह की गड़बड़ी के लिए एचटीटीपी रिस्पॉन्स कोड बताया गया है.
-
एपीआई अब इस गड़बड़ी को दिखाता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा insufficientPermissions
livePermissionBlocked
liveBroadcasts.insert
,liveBroadcasts.transition
, औरliveStreams.insert
तरीके से यह गड़बड़ी तब दिखती है, जब अनुरोध की अनुमति देने वाला उपयोगकर्ता YouTube पर लाइव वीडियो स्ट्रीम नहीं कर पा रहा हो. 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
liveBroadcasts.control
पैरामीटर की वैल्यू अमान्य होने पर,liveBroadcasts.control
तरीका यह गड़बड़ी दिखाता है.walltime
forbidden
enableClosedCaptionsModificationNotAllowed
liveBroadcasts.update
तरीका, यह गड़बड़ी तब दिखाता है, जबcontentDetails.enableClosedCaptions
वैल्यू को अपडेट करने की कोशिश की जाती है और ब्रॉडकास्ट की स्थितिcreated
याready
नहीं होती.invalidValue
conflictingTimeFields
अगर आपके अनुरोध में settings.offsetTimeMs
औरsettings.walltime
प्रॉपर्टी की वैल्यू दी गई हैं, तोliveCuepoints.insert
तरीका यह गड़बड़ी दिखाता है. अनुरोध में दोनों प्रॉपर्टी को शामिल नहीं किया जा सकता या इनमें से किसी एक प्रॉपर्टी की वैल्यू दी जा सकती है.इसके अलावा,
liveStreams.update
वाले तरीके से अबcdnRequired
वाली गड़बड़ी ठीक नहीं की जा सकती. यह गड़बड़ी,liveStreams.insert
वाले तरीके से ठीक की जा सकती है.
10 मई, 2013
इस अपडेट में ये बदलाव किए गए हैं:
-
YouTube अब एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई की सुविधाओं और सेवाओं की पहचान नहीं करता. इसके बजाय, अब हम YouTube के उन एपीआई की सूची उपलब्ध कराते हैं जिन पर बंद किए जाने की नीति लागू होती है.
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
की इस्तेमाल की जा सकने वाली वैल्यू की सूची से हटा दिया गया है.