संशोधन इतिहास

इस पेज पर, YouTube Data API (v3) में हुए बदलावों और दस्तावेज़ से जुड़े अपडेट की सूची दी गई है.

30 सितंबर, 2026

comments संसाधन की परिभाषा को अपडेट किया गया है, ताकि इसमें नई snippet.imageUrl प्रॉपर्टी शामिल की जा सके. यह प्रॉपर्टी, टिप्पणी में अटैच की गई इमेज या ऐनिमेशन वाले GIF का यूआरएल उपलब्ध कराती है.

यह सुविधा, नवंबर 2026 में सभी उपयोगकर्ताओं के लिए उपलब्ध होगी.

14 सितंबर, 2026

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

• thumbnails.set तरीके के ब्यौरे को अपडेट किया गया है. इसमें बताया गया है कि अपलोड किए गए थंबनेल का ज़्यादा से ज़्यादा साइज़ 2 एमबी से बढ़कर 50 एमबी हो गया है.
• playlistImages.insert तरीके के ब्यौरे को अपडेट किया गया है. इसमें बताया गया है कि अपलोड की गई इमेज का ज़्यादा से ज़्यादा साइज़ 2 एमबी से बढ़कर 50 एमबी हो गया है.

11 सितंबर, 2026

activities, liveBroadcasts, playlistItems, playlists, search, और videos संसाधनों के लिए, रेफ़रंस दस्तावेज़ में snippet.thumbnails.(key) प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि अब कुछ वीडियो के लिए, ज़्यादा रिज़ॉल्यूशन वाले थंबनेल उपलब्ध हैं: fhd (1080 पिक्सल), qhd (1440 पिक्सल), और uhd (4K).

1 सितंबर, 2026

videos.getRating तरीके में अब https://www.googleapis.com/auth/youtube.readonly अनुमति के दायरे को स��वीकार किया जाता है.

27 अगस्त, 2026

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

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

YouTube Partner Program में शामिल होने की ज़रूरी शर्तों में कोई बदलाव नहीं किया गया है. YouTube Partner Program में शामिल होने की ज़रूरी शर्तों को अब "शॉर्ट वीडियो को मिले मान्य व्यू" और "वीडियो देखने के मान्य घंटे" कहा जाएगा. पहले इन्हें "सार्वजनिक शॉर्ट वीडियो पर मिले मान्य व्यू" और "सार्वजनिक वीडियो देखने के मान्य घंटे" कहा जाता था.

ज़्यादा जानने के लिए, YouTube पर अपने कॉन्टेंट की परफ़ॉर्मेंस के बारे में जानना लेख पढ़ें.

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

एपीआई के दस्तावेज़ से जुड़े अपडेट: चैनल और वीडियो के रेफ़रंस दस्तावेज़ में, viewCount फ़ील्ड की जानकारी अपडेट की गई है.

6 अगस्त, 2026

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

• activities.contentDetails में मौजूद contentDetails.like और contentDetails.favorite फ़ील्ड के सभी रेफ़रंस, सार्वजनिक दस्तावेज़ से हटा दिए गए हैं. ऐसा इसलिए, क्योंकि एपीआई इन फ़ील्ड को वापस नहीं भेजता है.

7 जुलाई, 2026

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

अब यह एपीआई, videos रिसॉर्स में brandPartner वाले हिस्से के साथ काम करता है. इस हिस्से में, उस ब्रैंड पार्टनर के बारे में जानकारी होती है जिसे क्रिएटर के लिए ब्रैंड पार्टनर ऐक्सेस के तहत, वीडियो से लिंक किया गया है.

brandPartner वाले हिस्से को इन तरीकों से कॉल करते समय तय किया जा सकता है:

• videos.insert
• videos.update
• videos.list

brandPartner ऑब्जेक्ट में ये फ़ील्ड शामिल होते हैं:

• channelId: ब्रैंड पार्टनर का एक्सटर्नल चैनल आईडी.
• channelHandle: ब्रैंड पार्टनर का चैनल हैंडल.

लिंक बनाते समय, channelId या channelHandle में से किसी एक को सेट करना ज़रूरी है. हालाँकि, जवाब में सिर्फ़ channelId दिखता है.

23 जून, 2026

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

• liveChatMessages में मौजूद messageDeletedEvent और messageRetractedEvent रिसॉर्स टाइप (और उनसे जुड़े messageDeletedDetails और messageRetractedDetails ऑब्जेक्ट) के सभी रेफ़रंस हटा दिए गए हैं, क्योंकि एपीआई इन इवेंट को वापस नहीं भेज रहा है.

3 जून, 2026

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

एपीआई अब एक नए तरीके, videos.batchGetStats के साथ काम करता है. यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाले वीडियो के आंकड़ों की सूची को वापस लाता है.

इस तरीके को कॉल करने पर, इसके ग्रेन्यूलर कोटा बकेट में 1 यूनिट की कोटा लागत लगती है. इस तरीके के लिए, हर दिन का डिफ़ॉल्ट कोटा 10,000 यूनिट है.

1 जून, 2026

YouTube Data API, कोटा सिस्टम को ज़्यादा बारीकी से मैनेज करने वाले सिस्टम पर स्विच कर रहा है. इसमें तरीकों के छोटे सेट शामिल हैं. इसकी शुरुआत videos.insert और search.list से हो रही है.

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

videos.insert और search.list तरीकों के लिए किए गए एपीआई कॉल का शुल्क, उनके संबंधित कोटा बकेट से लिया जाएगा. अन्य सभी तरीकों के लिए किए गए एपीआई कॉल का शुल्क, मौजूदा कोटा बकेट से लिया जाएगा. डेवलपर, Google Cloud Console में कोटा की सीमाएं देख सकते हैं. साथ ही, वे कोटा बढ़ाने के अनुरोध वाला फ़ॉर्म भरकर, अतिरिक्त कोटा का अनुरोध कर सकते हैं.

4 दिसंबर, 2025

YouTube Data API के दस्तावेज़ और कोटा कैलकुलेटर को अपडेट कर दिया गया है. ��ससे, वीडियो अपलोड करने के लिए कोटा की लागत में हुए बदलाव के बारे में पता चलता है. यह बदलाव, करीब 1,600 यूनिट से करीब 100 यूनिट का है.

10 जुलाई, 2025

YouTube, 21 जुलाई, 2025 से video.list तरीके के mostPopular चार्ट से मिले कॉन्टेंट में बदलाव करेगा. पहले, mostPopular चार्ट में, 'अभी ट्रेंडिंग में हैं' सूची में दिखाए गए वीडियो दिखते थे. अब mostPopular चार्ट में, ट्रेंडिंग संगीत, फ़िल्मों, और गेमिंग चार्ट के वीडियो दिखेंगे. एपीआई में यह बदलाव, YouTube के ट्रेंडिंग पेज के बंद होने के साथ-साथ किया गया है.

26 मार्च, 2025

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

31 मार्च, 2025 से, Data API के इन फ़ील्ड में Shorts को मिले व्यू की संख्या, इस बदलाव के हिसाब से दिखेगी:

• channels.statistics.viewCount
• videos.statistics.viewCount

30 अक्टूबर, 2024

एपीआई अब ऐसे वीडियो की पहचान कर सकता है जिनमें असल जैसा दिखने वाला बदलाव करके बनाया गया या अप्राकृतिक (A/S) कॉन्टेंट शामिल है. A/S कॉन्टेंट से जुड़ी YouTube की नीतियों के बारे में ज़्यादा जानें.

ए/एस कॉन्टेंट के उदाहरणों में ऐसे वीडियो शामिल हैं जिनमें:

• किसी व्यक्ति को कुछ ऐसा कहते या करते हुए दिखाया गया हो जो उसने असल में नहीं कहा या किया
• किसी असल इवेंट या ज��ह के फ़ुटेज में बदलाव किया गया हो
• ऐसा सीन जनरेट किया गया हो जो असल दिखता है, लेकिन है नहीं

यह बताने के लिए कि किसी वीडियो में ए/एस कॉन्टेंट है या नहीं, status.containsSyntheticMedia प्रॉपर्टी सेट करें. इस प्रॉपर्टी को videos.insert या videos.update तरीकों को कॉल करते समय सेट किया जा सकता है. अगर यह प्रॉपर्टी सेट की जाती है, तो video रिसॉर्स में यह प्रॉपर्टी दिखती है.

30 अप्रैल, 2024

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

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

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

13 मार्च, 2024

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

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

captions.insert और captions.update तरीकों के लिए, sync पैरामीटर का इस्तेमाल बंद कर दिया गया है. YouTube, 12 अप्रैल, 2024 से इस पैरामीटर का इस्तेमाल बंद कर देगा.

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

12 मार्च, 2024

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

captions संसाधन के दस्तावेज़ को अपडेट कर दिया गया है. इसमें बताया गया है कि snippet.name फ़ील्ड में ज़्यादा से ज़्यादा 150 वर्ण हो सकते हैं. अगर ट्रैक का नाम इससे ज़्यादा लंबा है, तो एपीआई nameTooLong गड़बड़ी का मैसेज दिखाता है.

7 मार्च, 2024

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

channel संसाधन प्रॉपर्टी brandingSettings.channel.moderateComments अब काम नहीं करती है. YouTube, 7 मार्च, 2024 से इस पैरामीटर का इस्तेमाल बंद कर देगा.

31 जनवरी, 2024

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

channels.list तरीके के नए forHandle पैरामीटर की मदद से, किसी चैनल के YouTube हैंडल की जा��कारी देकर उसके बारे में जानकारी पाई जा सकती है.

09 नवंबर, 2023

Comments में मौजूद videoId संसाधन के सभी रेफ़रंस हटा दिए गए हैं, क्योंकि एपीआई कॉल का इस्तेमाल करके videoId संसाधन वापस नहीं किया जा रहा है.

12 सितंबर, 2023

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

comments.markAsSpam तरीके का इस्तेमाल कई सालों से नहीं किया जा रहा है. YouTube पर यह तरीका पहले से ही काम नहीं करता. साथ ही, अब यह एपीआई के ज़रिए भी काम नहीं करता.

comments.markAsSpam तरीके का रेफ़रंस देने वाले सभी दस्तावेज़ों में, सुविधा बंद होने की सूचना जोड़ दी गई है.

22 अगस्त, 2023

search.list तरीका अब videoPaidProductPlacement पैरामीटर के साथ काम करता है. इस पैरामीटर की मदद से, खोज के नतीजों को फ़िल्टर किया जा सकता है. इससे सिर्फ़ वे वीडियो दिखते हैं जिनमें क्रिएटर ने पैसे लेकर किया गया प्रमोशन किया है.

18 अगस्त, 2023

video संसाधन की liveStreamingDetails.concurrentViewers परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि YouTube Data API से मिले, एक साथ वीडियो देखने वालों की संख्या, YouTube Analytics में उपलब्ध, प्रोसेस किए गए और स्पैम हटाकर मिले, एक साथ वीडियो देखने वालों की संख्या से अलग हो सकती है. YouTube सहायता केंद्र पर, लाइव स्ट्रीमिंग की मेट्रिक के बारे में ज़्यादा जानकारी दी गई है.

7 अगस्त, 2023

12 जून, 2023 को किए गए एलान के मुताबिक, search.list तरीके के relatedToVideoId पैरामीटर का इस्तेमाल बंद कर दिया गया है. अब उस पैरामीटर का इस्तेमाल नहीं किया जा सकता. साथ ही, एपीआई के दस्तावेज़ से उस पैरामीटर के रेफ़रंस हटा दिए गए हैं.

28 जून, 2023

thumbnails.set तरीके में अब uploadRateLimitExceeded गड़बड़ी ठीक की जा सकती है. इससे पता चलता है कि चैनल ने पिछले 24 घंटों में बहुत ज़्यादा थंबनेल अपलोड किए हैं. इस���िए, उसे कुछ समय बाद फिर से कोशिश करनी चाहिए.

12 जून, 2023

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

search.list तरीके के relatedToVideoId पैरामीटर का इस्तेमाल बंद कर दिया गया है. YouTube, 7 अगस्त, 2023 से इस पैरामीटर का इस्तेमाल बंद कर देगा.

फ़िलहाल, search.list तरीके के दस्तावेज़ में, सुविधा बंद होने की सूचना जोड़ी गई है. इस पैरामीटर को 7 अगस्त, 2023 या इसके बाद, search.list के दस्तावेज़ से पूरी तरह हटा दिया जाएगा.

इसके अलावा, एपीआई लागू करने से जुड़ी गाइड से, मिलते-जुलते वीडियो पाने का तरीका बताने वाला उदाहरण हटा दिया गया है.

22 अगस्त, 2022

video.statistics फ़ील्ड के लिए, टाइप एनोटेशन को unsigned long से बदलकर स्ट्रिंग कर दिया गया है.

5 अगस्त, 2022

YouTube ने कैप्शन आईडी जनरेट करने का तरीका बदल दिया है. इस बदलाव के तहत, सभी कैप्शन ट्रैक को नए कैप्शन आईडी असाइन किए जा रहे हैं. यह बदलाव, caption_id वैल्यू सेव करने वाले ऐप्लिकेशन के साथ काम नहीं कर सकता. हालांकि, इससे caption_id वैल्यू सेव न करने वाले ऐप्लिकेशन पर कोई असर नहीं पड़ेगा.

अभी से लेकर 1 दिसंबर, 2022 तक, captions.list, captions.update, captions.download, और captions.delete तरीके, कैप्शन ट्रैक के पुराने और नए आईडी, दोनों के साथ काम करेंगे. हालांकि, 1 दिसंबर, 2022 को या उसके बाद, YouTube पुराने कैप्शन ट्रैक आईडी के लिए सहायता देना बंद कर देगा. उस समय, पुराने कैप्शन ट्रैक आईडी के साथ इनमें से किसी भी एपीआई तरीके को कॉल करने पर, captionNotFound गड़बड़ी होगी.

इस बदलाव के लिए तैयार होने के लिए, आपको अभी से लेकर 1 दिसंबर, 2022 तक, सेव किए गए सभी कैप्शन ट्रैक डेटा को पूरी तरह से बदलने का प्लान बनाना चाहिए. इसका मतलब है कि जिस वीडियो के लिए कैप्शन ट्रैक का डेटा सेव किया जाता है उसके लिए, आपको मौजूदा सेव किया गया डेटा मिटाना होगा. इसके बाद, captions.list तरीके को कॉल करके, वीडियो के लिए कैप्शन ट्रैक का मौजूदा सेट वापस पाना होगा. साथ ही, डेटा को एपीआई रिस्पॉन्स में सेव करना होगा.

12 जुलाई, 2022

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

27 अप्रैल, 2022

videos.insert तरीके के बारे में दी गई जानकारी को अपडेट किया गया है. इसमें बताया गया है कि अपलोड किए गए वीडियो का ज़्यादा से ज़्यादा साइज़ 128 जीबी से बढ़कर 256 जीबी हो गया है.

8 अप्रैल, 2022

subscriptions.list तरीके के myRecentSubscribers और mySubscribers पैरामीटर की परिभाषाओं को अपडेट किया गया है. इससे यह पता चलता है कि एपीआई से मिले सदस्यों की ज़्यादा से ज़्यादा संख्या सीमित हो सकती है. यह बदलाव, दस्तावेज़ में की गई गड़बड़ी को ठीक करने के लिए किया गया है. इससे एपीआई के काम करने के तरीके में कोई बदलाव नहीं होगा.

15 दिसंबर, 2021

18 नवंबर, 2021 को यह एलान किया गया था कि YouTube प्लैटफ़ॉर्म पर, वीडियो को नापसंद करने की संख्या को निजी तौर पर दिखाने की सुविधा में बदलाव किए गए हैं. इसके साथ ही, video संसाधन की statistics.dislikeCount प्रॉपर्टी को अब निजी तौर पर दिखाया जाएगा.

इस बदलाव के बारे में ज़्यादा जानने के लिए, YouTube के आधिकारिक ब्लॉग पर जाएं.

18 नवंबर, 2021

YouTube प्लैटफ़ॉर्म पर, वीडियो को नापसंद करने वालों की संख्या को निजी तौर पर सेट करने के लिए किए गए बदलावों के साथ-साथ, video संसाधन की statistics.dislikeCount प्रॉपर्टी को 13 दिसंबर, 2021 से निजी तौर पर सेट कर दिया जाएगा. इसका मतलब है कि इस प्रॉपर्टी को videos.list एंडपॉइंट से मिले एपीआई रिस्पॉन्स में सिर्फ़ तब शामिल किया जाएगा, जब एपीआई अनुरोध की पुष्टि वीडियो के मालिक ने की हो.

इस बदलाव का असर, videos.rate एंडपॉइंट पर नहीं पड़ेगा.

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

इस बदलाव के बारे में ज़्यादा जानने के लिए, YouTube के आधिकारिक ब्लॉग पर जाएं.

2 जुलाई, 2021

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

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

तरीके का इस्तेमाल करें. अगर आपके कोड को commentThreads संसाधन की ज़रूरत है, तो commentThreads.list तरीके को दूसरा कॉल करें.

1 जुलाई, 2021

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

इन प्रोसेस के बारे में ज़्यादा जानकारी देने और एपीआई सेवाओं का इस्तेमाल करने वाले डेवलपर की ज़रूरतों को बेहतर तरीके से पूरा करने के लिए, हम तीन नए फ़ॉर्म और उन्हें भरने के लिए एक गाइड जोड़ रहे हैं:

• ऑडिट और कोटा बढ़ाने का फ़ॉर्म: जिन डेवलपर ने एपीआई के नियमों के पालन से जुड़ी ऑडिट पहले ही पास कर ली है वे इस फ़ॉर्म को भर सकते हैं और सबमिट कर सकते हैं. इसके लिए, उन्हें पहले सवाल में "मौजूदा कोटा बनाए रखने के लिए, नियमों के पालन से जुड़ी ऑडिट पूरी करें (फिर से ऑडिट करने का अनुरोध किया गया है)" विकल्प को चुनना होगा. इससे वे तय किए गए कोटा को बढ़ाने का अनुरोध कर पाएंगे.
• अपील फ़ॉर्म: जिन डेवलपर के एपीआई ��्रोजेक्ट, अनुपालन ऑडिट में पास नहीं हुए हैं या जिनके लिए कोटा यूनिट बढ़ाने का अनुरोध अस्वीकार कर दिया गया है वे यह फ़ॉर्म भर सकते हैं और सबमिट कर सकते हैं.
• मैनेजमेंट में बदलाव होने पर सबमिट किया जाने वाला फ़ॉर्म: अगर डेवलपर या डेवलपर की ओर से एपीआई क्लाइंट को ऑपरेट करने वाले किसी पक्ष के मैनेजमेंट में बदलाव होता है (उदाहरण के लिए, स्टॉक की खरीदारी या बिक्री, कंपनी का मर्ज होना या किसी और तरह के कॉर्पोरेट लेन-देन की वजह से होने वाले बदलाव), तो उसे एपीआई प्रोजेक्ट से जुड़ा यह फ़ॉर्म भरना और सबमिट करना होगा. इससे YouTube की एपीआई टीम को हमारे रिकॉर्ड अपडेट करने, एपीआई के नए प्रोजेक्ट के इस्तेमाल के उदाहरण की ऑडिट करने, और डेवलपर के मौजूदा कोटे के बंटवारे की पुष्टि करने में मदद मिलती है.

हर नए फ़ॉर्म से हमें YouTube के एपीआई के इस्तेमाल के बारे में पता चलेगा. इससे हम आपकी बेहतर तरीके से मदद कर पाएंगे.

ज़्यादा जानकारी के लिए, एपीआई के इस्तेमाल से जुड़ी शर्तों के पालन की ऑडिट से जुड़ी हमारी नई गाइड देखें.

12 मई, 2021

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

इस अपडेट में, एपीआई से जुड़े ये बदलाव शामिल हैं:

• channel संसाधन की contentDetails.relatedPlaylists.favorites प्रॉपर्टी अब काम नहीं करती है. पसंदीदा वीडियो की सुविधा को कई सालों पहले बंद कर दिया गया था. इसकी जानकारी, 28 अप्रैल, 2016 को किए गए बदलाव के इतिहास में दी गई है.

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

• channel संसाधन की इन प्रॉपर्टी को बंद कर दिया गया है. ये प्रॉपर्टी, YouTube Studio के यूज़र इंटरफ़ेस (यूआई) और YouTube पर पहले से ही काम नहीं करती हैं. इसलिए, अब एपीआई के ज़रिए भी इनका इस्तेमाल नहीं किया जा सकता.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  सभी प्रॉपर्टी को channel संसाधन के तौर पर दिखाया गया है. साथ ही, उनकी परिभाषाओं को संसाधन की प्रॉपर्टी की सूची से हटा दिया गया है. इसके अलावा, इन प्रॉपर्टी से जुड़ी गड़बड़ियों को, तरीके के हिसाब से बनाए गए दस्तावेज़ से हटा दिया गया है.

• channelSection संसाधन की इन प्रॉपर्टी को बंद कर दिया गया है. ये प्रॉपर्टी, YouTube Studio के यूज़र इंटरफ़ेस (यूआई) और YouTube पर पहले से ही काम नहीं करती हैं. इसलिए, अब एपीआई के ज़रिए भी इनका इस्तेमाल नहीं किया जा सकता.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  इस बदलाव के साथ-साथ, channelSection.list तरीके के hl पैरामीटर को भी बंद कर दिया गया है. ऐसा इसलिए, क्योंकि यह जिन सुविधाओं के साथ काम करता है वे मौजूद नहीं हैं.

  सभी प्रॉपर्टी को channelSection संसाधन के प्रतिनिधित्व से हटा दिया गया है. साथ ही, उनकी परिभाषाओं को संसाधन की प्रॉपर्टी की सूची से हटा दिया गया है. इसके अलावा, इन प्रॉपर्टी से जुड़ी गड़बड़ियों को, तरीके के हिसाब से बनाए गए दस्तावेज़ से हटा दिया गया है.

• channelSection संसाधन की snippet.type प्रॉपर्टी के लिए, यहां दी गई वैल्यू अब काम नहीं करती हैं. ये वैल्यू, YouTube चैनल पेजों पर पहले से ही काम नहीं करती हैं. इसलिए, अब ये एपीआई के ज़रिए भी काम नहीं करती हैं.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• playlist संसाधन की snippet.tags[] प्रॉपर्टी अब काम नहीं करती है. यह प्रॉपर्टी, YouTube पर पहले से ही काम नहीं करती है. इसलिए, अब यह एपीआई के ज़रिए भी काम नहीं करती.

9 फ़रवरी, 2021

playlistItem रिसॉर्स के साथ दो नई प्रॉपर्टी काम करती हैं:

• snippet.videoOwnerChannelId प्रॉपर्टी, उस चैनल के आईडी की पहचान करती है जिसने प्लेलिस्ट वीडियो अपलोड किया है.
• snippet.videoOwnerChannelTitle प्रॉपर्टी से, उस चैनल के नाम का पता ��लता है जिसने प्लेलिस्ट में शामिल वीडियो अपलोड किया है.

28 जनवरी, 2021

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

• playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list, और playlists.update, सभी में playlistOperationUnsupported नई गड़बड़ी का पता लगाने की सुविधा है. यह गड़बड़ी तब होती है, जब कोई अनुरोध ऐसी कार्रवाई करने की कोशिश करता है जिसकी अनुमति किसी प्लेलिस्ट के लिए नहीं है. उदाहरण के लिए, कोई उपयोगकर्ता अपलोड किए गए वीडियो की प्लेलिस्ट से कोई वीडियो नहीं मिटा सकता. इसके अलावा, वह प्लेलिस्ट को भी नहीं मिटा सकता.

  इन सभी मामलों में, इस गड़बड़ी से 400 एचटीटीपी रिस्पॉन्स कोड (गलत अनुरोध) मिलता है.

• दस्तावेज़ से, playlistItems.list तरीके की watchHistoryNotAccessible और watchLaterNotAccessible गड़बड़ियों को हटा दिया गया है. यह सही है कि एपीआई के ज़रिए, उपयोगकर्ताओं के वीडियो देखने के इतिहास और 'बाद में देखें' सूचियों को ऐक्सेस नहीं किया जा सकता. हालांकि, एपीआई से ये गड़बड़ियां नहीं मिलती हैं.

15 अक्टूबर, 2020

डेवलपर प्रोग्राम की नीतियों में दो नए सेक्शन जोड़े गए हैं:

• नए सेक्शन III.E.4.i में, YouTube के एम्बेड किए गए प्लेयर के ज़रिए इकट्ठा किए गए और भेजे गए डेटा के बारे में ज़्यादा जानकारी दी गई है. उपयोगकर्ता के साथ इंटरैक्ट करने से पहले, YouTube के एम्बेड किए गए किसी भी प्लेयर के ज़रिए हमें भेजे गए उपयोगकर्ता के डेटा के लिए, आप ज़िम्मेदार हैं. अपने-आप वीडियो चलने की सुविधा को बंद करके, उपयोगकर्ता के प्लेयर के साथ इंटरैक्ट करने से पहले, YouTube के साथ शेयर किए जाने वाले डेटा को सीमित किया जा सकता है.
• नया सेक्शन III.E.4.j, आपकी साइटों और ऐप्लिकेशन पर कॉन्टेंट एम्बेड करने से पहले, यह जांचने से जुड़ा है कि वह 'बच्चों के लिए बना कॉन्टेंट' (एमएफ़के) के तौर पर मार्क किया गया है या नहीं. यह आपकी ज़िम्मेदारी है कि आपको पता हो कि आपके एपीआई क्लाइंट पर एम्बेड कि�� गए वीडियो, बच्चों के लिए बने हैं या नहीं. साथ ही, एम्बेड किए गए प्लेयर से इकट्ठा किए गए डेटा को उसी हिसाब से मैनेज करें. इसलिए, आपको YouTube Data API सेवा का इस्तेमाल करके, कॉन्टेंट की स्थिति की जांच करनी होगी. इसके बाद ही, उसे YouTube के एम्बेड किए गए किसी भी प्लेयर के ज़रिए, अपने एपीआई क्लाइंट पर एम्बेड किया जा सकेगा.

किसी वीडियो के 'बच्चों के लिए बना है' स्टेटस का पता लगाना गाइड में बताया गया है कि YouTube Data API सर्विस का इस्तेमाल करके, किसी वीडियो के MFK स्टेटस का पता कैसे लगाया जाता है.

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

8 अक्टूबर, 2020

इस अपडेट में, channel संसाधन से जुड़े तीन छोटे बदलाव शामिल हैं:

• snippet.thumbnails ऑब्जेक्ट, चैनल की थंबनेल इमेज की पहचान करता है. नए चैनलों के लिए यह ऑब्जेक्ट खाली हो सकता है. साथ ही, इसमें डेटा भरने में एक दिन लग सकता है.
• statistics.videoCount प्रॉपर्टी से, चैनल पर मौजूद सार्वजनिक वीडियो की संख्या का पता चलता है. यह संख्या, चैनल के मालिकों को भी दिखती है. यह व्यवहार, YouTube की वेबसाइट पर दिखने वाली संख्याओं से मेल खाता है.
• चैनल के कीवर्ड, brandingSettings.channel.keywords प्रॉपर्टी में पहचाने जाते हैं. अगर ये कीवर्ड, ज़्यादा से ज़्यादा 500 वर्णों की तय सीमा से ज़्यादा होते हैं या इनमें बिना एस्केप किए गए कोटेशन मार्क (") होते हैं, तो इन्हें छोटा किया जा सकता है. ध्यान दें कि 500 वर्णों की सीमा, हर कीवर्ड के लिए तय सीमा नहीं है. यह सभी कीवर्ड की कुल लंबाई के लिए तय सीमा है. यह ठीक वैसे ही काम करता है जैसे YouTube की वेबसाइट पर करता है.

9 सितंबर, 2020

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

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

• नीचे दिए गए एपीआई संसाधन, तरीके, पैरामीटर, और संसाधन प्रॉपर्टी को तुरंत बंद कर दिया गया है. ये इस सूचना की तारीख के बाद काम नहीं करेंगी:
  • channel संसाधन की ये प्रॉपर्टी:
    • statistics.commentCount प्रॉपर्टी
    • brandingSettings.image ऑब्जेक्ट और इसकी सभी चाइल्ड प्रॉपर्टी
    • brandingSettings.hintsसूची और उसकी सभी चाइल्ड प्रॉपर्टी
  • channels.list तरीके का categoryId फ़िल्टर पैरामीटर
  • guideCategories संसाधन और guideCategories.list तरीका
• अगर एपीआई अनुरोध में managedByMe पैरामीटर को true पर सेट किया जाता है, तो channels.list तरीके के लिए एपीआई से मिले जवाबों में अब prevPageToken प्रॉपर्टी शामिल नहीं होती. इस बदलाव का असर, channels.list के अन्य अनुरोधों के लिए prevPageToken प्रॉपर्टी पर नहीं पड़ता. साथ ही, इसका असर किसी भी अनुरोध के लिए nextPageToken प्रॉपर्टी पर नहीं पड़ता.
• channel संसाधन की contentDetails.relatedPlaylists.watchLater और contentDetails.relatedPlaylists.watchHistory प्रॉपर्टी, दोनों को 11 अगस्त, 2016 को बंद कर दिया गया था. इन प्लेलिस्ट के लिए, playlistItems.insert और playlistItems.delete तरीकों का इस्तेमाल अब पूरी तरह से बंद कर दिया गया है. साथ ही, इन दोनों प्रॉपर्टी को दस्तावेज़ से हटा दिया गया है.
• channels.list तरीके के mySubscribers पैरामीटर को दस्तावेज़ से हटा दिया गया है. इस पैरामीटर के बंद होने का एलान 30 जुलाई, 2013 को किया गया था. पुष्टि किए गए उपयोगकर्ता के चैनल के सदस्यों की सूची पाने के लिए, subscriptions.list तरीके और इसके mySubscribers पैरामीटर का इस्तेमाल करें.
• channel संसाधन का invideoPromotion ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी को दस्तावेज़ से हटा दिया गया है. इन प्रॉपर्टी के बंद होने की सूचना 27 नवंबर, 2017 को दी गई थी.

29 जुलाई, 2020

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

इस बदलाव का असर यह होगा कि ज़्यादातर एपीआई कॉल के लिए, कोटा की लागत थोड़ी कम हो जाएगी. हालांकि, कुछ एपीआई कॉल के लिए लागत अब भी उतनी ही रहेगी. इस बदलाव से, किसी भी एपीआई कॉल की कीमत में बढ़ोतरी नहीं होगी. कुल मिलाकर, इसका असर यह होगा कि आपको जो कोटा मिला है वह थोड़ा ज़्यादा चलेगा. यह कोटा, Google Cloud Console में देखा जा सकता है.

हमारा सुझाव है कि सभी डेवलपर अपने प्रोजेक्ट के लिए नीति के पालन से जुड़ी ऑडिट पूरी करें. इससे यह पक्का किया जा सकेगा कि उन्हें YouTube API की सेवाओं का ऐक्सेस मिलता रहे.

बदलाव के इतिहास की इस एंट्री को पहली बार 20 जुलाई, 2020 को पब्लिश किया गया था.

28 जुलाई, 2020

videos.insert एंडपॉइंट के ज़रिए अपलोड किए गए सभी वीडियो, निजी मोड में देखने के लिए उपलब्ध होंगे. ये वीडियो, 28 जुलाई, 2020 के बाद बनाए गए, बिना पुष्टि वाले एपीआई प्रोजेक्ट से अपलोड किए गए होंगे. इस पाबंदी को हटाने के लिए, हर प्रोजेक्ट का ऑडिट होना ज़रूरी है. इससे यह पुष्टि की जा सकेगी कि प्रोजेक्ट, सेवा की शर्तों का पालन करता है.

बिना पुष्टि वाले एपीआई क्लाइंट का इस्तेमाल करके वीडियो अपलोड करने वाले क्रिएटर्स को एक ईमेल मिलेगा. इसमें बताया जाएगा कि उनके वीडियो को निजी के तौर पर लॉक कर दिया गया है. साथ ही, यह भी बताया जाएगा कि आधिकारिक या ऑडिट किए गए क्लाइंट का इस्तेमाल करके, वे इस पाबंदी से बच सकते हैं.

28 जुलाई, 2020 से पहले बनाए गए एपीआई प्रोजेक्ट पर, फ़िलहाल इस बदलाव का कोई असर नहीं पड़ा है. हालांकि, हमारा सुझाव है कि सभी डेवलपर अपने प्रोजेक्ट के लिए नीति के पालन से जुड़ी ऑडिट पूरी करें, ताकि उन्हें YouTube API की सेवाओं का ऐक्सेस मिलता रहे.

21 जुलाई, 2020

[28 जुलाई, 2020 को अपडेट किया गया.] इस बदलाव के इतिहास की एंट्री में जिस दस्तावेज़ के अपडेट का रेफ़रंस दिया गया है उसे 28 जुलाई, 2020 को फिर से पब्लिश किया गया था.

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

7 जुलाई, 2020

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

videos.insert तरीके के autoLevels और stabilize पैरामीटर अब काम नहीं करते. साथ ही, दोनों पैरामीटर को दस्तावेज़ से हटा दिया गया है. इनकी वैल्यू को अनदेखा कर दिया जाता है. साथ ही, इनका असर अपलोड किए गए नए वीडियो को प्रोसेस करने के तरीके पर नहीं पड़ता.

15 जून, 2020

YouTube डेवलपर के लिए बनी नीतियों का पालन करना नाम की नई गाइड में, आपको दि��ा-निर्देश और उदाहरण मिलेंगे. इनसे आपको यह पक्का करने में मदद मिलेगी कि आपके एपीआई क्लाइंट, YouTube API की सेवाओं की शर्तों और नीतियों (एपीआई टीओएस) के कुछ हिस्सों का पालन करते हों.

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

4 जून, 2020

ध्यान दें: यह सुविधा बंद होने के बारे में पहले दी गई सूचना का अपडेट है.

चैनल बुलेटिन की सुविधा अब पूरी तरह से बंद कर दी गई है. इस बदलाव के बारे में पहली बार 17 अप्रैल, 2020 को बताया गया था. अब यह बदलाव लागू हो गया है. इस वजह से, activities.insert तरीका अब काम नहीं करता. साथ ही, activities.list तरीके से अब चैनल के बुलेटिन नहीं दिखते. ज़्यादा जानकारी के लिए, कृपया YouTube का सहायता केंद्र देखें.

17 अप्रैल, 2020

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

YouTube, चैनल बुलेटिन की सुविधा बंद कर रहा है. इस वजह से, activities.insert तरीका काम नहीं करेगा. साथ ही, activities.list तरीके से चैनल के बुलेटिन नहीं मिलेंगे. ये बदलाव, एपीआई में 18 मई, 2020 को या उसके बाद लागू होंगे. ज़्यादा जानकारी के लिए, कृपया YouTube का सहायता केंद्र देखें.

31 मार्च, 2020

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

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

  • नया member संसाधन, YouTube चैनल के लिए पैसे चुकाकर बने सदस्य को दिखाता है. पैसे चुकाकर बने सदस्य, किसी क्रिएटर को बार-बार पैसे देकर सपोर्ट करते हैं. इसके बदले उन्हें खास फ़ायदे मिलते हैं. उदाहरण के लिए, जब कोई क्रिएटर चैट के लिए, पैसे चुकाकर बने सदस्यों के लिए उपलब्ध मोड चालू करता है, तब पैसे चुकाकर बने सदस्य चैट कर पाते हैं.

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

  • नए membershipsLevel संसाधन से, कीमत के उस लेवल की पहचान होती है जिसे एपीआई अनुरोध ��ी अनुमति देने वा��े ����रिएटर ��े मैनेज किया है. membershipsLevels.list मेथड, क्रिएटर के सभी सदस्यता लेवल की सूची वापस लाता है.

10 जनवरी, 2020

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

channel और video संसाधनों में दो नई प्रॉपर्टी जोड़ी गई हैं. इनसे कॉन्टेंट क्रिएटर्स और दर्शकों को यह पता लगाने में मदद मिलेगी कि कॉन्टेंट बच्चों के लिए बना है या नहीं:

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

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

10 सितंबर, 2019

एपीआई के रेफ़रंस दस्तावेज़ को अपडेट कर दिया गया है. इससे, YouTube पर और इसके बाद एपीआई के जवाबों में, सदस्यों की संख्या रिपोर्ट करने के तरीके में हुए बदलाव के बारे में पता चलता है. इस बदलाव की वजह से, YouTube Data API सर्विस से मिले सदस्यों की संख्या को तीन अंकों तक कम कर दिया जाता है. यह बदलाव, उन चैनलों के लिए किया जाता है जिनके सदस्यों की संख्या 1,000 से ज़्यादा है. इस बदलाव का असर channel संसाधन की statistics.subscriberCount प्रॉपर्टी पर पड़ेगा.

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

उदाहरण के लिए, अगर किसी चैनल के 123,456 सदस्य हैं, तो statistics.subscriberCount प्रॉपर्टी में 123000 वैल्यू होगी. यहां दी गई टेबल में, एपीआई से मिले रिस्पॉन्स में सदस्यों की संख्या को राउंड करने और YouTube के सार्वजनिक तौर पर दिखने वाले अन्य यूज़र इंटरफ़ेस में छोटा करके दिखाने के उदाहरण दिए गए हैं:

सदस्यों की संख्या का उदाहरण	YouTube डेटा एपीआई	YouTube के ऐसे यूज़र इंटरफ़ेस (यूआई) जो सार्वजनिक तौर पर दिखते हैं
1,234	1230	1.23 हज़ार
12,345	12300	12.3 हज़ार
123,456	123000	1.23 लाख
1,234,567	1230000	12.3 लाख
12,345,678	12300000	1.23 करोड़
123,456,789	123000000	12.3 करोड़

4 अप्रैल, 2019

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

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

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

  • इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताए गए तरीके के इस्तेमाल के एक या उससे ज़्यादा सामान्य उदाहरण दिए गए हैं. उदाहरण के लिए, किसी चैनल के बारे में डेटा पाने या मौजूदा उपयोगकर्ता के चैनल के बारे में डेटा पाने के लिए, channels.list तरीके का इस्तेमाल किया जा सकता है.

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

  फ़िलहाल, कोड के सैंपल Java, JavaScript, PHP, Python, और curl के लिए उपलब्ध हैं.

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

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

• Java, JavaScript, PHP, और Python के लिए क्विकस्टार्ट गाइड अपडेट कर दी गई हैं. संशोधित गाइड में बताया गया है कि APIs Explorer से कोड सैंपल का इस्तेमाल करके, एपीआई पासकोड के साथ एक सैंपल और OAuth 2.0 क्लाइंट आईडी के साथ दूसरा सैंपल कैसे चलाया जाए.

ध्यान दें कि ऊपर बताए गए बदलाव, 2017 में एपीआई के दस्तावेज़ में जोड़े गए इंटरैक��टिव टूल की जगह लेते हैं.

9 जुलाई, 2018

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

• channel संसाधन की snippet.thumbnails प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि आपके ऐप्लिकेशन में थंबनेल दिखाते समय, आपके कोड को इमेज के यूआरएल का इस्तेमाल ठीक उसी तरह करना चाहिए जिस तरह वे एपीआई रिस्पॉन्स में दिखाए जाते हैं. उदाहरण के लिए, एपीआई से मिले रिस्पॉन्स में दिखाए गए यूआरएल में, आपके ऐप्लिकेशन को http डोमेन के बजाय https डोमेन का इस्तेमाल नहीं करना चाहिए.

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

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

  video संसाधन की recordingDetails.location.altitude प्रॉपर्टी अब काम नहीं करती है. इस बात की कोई गारंटी नहीं है कि वीडियो के लिए, इस प्रॉपर्टी की वैल्यू मिलेंगी. इसी तरह, अगर एपीआई अनुरोधों के ज़रिए उस प्रॉपर्टी के लिए कोई वैल्यू सेट करने की कोशिश की जाती है, तो हो सकता है कि आने वाले डेटा को सेव न किया जाए.

22 जून, 2018

लागू करने से जुड़ी गाइड को अपडेट किया गया है. इसे पहले लागू करने और माइग्रेट करने से जुड़ी गाइड के नाम से जाना जाता था. इसमें v2 API से v3 API पर माइग्रेट करने के निर्देशों को हटा दिया गया है. इसके अलावा, उन सुविधाओं के लिए निर्देश भी हटा दिए गए हैं जिन्हें v3 API में बंद कर दिया गया है. जैसे, पसंदीदा वीडियो.

27 नवंबर, 2017

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

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

  YouTube, चुनिंदा वीडियो और चुनिंदा वेबसाइट सुविधाओं के लिए सहायता बंद कर रहा है. ये सुविधाएं, एपीआई में channel संसाधन के invideoPromotion ऑब्जेक्ट के ज़रिए काम करती हैं. इसलिए, उस ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी को बंद किया जा रहा है.

  हालांकि, 14 दिसंबर, 2017 तक invideoPromotion का डेटा वापस ��ाया जा सकता है और सेट किया जा सकता है. इस तारीख के बाद:

  • channels.list को कॉल करते समय, invideoPromotion वाले हिस्से को वापस पाने की कोशिश करने पर, खाली invideoPromotion मिलेगा या invideoPromotion का कोई भी डेटा नहीं मिलेगा.
  • invideoPromotion को कॉल करते समय channels.update डेटा को अपडेट करने की कोशिश करने पर, कम से कम 27 मई, 2018 तक आपको 'कार्रवाई पूरी हुई' वाला जवाब मिलेगा. हालांकि, इन्हें नो-ऑप्स के तौर पर माना जाएगा. इसका मतलब है कि ये अपडेट नहीं करेंगे.

  27 मई, 2018 के बाद, ऐसा हो सकता है कि इन अनुरोधों में गड़बड़ी के मैसेज दिखें. उदाहरण के लिए, यह बताया जा सकता है कि invalidPromotion अमान्य हिस्सा है.

16 नवंबर, 2017

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

• इंटरैक्टिव कोड स्निपेट टूल अब Node.js के कोड सैंपल के साथ काम करता है. ये सैंपल, एपीआई के लगभग सभी तरीकों के दस्तावेज़ में भी दिखते हैं. जैसे, channels.list तरीका.

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

  • removeEmptyParameters फ़ंक्शन, एपीआई अनुरोध पैरामीटर से जुड़े की-वैल्यू पेयर की सूची लेता है. साथ ही, उन पैरामीटर को हटा देता है जिनकी वैल्यू नहीं होती.
  • createResource फ़ंक्शन, एपीआई रिसॉर्स में मौजूद प्रॉपर्टी से जुड़े की-वैल्यू पेयर की सूची लेता है. इसके बाद, यह प्रॉपर���टी को JSON ऑब्जेक्ट में बदलता है. इसका इस्तेमाल insert और update कार्रवाइयों में किया जा सकता है. यहां दिए गए उदाहरण में, प्रॉपर्टी के नामों और वैल्यू का सेट दिखाया गया है. साथ ही, वह JSON ऑब्जेक्ट दिखाया गया है जिसे कोड इनके लिए बनाएगा:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  इन सभी सैंपल को डाउनलोड करके, स्थानीय तौर पर चलाया जा सकता है. ज़्यादा जानकारी के लिए, कोड स्निपेट टूल के निर्देशों में पूरे कोड सैंपल को स्थानीय तौर पर चलाने की ज़रूरी शर्तें देखें.

25 अक्टूबर, 2017

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

• इंटरैक्टिव कोड स्निपेट टूल में मौजूद Python कोड के सैंपल को अपडेट कर दिया गया है. अब इनमें oauth2client लाइब्रेरी के बजाय, google-auth और google-auth-oauthlib लाइब्रेरी का इस्तेमाल किया जाएगा. लाइब्रेरी अब काम नहीं करती.

  इस बदलाव के अलावा, अब यह टूल इंस्टॉल किए गए Python ऐप्लिकेशन और Python वेब सर्वर ऐप्लिकेशन के लिए, पूरे कोड सैंपल उपलब्ध कराता है. ये ऐप्लिकेशन, ऑथराइज़ेशन के थोड़े अलग फ़्लो का इस्तेमाल करते हैं. पूरे सैंपल (और इस बदलाव) को देखने के लिए:

  1. इंटरैक्टिव कोड स्निपेट टूल पर जाएं या किसी भी एपीआई तरीके के दस्तावेज़ पर जाएं. जैसे, channels.list तरीका.
  2. कोड के सैंपल के ऊपर मौजूद, Python टैब पर क्लिक करें.
  3. स्निपेट से पूरे सैंपल पर स्विच करने के लिए, टैब के ऊपर मौजूद टॉगल पर क्लिक करें.
     
  4. अब टैब में, InstalledAppFlow ऑथराइज़ेशन फ़्लो का इस्तेमाल करने वाला पूरा कोड सैंपल दिखेगा. सैंपल के ऊपर दी गई जानकारी में इसके बारे में बताया गया है. साथ ही, इसमें वेब सर्वर ऐप्लिकेशन के सैंपल का लिंक भी दिया गया है.
  5. वेब सर्वर के उदाहरण पर स्विच करने के लिए, लिंक पर क्लिक करें. उस सैंपल में, Flask वेब ऐप्लिकेशन फ़्रेमवर्क और ऑथराइज़ेशन के किसी दूसरे फ़्लो का इस्तेमाल किया गया है.

  इन सभी सैंपल को डाउनलोड करके, स्थानीय तौर पर चलाया जा सकता है. अगर आपको सैंपल चलाने हैं, तो कोड स्निपेट टूल के निर्देशों में, पूरे कोड सैंपल को स्थानीय तौर पर चलाने के निर्देश देखें.

29 अगस्त, 2017

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

• search.list तरीके के forContentOwner पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि अगर इस पैरामीटर को true पर सेट किया जाता है, तो type पैरामीटर को video पर सेट करना होगा.
• search.list तरीके के regionCode पैरामीटर की परिभाषा को अपडेट किया गया है. इससे यह साफ़ तौर पर पता चलता है कि पैरामीटर, खोज के नतीजों को उन वीडियो तक सीमित करता है जिन्हें बताई गई जगह पर देखा जा सकता है.
• YouTube ने अपने ब्रैंडिंग लोगो और आइकॉन अपडेट किए हैं. "developed with YouTube" वाले नए लोगो, ब्रैंडिंग के दिशा-निर्देशों वाले पेज से डाउनलोड किए जा सकते हैं. उस पेज पर, YouTube के अन्य नए लोगो और आइकॉन भी दिखाए गए हैं. इन्हें YouTube की ब्रैंड साइट से डाउनलोड किया जा सकता है.

24 जुलाई, 2017

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

• iOS के लिए, YouTube Data API की नई क्विकस्टार्ट गाइड उपलब्ध है. इस गाइड में, Objective-C या Swift में लिखे गए सामान्य iOS ऐप्लिकेशन में YouTube Data API का इस्तेमाल करने का तरीका बताया गया है.
• YouTube Data API के लिए उपलब्ध इंटरैक्टिव कोड स्निपेट टूल में अब एक दस्तावेज़ शामिल है. इसमें टूल की कुछ सुविधाओं के बारे में बताया गया है:
  • एपीआई अनुरोधों को पूरा करना
  • कोड स्निपेट और पूरे कोड सैंपल के बीच टॉगल करना
  • बॉयलरप्लेट फ़ंक्शन का इस्तेमाल करना
  • मौजूदा संसाधनों को लोड किया जा रहा है (अपडेट करने के तरीकों के लिए)

  ध्यान दें: यह टूल, एपीआई के तरीकों (उदाहरण) के लिए एपीआई के रेफ़रंस दस्तावेज़ में भी एम्बेड किया गया है.

1 जून, 2017

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

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

  video संसाधन की इन प्रॉपर्टी को बंद किया जा रहा है. इन प्रॉपर्टी का इस्तेमाल 1 दिसंबर, 2017 तक किया जा सकेगा. हालांकि, इस बात की कोई गारंटी नहीं है कि वीडियो से जुड़ी वैल्यू, इस तारीख तक इन प्रॉपर्टी के लिए उपलब्ध रहेंगी. इसी तरह, videos.insert और videos.update अनुरोधों के लिए, प्रॉपर्टी की वैल्यू सेट करने पर उस तारीख से पहले गड़बड़ियां नहीं दिखेंगी. हालांकि, ऐसा हो सकता है कि आने वाले डेटा को सेव न किया जाए.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 मई, 2017

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

• एपीआई के संदर्भ दस्तावेज़ को अपडेट किया गया है, ताकि कोड स्निपेट को ज़्यादा इंटरैक्टिव बनाया जा सके और उन्हें हर जगह इस्तेमाल किया जा सके. एपीआई के तरीकों के बारे में बताने वाले पेजों, जैसे कि channels.list या videos.rate पर अब एक इंटरैक्टिव टूल उपलब्ध है. इसकी मदद से, Java, JavaScript, PHP, Python, Ruby, Apps Script, और Go में कोड स्निपेट देखे जा सकते हैं और उन्हें पसंद के मुताबिक बनाया जा सकता है.

  किसी भी तरीके के लिए, यह टूल इस्तेमाल के एक या उससे ज़्यादा उदाहरणों के लिए कोड स्निपेट दिखाता है. साथ ही, हर उदाहरण में उस तरीके को कॉल करने का सामान्य तरीका बताया जाता है. उदाहरण के लिए, किसी चैनल या मौजूदा उपयोगकर्ता के चैनल के बारे में डेटा वापस पाने के लिए, channels.list तरीके का इस्तेमाल किया जा सकता है.

  कोड सैंपल के साथ इंटरैक्ट भी किया जा सकता है:

  • पैरामीटर और प्रॉपर्टी की वैल्यू में बदलाव करें. इसके बाद, कोड स्निपेट में डाइनैमिक तौर पर बदलाव हो जाएगा, ताकि आपकी दी गई वैल्यू दिखें.

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

  • किसी बटन पर क्लिक करके अनुरोध पूरे करना. (अनुरोधों को पूरा करने के लिए, आपको टूल को अपनी ओर से एपीआई को कॉल करने की अनुमति देनी होगी.)

  ध्यान दें कि इस टूल ने उन पेजों पर एपीआई एक्सप्लोरर की जगह ले ली है जहां यह उपलब्ध है. (हर पेज पर एक लिंक दिखता है, ताकि आपके पास APIs explorer में उस अनुरोध को लोड करने का विकल्प भी हो जिस पर काम ��िया जा रहा है.)

• Data API के कोड स्निपेट टूल को भी अपडेट किया गया है. इसमें नया यूज़र इंटरफ़ेस (यूआई) जोड़ा गया है. इसमें ऊपर बताई गई सभी सुविधाएं उपलब्ध हैं. इस पेज पर उपलब्ध मुख्य नई सुविधाएं ये हैं:

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

27 अप्रैल, 2017

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

• नई क्विकस्टार्ट गाइड में, एक ऐसा सामान्य ऐप्लिकेशन सेट अप करने का तरीका बताया गया है जो YouTube Data API के अनुरोध करता है. फ़िलहाल, गाइड Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python, और Ruby के लिए उपलब्ध हैं.

30 मार्च, 2017

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

• channel संसाधन की नई topicDetails.topicCategories[] प्रॉपर्टी में, Wikipedia के उन यूआरएल की सूची शामिल है जिन पर चैनल के कॉन्टेंट के बारे में जानकारी दी गई है. ये यूआरएल, संसाधन की topicDetails.topicIds[] प्रॉपर्टी में दिखाए गए विषय के आईडी से मेल खाते हैं.
• playlistItem संसाधन की नई contentDetails.videoPublishedAt प्रॉपर्टी से पता चलता है कि वीडियो को YouTube पर कब पब्लिश किया गया था. संसाधन में पहले से ही snippet.publishedAt प्रॉपर्टी मौजूद है. इससे पता चलता है कि आइटम को प्लेलिस्ट में कब जोड़ा गया था.
• channel संसाधन की तरह ही, video संसाधन अब topicDetails.topicCategories[] प्रॉपर्टी दिखाता है. इसमें Wikipedia के उन यूआरएल की सूची होती है जिनमें वीडियो के कॉन्टेंट के बारे में जानकारी दी गई होती है. video संसाधनों के लिए, यूआरएल उन विषय आईडी से मेल खाते हैं जो संसाधन की topicDetails.relevantTopicIds[] प्रॉपर्टी में दिखाए जाते हैं.
• video संसाधन की नई contentDetails.contentRating.mpaatRating प्रॉपर्टी, उस रेटिंग की पहचान करती है जो Motion Picture Association of America ने किसी फ़िल्म के ट्रेलर या झलक को दी है.

27 फ़रवरी, 2017

YouTube ने विषय के आईडी की सूची को, चुनी गई सूची में बदल दिया है. इस बारे में 11 अगस्त, 2016 को सूचना दी गई थी. इस्तेमाल किए जा सकने वाले विषय के आईडी की पूरी सूची, channel और video संसाधनों के लिए topicDetails प्रॉपर्टी में शामिल है. साथ ही, यह search.list तरीके के topicId पैरामीटर में भी शामिल है.

ध्यान दें कि चुनी गई सूची में कई बदलाव किए गए हैं:

• इन विषयों को Society के सब-टॉपिक के तौर पर जोड़ा गया है:

  नाम	विषय का आईडी
  कारोबार	/m/09s1f
  स्वास्थ्य	/m/0kt51
  सेना	/m/01h6rj
  राजनीति	/m/05qt0
  धर्म	/m/06bvp

• Animated cartoon विषय को हटा दिया गया है. यह पहले Entertainment का चाइल्ड विषय था.
• Children's music विषय को हटा दिया गया है. यह पहले Music का चाइल्ड विषय था.

इस बदलाव के बाद, वीडियो से जुड़े विषयों को अब हमेशा video संसाधन की topicDetails.relevantTopicIds[] प्रॉपर्टी वैल्यू में दिखाया जाता है.

29 नवंबर, 2016

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

• विषय के आईडी की सूची में तीन छोटे बदलाव किए गए हैं. ये बदलाव 10 फ़रवरी, 2017 से लागू होंगे:

  • Professional wrestling कैटगरी, पहले Sports कैटगरी के तहत आती थी. अब यह Entertainment कैटगरी के तहत आती है.
  • TV shows कैटगरी नई है. यह Entertainment की चाइल्ड कैटगरी है.
  • Health कैटगरी को हटा दिया गया है. यह पहले Lifestyle की चाइल्ड कैटगरी थी.

  यह भी ध्यान दें कि कुछ पैरंट कैटगरी (Entertainment, Gaming, Lifestyle, Music, और Sports) होती हैं. Tennis जैसी किसी चाइल्ड कैटगरी से जुड़ा कोई भी वीडियो, पैरंट कैटगरी (Sports) से भी जुड़ा होगा.

10 नवंबर, 2016

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

• हमने 11 अगस्त, 2016 को पहली बार एलान किया था कि Freebase और Freebase API को बंद किया जा रहा है. इसलिए, विषय के आईडी से जुड़े कई बदलाव करने होंगे. टॉपिक आईडी, channel और video संसाधनों से जुड़े विषयों की पहचान करते हैं. साथ ही, किसी विषय से जुड़े चैनल या वीडियो ढूंढने के लिए, topicId सर्च पैरामीटर का इस्तेमाल किया जा सकता है.

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

  इसलिए, हम यहां दिए गए एपीआई पैरामीटर और प्रॉपर्टी की परिभाषाओं को अपडेट कर रहे हैं, ताकि आप अपने एपीआई क्लाइंट को इन बदलावों के लिए तैयार कर सकें. इन परिभाषाओं में, उन विषय आईडी की सूची दी गई है जिन्हें इस समय के बाद इस्तेमाल किया जा सकेगा. ध्यान दें कि कैटगरी की सूची, सभी प्रॉपर्टी के लिए एक जैसी होती है.

  • channel संसाधन की topicDetails.topicIds[] प्रॉपर्टी.
  • video संसाधन की topicDetails.relevantTopicIds[] प्रॉपर्टी.
  • search.list तरीके का topicId पैरामीटर.

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

  इन प्रॉपर्टी को बंद किया जा रहा है:

  • channel संसाधन की topicDetails.topicIds[] प्रॉपर्टी. इस प्रॉपर्टी के लिए, 10 नवंबर, 2017 तक सहायता उ��लब्ध रहेगी.
  • video संसाधन की topicDetails.relevantTopicIds[] प्रॉपर्टी. इस प्रॉपर्टी के लिए, 10 नवंबर, 2017 तक सहायता उपलब्ध रहेगी.
  • video संसाधन की topicDetails.topicIds[] प्रॉपर्टी. इस प्रॉपर्टी में 10 फ़रवरी, 2017 के बाद की वैल्यू नहीं होंगी. (इस तारीख के बाद, topicDetails.relevantTopicIds[] प्रॉपर्टी की वैल्यू से, वीडियो से जुड़े सभी विषयों की पहचान की जा सकेगी.)

• Freebase के इस्तेमाल पर पहले ही रोक लगा दी गई है. इसलिए, Freebase के विषयों की मदद से खोजना गाइड को दस्तावेज़ से हटा दिया गया है. उस गाइड में, कोड के सैंपल दिए गए थे. इनसे यह पता चलता था कि कोई ऐप्लिकेशन, Freebase API के साथ कैसे काम करेगा.

  इसके अलावा, विषय आईडी से जुड़े कई कोड सैंपल, search.list तरीके के दस्तावेज़ से हटा दिए गए हैं.

2 नवंबर, 2016

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

• नई प्रॉपर्टी और पैरामीटर

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

    • player.embedHtml प्रॉपर्टी में एक <iframe> टैग होता है. इसका इस्तेमाल करके, वीडियो चलाने वाले प्लेयर को एम्बेड किया जा सकता है. नई player.embedHeight और player.embedWidth प्रॉपर्टी, एम्बेड किए गए प्लेयर के डाइमेंशन की पहचान करती हैं. ये प्रॉपर्टी सिर्फ़ तब दिखती हैं, जब एपीआई अनुरोध में maxHeight या maxWidth पैरामीटर में से किसी एक के लिए वैल्यू दी गई हो. इन दो नए पैरामीटर के बारे में, इस बदलाव के इतिहास की एंट्री में बाद में बताया गया है.

    • नई hasCustomThumbnail प्रॉपर्टी से पता चलता है कि वीडियो अपलोड करने वाले व्यक्ति ने वीडियो के लिए कस्टम थंबनेल इमेज दी है या नहीं. ध्यान दें कि यह प्रॉपर्टी, सिर्फ़ वीडियो अपलोड करने वाले व्यक्ति को दिखती है.

    • नए fpbRatingReasons[] से पता चलता है कि वीडियो को FPB (दक्षिण अफ़्रीका) रेटिंग क्यों मिली.

    • नई mcstRating से पता चलता है कि वियतनाम में वीडियो को कौनसी रेटिंग मिली है.

  • videos.list तरीके में दो नए पैरामीटर, maxHeight और maxWidth इस्तेमाल किए जा सकते हैं. video रिसॉर्स में player वाला हिस्सा वापस पाने के लिए, इनमें से किसी एक या दोनों पैरामीटर का इस्तेमाल किया जा सकता है.

    डिफ़ॉल्ट रूप से, player.embedHtml प्रॉपर्टी में दिखाई गई <iframe> की ऊंचाई 360 पिक्सल होती है. चौड़ाई को वीडियो के आसपेक्ट रेशियो के हिसाब से अडजस्ट किया जाता है. इससे यह पक्का होता है कि एम्बेड किए गए प्लेयर में, वीडियो के चारों ओर काली पट्टियां न दिखें. इसलिए, उदाहरण के लिए, अगर किसी वीडियो का आसपेक्ट रेशियो 16:9 है, तो प्लेयर की चौड़ाई 640 पिक्सल होगी.

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

    उदाहरण के लिए, मान लें कि किसी वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 है. इसलिए, अगर maxHeight या maxWidth पैरामीटर सेट नहीं किया गया है, तो player.embedHtml टैग में 640x360 प्लेयर शामिल होगा.

    • अगर maxHeight पैरामीटर को 720 पर सेट किया जाता है और maxWidth पैरामीटर को सेट नहीं किया जाता है, तो एपीआई 1280x720 प्लेयर दिखाएगा.
    • अगर maxWidth पैरामीटर को 960 पर सेट किया गया है और maxHeight पैरामीटर को सेट नहीं किया गया है, तो एपीआई 960x540 वाला प्लेयर दिखाएगा.
    • अगर maxWidth पैरामीटर को 960 पर सेट किया गया है और maxHeight पैरामीटर को 450 पर सेट किया गया है, तो एपीआई 800x450 प्लेयर दिखाएगा.

    ऊपर बताई गई नई player.embedHeight और player.embedWidth प्रॉपर्टी, प्लेयर के डाइमेंशन की पहचान करती हैं.

• मौजूदा तरीकों, प्रॉपर्टी, और पैरामीटर में हुए अपडेट

  • channelSection संसाधन के ब्यौरे को अपडेट किया गया है. इसमें बताया गया है कि कोई चैनल, टारगेटिंग डेटा सेट किए बिना ज़्यादा से ज़्यादा 10 शेल्फ़ बना सकता है. साथ ही, टारगेटिंग डेटा के साथ ज़्यादा से ज़्यादा 100 शेल्फ़ बना सकता है.

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

  • i18nLanguage संसाधन की snippet.name प्रॉपर्टी की परिभाषा को ठीक किया गया है. इससे पता चलता है कि वैल्यू, भाषा के नाम को दिखाती है. यह नाम, i18nLanguage.list तरीके के hl पैरामीटर में बताई गई भाषा में लिखा जाता है.

  • playlistItem संसाधन की contentDetails.note प्रॉपर्टी को अपडेट कर दिया गया है. इससे पता चलता है कि प्रॉपर्टी वैल्यू में ज़्यादा से ज़्यादा 280 वर्ण हो सकते हैं.

  • playlistItem संसाधन की contentDetails.startAt और contentDetails.endAt प्रॉपर्टी अब काम नहीं करती हैं. अगर इन फ़ील्ड को playlistItems.insert या playlistItems.update अनुरोधों में सेट किया जाता है, तो इन्हें अनदेखा कर दिया जाता है.

  • playlistItems.delete और playlistItems.update तरीके अब onBehalfOfContentOwner पैरामीटर के साथ काम करते हैं. यह पैरामीटर, पहले से ही कई अन्य तरीकों के साथ काम करता है. इस तरीके का इस्तेमाल करने वाले अनुरोधों को भी ऐसे टोकन से अनुमति दी जानी चाहिए जो https://www.googleapis.com/auth/youtubepartner स्कोप का ऐक्सेस देता हो.

  • search.list मेथड के publishedBefore और publishedAfter पैरामीटर, दोनों को अपडेट कर दिया गया है. इससे पता चलता है कि पैरामीटर वैल्यू में शामिल हैं. इसलिए, उदाहरण के लिए, अगर publishedBefore पैरामीटर सेट किया गया है, तो एपीआई, तय किए गए समय से पहले या उस समय बनाए गए संसाधन दिखाता है.

  • video संसाधन की contentDetails.contentRating.grfilmRating प्रॉपर्टी के लिए, तीन और वैल्यू इस्तेमाल की जा सकती हैं: grfilmK12, grfilmK15, और grfilmK18.

  • videos.insert तरीके के ब्यौरे को अपडेट किया गया है. इसमें बताया गया है कि अपलोड किए गए वीडियो के लिए, फ़ाइल का ज़्यादा से ज़्यादा साइज़ 64 जीबी से बढ़कर 128 जीबी हो गया है.

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

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

    गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
    forbidden (403)	homeParameterDeprecated	activities.list तरीके से यह गड़बड़ी तब दिखती है, जब इस एपीआई के ज़रिए उपयोगकर्ता के होम पेज की गतिविधि से जुड़ा डेटा उपलब्ध नहीं होता. अगर आपने बिना अनुमति वाले अनुरोध में home पैरामीटर को true पर सेट किया है, तो यह गड़बड़ी हो सकती है.
    invalidValue (400)	invalidContentDetails	playlistItems.insert तरीका यह गड़बड़ी तब दिखाता है, जब अनुरोध में मौजूद contentDetails ऑब्जेक्ट अमान्य होता है. यह गड़बड़ी इसलिए होती है, क्योंकि contentDetails.note फ़ील्ड में 280 से ज़्यादा वर्ण होते हैं.
    forbidden (403)	watchHistoryNotAccessible	playlistItems.list मेथड, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि अनुरोध में "देखने का इतिहास" प्लेलिस्ट के आइटम वापस पाने की कोशिश की गई थी. हालांकि, एपीआई का इस्तेमाल करके उन्हें वापस नहीं पाया जा सकता.
    forbidden (403)	watchLaterNotAccessible	playlistItems.list तरीके से यह गड़बड़ी तब दिखती है, जब अनुरोध में "बाद में देखें" प्लेलिस्ट के आइटम वापस पाने की कोशिश की गई हो. हालांकि, एपीआई का इस्तेमाल करके इन आइटम को वापस नहीं पाया जा सकता.
    badRequest (400)	uploadLimitExceeded	videos.insert वाला तरीका यह गड़बड़ी तब दिखाता है, जब चैनल ने वीडियो अ��लोड करने की तय सीमा पार कर ली हो.
    forbidden (403)	forbiddenEmbedSetting	videos.update तरीके ��े यह गड़बड़ी तब दिखती है, जब एपीआई अनुरोध वीडियो के लिए अमान्य एम्बेड सेटिंग सेट करने की कोशिश करता है. ध्यान दें कि कुछ चैनलों के पास, लाइव स्ट्रीम के लिए एम्बेड किए गए प्लेयर की सुविधा देने की अनुमति नहीं हो सकती है. ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं.

  • अगर किसी प्लेलिस्ट में डुप्लीकेट वीडियो डाला जाता है, तो playlistItems.insert तरीके से अब गड़बड़ी का मैसेज नहीं मिलता है. पहले यह गड़बड़ी कुछ ऐसी प्लेलिस्ट के लिए होती थी जिनमें डुप्लीकेट वीडियो शामिल नहीं किए जा सकते थे. जैसे, पसंदीदा वीडियो. हालांकि, अब यह सुविधा काम नहीं करती. आम तौर पर, प्लेलिस्ट में डुप्लीकेट वीडियो इस्तेमाल किए जा सकते हैं.

• अन्य अपडेट

  • 15 सितंबर, 2016 के लिए बदलावों का इतिहास की एंट्री को अपडेट किया गया है. इसमें यह साफ़ तौर पर बताया गया है कि जब भी किसी रिस्पॉन्स में channel संसाधन की contentDetails.relatedPlaylists.watchHistory और contentDetails.relatedPlaylists.watchLater प्रॉपर्टी शामिल की जाती हैं, तो उनमें हमेशा HL और WL वैल्यू होती हैं. इसके अलावा, इन प्रॉपर्टी को सिर्फ़ तब शामिल किया जाता है, जब अनुमति पा चुका कोई उपयोगकर्ता, चैनल के मालिक के चैनल का डेटा वापस पा रहा हो.

15 सितंबर, 2016

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

• 11 अगस्त, 2016 को, बदलाव के इतिहास से जुड़े अपडेट में विषय के आईडी से जुड़े कई बदलावों के बारे में बताया गया था. इसमें यह भी बताया गया था कि 10 फ़रवरी, 2017 से विषय के आईडी का सेट बदल जाएगा. इस्तेमाल किए जा सकने वाले विषयों की सूची, 10 नवंबर, 2016 तक पब्लिश कर दी जाएगी.

• ये बदलाव अब लागू हो गए हैं. इन बदलावों के बारे में, 11 अगस्त, 2016 को बदलावों के इतिहास के अपडेट में सूचना दी गई थी:

  • अगर home पैरामीटर को true पर सेट करके activities.list तरीके को कॉल किया जाता है, तो एपीआई के जवाब में अब ऐसे आइटम शामिल होते हैं जो लॉग आउट किए गए YouTube उपयोगकर्ता को होम पेज पर दिखते हैं.

    यह एक ��ोटा सा बदलाव है. इसका मकसद, उपयोगकर्ताओं को बेहतर अनुभव देना है. यह अनुभव, 11 अगस्त, 2016 को अपडेट की गई बदलाव के इतिहास में बताए गए अनुभव से बेहतर होगा. उस अपडेट में बताया गया था कि home पैरामीटर का इस्तेमाल करके किए गए अनुरोधों के लिए, खाली सूची दिखाई जाएगी.

  • channel संसाधन की contentDetails.relatedPlaylists.watchHistory और contentDetails.relatedPlaylists.watchLater प्रॉपर्टी में अब सभी चैनलों के लिए, HL और WL की वैल्यू शामिल हैं.

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

    इसके अलावा, किसी चैनल के वीडियो देखने के इतिहास या 'बाद में देखें' प्लेलिस्ट के लिए, प्लेलिस्ट की जानकारी (playlists.list) या प्लेलिस्ट आइटम (playlistItems.list) को वापस पाने के अनुरोधों के जवाब में अब खाली सूचियां दिखेंगी. यह तरीका नई वैल्यू, HL और WL के साथ-साथ, देखने के इतिहास या 'बाद में देखें' प्लेलिस्ट के उन आईडी पर भी लागू होता है जिन्हें आपके एपीआई क्लाइंट ने पहले से सेव किया हुआ है.

• video संसाधन का fileDetails.recordingLocation ऑब्जेक्ट और उसकी चाइल्ड प्रॉपर्टी अब नहीं दिखेंगी. पहले, इस डेटा (जैसे कि पैरंट fileDetails ऑब्जेक्ट) को सिर्फ़ वीडियो का मालिक वापस ला सकता था.

11 अगस्त, 2016

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

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

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

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

  • channel संसाधन का topicDetails हिस्सा, चैनल से जुड़े विषयों की पहचान करता है.
  • video संसाधन का topicDetails हिस्सा, वीडियो से जुड़े विषयों की पहचान करता है.
  • search.list तरीके के topicId पैरामीटर की मदद से, किसी विषय से जुड़े वीडियो या चैनल खोजे जा सकते हैं.

  इन सुविधाओं में किए गए बदलाव ये हैं:

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

  • आपने पहले से ही जो Freebase विषय आईडी पाए हैं उनका इस्तेमाल, 10 फ़रवरी, 2017 तक कॉन्टेंट खोजने के लिए किया जा सकता है. हालांकि, इसके बाद विषय के हिसाब से खोज के नतीजे पाने के लिए, आपको पिछले आइटम में पहचाने गए विषयों के छोटे सेट का ही इस्तेमाल करना होगा.

  • अगर 10 फ़रवरी, 2017 के बाद, ऐसे विषय के आईडी का इस्तेमाल करके नतीजे खोजे जाते हैं जो विषय के आईडी के छोटे सेट में शामिल नहीं है, तो एपीआई नतीजों का खाली सेट दिखाएगा.

• एपीआई के कई फ़ील्ड और पैरामीटर का इस्तेमाल, 12 सितंबर, 2016 से नहीं किया जा सकेगा:

  • activities.list तरीके के home पैरामीटर की मदद से, अनुमति पा चुका उपयोगकर्ता उस गतिविधि ��़ीड को वापस पा सकता था जो YouTube के होम पेज पर दिखता था. इस पैरामीटर का इस्तेमाल करके 12 सितंबर, 2016 के बाद किए गए अनुरोधों से, खाली सूची मिलेगी.

  • channel संसाधन की contentDetails.relatedPlaylists.watchHistory और contentDetails.relatedPlaylists.watchLater प्रॉपर्टी सिर्फ़ उस उपयोगकर्ता को दिखती हैं जिसे अपने चैनल का डेटा वापस पाने की अनुमति मिली है. 12 सितंबर, 2016 के बाद, सभी चैनलों के लिए contentDetails.relatedPlaylists.watchHistory की वैल्यू HL होगी और contentDetails.relatedPlaylists.watchLater प्रॉपर्टी की वैल्यू WL होगी.

    किसी चैनल के वीडियो देखने के इतिहास या 'बाद में देखें' प्लेलिस्ट के लिए, प्लेलिस्ट की जानकारी (playlists.list) पाने के अनुरोधों के जवाब में, 12 सितंबर, 2016 के बाद से खाली सूची दिखेगी. इसके बाद, उन प्लेलिस्ट में मौजूद आइटम (playlistItems.list) को वापस पाने के अनुरोधों के जवाब में भी खाली सूची दिखेगी. यह नई वैल्यू, HL और WL के साथ-साथ, देखने के इतिहास या 'बाद में देखें' प्लेलिस्ट के उन आईडी पर भी लागू होता है जिन्हें आपके एपीआई क्लाइंट ने पहले से सेव किया हुआ है.

  • video संसाधन का fileDetails.recordingLocation ऑब्जेक्ट या इसकी कोई भी चाइल्ड प्रॉपर्टी, 12 सितंबर, 2016 के बाद नहीं दिखाई जाएगी. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस पा सकता है, क्योंकि पैरंट fileDetails ऑब्जेक्ट को सिर्फ़ वीडियो का मालिक ही वापस पा सकता है.

13 जून, 2016

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

• channel संसाधन की contentDetails.googlePlusUserId प्रॉपर्टी अब काम नहीं करती है. पहले, यह प्रॉपर्टी सिर्फ़ तब मौजूद होती थी, जब चैनल किसी Google+ प्रोफ़ाइल से जुड़ा होता था. बंद होने के बाद, इस प्रॉपर्टी को किसी भी channel संसाधन ��ें शामिल नहीं ��ि��ा ����एग���.

• comment संसाधन की snippet.authorGoogleplusProfileUrl प्रॉपर्टी अब काम नहीं करती है. पहले, यह प्रॉपर्टी सिर्फ़ तब मौजूद होती थी, जब चैनल किसी Google+ प्रोफ़ाइल से जुड़ा होता था. बंद होने के बाद, इस प्रॉपर्टी को किसी भी comment संसाधन में शामिल नहीं किया जाएगा.

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

31 मई, 2016

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

• subscriptions.list तरीके का नया myRecentSubscribers पैरामीटर, पुष्टि किए गए उपयोगकर्ता के चैनल की सदस्यता लेने वाले लोगों की सूची को उस क्रम में दिखाता है जिस क्रम में उन्होंने चैनल की सदस्यता ली थी.

  ध्यान दें कि नया पैरामीटर, सिर्फ़ पुष्टि किए गए उपयोगकर्ता के चैनल की सदस्यता लेने वाले हाल ही के 1,000 सदस्यों की जानकारी पाने की सुविधा देता है. सदस्यों की पूरी सूची पाने के लिए, mySubscribers पैरामीटर का इस्तेमाल करें. इस पैरामीटर से, सदस्यों की जानकारी किसी खास क्रम में नहीं मिलती है. हालांकि, इससे सदस्यों की संख्या सीमित नहीं होती है.

• snippet.thumbnails.(key) प्रॉपर्टी की परिभाषा को activity, playlistItem, playlist, search result, thumbnail, और video संसाधनों के लिए अपडेट किया गया है. इससे यह पता चलता है कि कुछ वीडियो के लिए, थंबनेल इमेज के अतिरिक्त साइज़ उपलब्ध हैं.

  • standard इमेज की चौड़ाई 640 पिक्सल और लंबाई 480 पिक्सल है.
  • maxres इमेज की चौड़ाई 1280 पिक्सल और लंबाई 720 पिक्सल है.

• channelSection.list तरीके के part पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि targeting हिस्से को 2 कोटा यूनिट की कीमत पर वापस पाया जा सकता है.

• अब videos.list तरीके से, video संसाधन के fileDetails, processingDetails या suggestions हिस्सों क�� वापस पाने की कोशिश करने वाले ऐसे ������������ ��र forbidden (403) गड़बड़ी दिखती है जिसे सही तरीके से अनुमति नहीं दी गई है. ये हिस्से सिर्फ़ वीडियो के मालिक के लिए उपलब्ध होते हैं.

17 मई, 2016

Data API के कोड स्निपेट टूल में, YouTube Data API के सामान्य इस्तेमाल के उदाहरणों के लिए छोटे कोड स्निपेट दिए गए हैं. फ़िलहाल, कोड स्निपेट की सुविधा, Apps Script, Go, JavaScript, PHP, Python, और Ruby में सिर्फ़ पढ़ने के लिए उपलब्ध सभी एपीआई तरीकों के लिए उपलब्ध है.

हर तरीके के लिए, टूल एक या उससे ज़्यादा इस्तेमाल के उदाहरणों के लिए कोड सैंपल दिखाता है. उदाहरण के लिए, यह search.list तरीके के लिए पांच कोड स्निपेट देता है:

• कीवर्ड के हिसाब से वीडियो की सूची
• जगह के हिसाब से वीडियो की सूची
• लाइव इवेंट की सूची बनाना
• भरोसेमंद व्यक्ति के वीडियो खोजना
• मिलते-जुलते वीडियो की सूची बनाओ

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

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

28 अप्रैल, 2016

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

• video संसाधन की नई contentDetails.projection प्रॉपर्टी, वीडियो के प्रोजेक्शन फ़ॉर्मैट के बारे में बताती है. प्रॉपर्टी की मान्य वैल्यू 360 और rectangular हैं.

• video संसाधन की recordingDetails.location और fileDetails.recordingLocation प्रॉपर्टी, दोनों को ��पडेट किया गया है. इससे दोनों प्रॉपर्टी के बीच के अंतर को समझने में मदद मिलेगी:

  • recordingDetails.location प्रॉपर्टी से उस जगह की पहचान होती है जिसे वीडियो का मालिक, वीडियो से जोड़ना चाहता है. इस जगह की जानकारी में बदलाव किया जा सकता है. साथ ही, इसे सार्वजनिक वीडियो पर खोजा जा सकता है. यह जानकारी, सार्वजनिक वीडियो के लिए लोगों को दिख सकती है.
  • fileDetails.recordingLocation प्रॉपर्टी की वैल्यू में बदलाव नहीं किया जा सकता. यह अपलोड की गई ओरिजनल वीडियो फ़ाइल से जुड़ी जगह की जानकारी दिखाती है. यह वैल्यू सिर्फ़ वीडियो के मालिक को दिखती है.

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

• ineligibleAccount गड़बड़ी की परिभाषा को अपडेट किया गया है. यह गड़बड़ी, comments.insert, comments.update, commentThreads.insert या commentThreads.update तरीके से वापस आ सकती है. अपडेट की गई परिभाषा में बताया गया है कि यह गड़बड़ी तब होती है, जब एपीआई अनुरोध को अनुमति देने के लिए इस्तेमाल किया गया YouTube खाता, उपयोगकर्ता के Google खाते के साथ मर्ज नहीं किया गया हो.

20 अप्रैल, 2016

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

• channels.update तरीके के part पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि localizations भी उस पैरामीटर के लिए मान्य वैल्यू है.

• शुरू करने से जुड़ी गाइड के कोटा का इस्तेमाल सेक्शन को अपडेट किया गया है. इसमें Google Developers Console का लिंक जोड़ा गया है. यहां आपको अपना मौजूदा कोटा और उसके इस्तेमाल की जानकारी दिखेगी.

16 मार्च, 2016

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

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

  • channelBanner संसाधन के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि अपलोड की गई चैनल के बैनर की इमेज के लिए सुझाया गया साइज़ 2560 पिक्सल x 1440 पिक्सल है. कम से कम साइज़ (2048 पिक्सल x 1152 पिक्सल) में कोई बदलाव नहीं हुआ है.

  • channel संसाधन की नई snippet.customUrl प्रॉपर्टी, चैनल से जुड़े कस्टम यूआरएल की पहचान करती है. (सभी चैनलों के पास कस्टम यूआरएल नहीं होते.) YouTube सहायता केंद्र में, कस्टम यूआरएल पाने की ज़रूरी शर्तों के बारे में बताया गया है. साथ ही, यूआरएल सेट अप करने का तरीका भी बताया गया है.

  • channel संसाधन का brandingSettings.watch ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी अब काम नहीं करती हैं.

  • search.list अनुरोध के लिए एपीआई से मिले जवाब में अब regionCode प्रॉपर्टी शामिल है. यह प्रॉपर्टी, खोज क्वेरी के लिए इस्तेमाल किए गए क्षेत्र के कोड की पहचान करती है. रीजन कोड, एपीआई को यह निर्देश देता है कि वह खोज के नतीजे, चुने गए देश के हिसाब से दिखाए.

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

  • videoAbuseReportReason संसाधन की snippet.label और snippet.secondaryReasons[].label प्रॉपर्टी की परिभाषाओं को अपडेट किया गया है. इससे पता चलता है कि इन प्रॉपर्टी में, गलत इस्तेमाल की शिकायत करने की वजहों के लिए स्थानीय भाषा में लेबल वाला टेक्स्ट शामिल होता है.

    इसके अलावा, videoAbuseReportReasons.list तरीके ��ें अब hl पैरामीटर काम करता है. यह पैरामीटर उस भाषा के बारे में बताता है जिसका इस्तेमाल एपीआई से मिले जवाब में लेबल के टेक्स्ट के लिए किया जाना चाहिए. पैरामीटर की डिफ़ॉल्ट वैल्यू en_US है.

  • video संसाधन की नई contentDetails.contentRating.ecbmctRating प्रॉपर्टी, तुर्किये के संस्कृति और पर्यटन मंत्रालय के मूल्यांकन और वर्गीकरण बोर्ड से मिली वीडियो की रेटिंग की पहचान करती है.

    इसके अलावा, रेटिंग के अन्य सिस्टम के लिए एपीआई प्रॉपर्टी, इन नई प्रॉपर्टी वैल्यू के साथ काम करती हैं:

    • contentDetails.contentRating.fpbRating (दक्षिण अफ़्रीका)
      रेटिंग: 10; प्रॉपर्टी की वैल्यू: fpb10
    • contentDetails.contentRating.moctwRating (ताइवान)
      रेटिंग: R-12; प्रॉपर्टी की वैल्यू: moctwR12
    • contentDetails.contentRating.moctwRating (ताइवान)
      रेटिंग: R-15; प्रॉपर्टी की वैल्यू: moctwR15

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

  • video संसाधन की status.rejectionReason प्रॉपर्टी, नई प्रॉपर्टी वैल्यू legal के साथ काम करती है.

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

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest (400)	notEditable	channelSections.insert, channelSections.update, और channelSections.delete तरीके, यह गड़बड़ी तब दिखाते हैं, जब बताए गए चैनल सेक्शन को बनाया, अपडेट किया या मिटाया नहीं जा सकता.
  badRequest (400)	styleRequired	channelSections.insert और channelSections.update तरीके, यह गड़बड़ी तब दिखाते हैं, जब एपीआई अनुरोध में सबमिट किए गए channelSection रिसॉर्स के लिए, snippet.style प्रॉपर्टी की वैल्यू तय नहीं की गई हो.
  badRequest (400)	typeRequired	channelSections.insert और channelSections.update तरीके, यह गड़बड़ी तब दिखाते हैं, जब एपीआई अनुरोध में सबमिट किए गए channelSection रिसॉर्स के लिए, snippet.type प्रॉपर्टी की वैल्यू तय नहीं की गई हो.
  badRequest (400)	processingFailure	commentThreads.list तरीके से यह गड़बड़ी तब दिखती है, जब एपीआई सर्वर अनुरोध को प्रोसेस नहीं कर पाता. यह एक अस्थायी गड़बड़ी हो सकती है. हालांकि, आम तौर पर इसका मतलब यह होता है कि अनुरोध में दिया गया इनपुट अमान्य है. अनुरोध के मुख्य हिस्से में मौजूद commentThread संसाधन के स्ट्रक्चर की जांच करें, ताकि यह पक्का किया जा सके कि यह मान्य है.
  forbidden (403)	commentsDisabled	commentThreads.list वाला तरीका यह गड़बड़ी दिखाता है. इससे पता चलता है कि videoId पैरामीटर से पहचाने गए वीडियो पर टिप्पणियां करने की सुविधा बंद है.
  badRequest (400)	commentTextTooLong	commentThreads.insert तरीके से यह गड़बड़ी तब दिखती है, जब comment संसाधन में snippet.topLevelComment.snippet.textOriginal प्रॉपर्टी के लिए बहुत ज़्यादा वर्ण इस्तेमाल किए गए हों.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	playlistItems.insert तरीके से यह गड़बड़ी तब दिखती है, जब प्लेलिस्ट में जोड़ा जाने वाला वीडियो पहले से किसी दूसरी सीरीज़ प्लेलिस्ट में मौजूद हो. सीरीज़ प्लेलिस्ट के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
  badRequest (400)	subscriptionForbidden	subscriptions.insert तरीके से यह गड़बड़ी तब दिखती है, जब आपने तय सीमा तक सदस्यताएं ले ली हों या आपने हाल ही में बहुत सारी सदस्यताएं ली हों. दूसरे मामले में, कुछ घंटों बाद अनुरोध को फिर से भेजा जा सकता है.
  badRequest (400)	invalidCategoryId	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपलोड किए गए video संसाधन में मौजूद snippet.categoryId प्रॉपर्टी में, अमान्य कैटगरी आईडी दिया गया हो. videoCategories.list तरीके का इस्तेमाल करके, स्वीकार की गई कैटगरी वापस पाएं.
  badRequest (400)	invalidDescription	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपलोड किए गए video रिसॉर्स में मौजूद snippet.description प्रॉपर्टी के लिए अमान्य वैल्यू दी गई हो.
  badRequest (400)	invalidPublishAt	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपलोड किए गए video संसाधन में मौजूद status.publishAt प्रॉपर्टी में, पब्लिश करने का अमान्य समय दिया गया हो.
  badRequest (400)	invalidRecordingDetails	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपलोड की गई video संसाधन में मौजूद recordingDetails ऑब्जेक्ट में रिकॉर्डिंग की अमान्य जानकारी दी ��ई हो.
  badRequest (400)	invalidTags	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपलोड किए गए video रिसॉर्स में मौजूद snippet.tags प्रॉपर्टी के लिए अमान्य वैल्यू दी गई हो.
  badRequest (400)	invalidTitle	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपलोड किए गए video संसाधन में मौजूद snippet.title प्रॉपर्टी में, वीडियो का अमान्य या खाली टाइटल दिया गया हो.
  badRequest (400)	invalidVideoMetadata	videos.update वाला तरीका यह गड़बड़ी दिखाता है. इससे पता चलता है कि अनुरोध का मेटाडेटा अमान्य है. यह गड़बड़ी तब होती है, जब अनुरोध में video संसाधन के snippet हिस्से को अपडेट किया जाता है, लेकिन snippet.title और snippet.categoryId, दोनों प्रॉपर्टी के लिए वैल्यू सेट नहीं की जाती है.

18 दिसंबर, 2015

यूरोपियन यूनियन (ईयू) के कानूनों के मुताबिक, ईयू में रहने वाले असली उपयोगकर्ताओं को कुछ जानकारी देना और उनसे सहमति लेना ज़रूरी है. इसलिए, यूरोपीय संघ में रहने वाले असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने इस ज़रूरी शर्त के बारे में सूचना, YouTube API की सेवा की शर्तों में जोड़ दी है.

19 नवंबर, 2015

एपीआई अब playlist और video संसाधनों की snippet.title और snippet.description प्रॉपर्टी, channelSection संसाधन की snippet.title प्रॉपर्टी, और channel संसाधन की snippet.description प्रॉपर्टी के लिए, स्थानीय भाषा में टेक्स्ट सेट करने और उसे वापस पाने की सुविधा देता है.

• स्थानीय भाषा में टाइटल और ब्यौरे सेट करना

  किसी संसाधन के लिए insert या update तरीके को कॉल करते समय, उस संसाधन के लिए स्थानीय भाषा में वैल्यू सेट की जा सकती हैं. किसी संसाधन के लिए स्थानीय भाषा में वैल्यू सेट करने के लिए, यह दोनों काम करें:

  • पक्का करें कि संसाधन की snippet.defaultLanguage प्रॉपर्टी के लिए कोई वैल्यू सेट की गई हो. यह प्रॉपर्टी, संसाधन की snippet.title और snippet.description प्रॉपर्टी की भाषा की पहचान करती है. इसकी वैल्यू, ऐप्लिकेशन की कोई भी भाषा या ISO 639-1:2002 के ज़्या��ातर भाषा कोड हो सकती है. उदाहरण के लिए, अगर आपने ऐसा वीडियो अपलोड किया है जिसका टाइटल और ब्यौरा अंग्रेज़ी में है, तो आपको snippet.defaultLanguage प्रॉपर्टी को en पर सेट करना होगा.

    channel संसाधनों को अपडेट करने के बारे में जानकारी: किसी channel संसाधन के लिए snippet.defaultLanguage प्रॉपर्टी सेट करने के लिए, आपको brandingSettings.channel.defaultLanguage प्रॉपर्टी को अपडेट करना होगा.

  • जिस संसाधन को अपडेट किया जा रहा है उसमें localizations ऑब्जेक्ट जोड़ें. हर ऑब्जेक्ट कुंजी एक स्ट्रिंग होती है. यह ऐप्लिकेशन की भाषा या ISO 639-1:2002 भाषा कोड की पहचान करती है. साथ ही, हर कुंजी उस ऑब्जेक्ट पर मैप होती है जिसमें संसाधन के लिए स्थानीय भाषा में टाइटल (और ब्यौरा) होता है.

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

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

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

• स्थानीय भाषा में वैल्यू पाना

  एपीआई, किसी संसाधन के लिए स्थानीय वैल्यू पाने के दो तरीके उपलब्ध कराता है:

  • किसी ऐप्लिकेशन की भाषा के लिए, स्थानीय भाषा में उपलब्ध डेटा को वापस पाने के लिए, hl पैरामीटर को अपनी channels.list, channelSections.list, playlists.list या videos.list अनुरोध में जोड़ें. ऐप्लिकेशन की भाषा ऐसी होनी चाहिए जिसे YouTube की वेबसाइट पर इस्तेमाल किया जा सकता हो. अगर संसाधन की स्थानीय भाषा में जानकारी उपलब्ध है, तो संसाधन के snippet.localized ऑब्जेक्ट में स्थानीय भाषा में वैल्यू शामिल होंगी. हालांकि, अगर स्थानीय जानकारी उपलब्ध नहीं है, तो snippet.localized ऑब्जेक्ट में संसाधन की जानकारी, संसाधन की डिफ़ॉल्ट भाषा में होगी.

    उदाहरण के लिए, मान लें कि videos.list के अनुरोध पर, ऊपर बताए गए वीडियो के लिए डेटा मिला है. इसमें जर्मन और स्पैनिश भाषा में स्थानीय डेटा शामिल है. अगर hl पैरामीटर को de पर सेट किया गया है, तो संसाधन में यह डेटा शामिल होगा:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    हालांकि, अगर hl पैरामीटर को fr पर सेट किया गया है, तो snippet.localized ऑब्जेक्ट में अंग्रेज़ी में टाइटल और जानकारी शामिल होगी. ऐसा इसलिए, क्योंकि संसाधन के लिए अंग्रेज़ी डिफ़ॉल्ट भाषा है और फ़्रेंच में स्थानीय जानकारी उपलब्ध नहीं है.

    अहम जानकारी: hl पैरामीटर सिर्फ़ उन वैल्यू के साथ काम करता है जो YouTube की वेबसाइट पर इस्तेमाल की जा सकने वाली ऐप्लिकेशन की भाषाओं की पहचान करती हैं. यह पता लगाने के लिए कि अन्य भाषाओं के लिए स्थानीय भाषा में टेक्स्ट उपलब्ध है या नहीं, आपको संसाधन के लिए localizations हिस्सा वापस पाना होगा. इसके बाद, यह पता लगाने के लिए फ़िल्टर करना होगा कि स्थानीय भाषा में टेक्स्ट मौजूद है या नहीं.
    
    उदाहरण के लिए, यह पता लगाने के लिए कि ��पलचियन अंग्रेज़ी में स्थानीय भाषा में टेक्स्ट उपलब्ध है या नहीं, आपको स्थानीय भाषा में टेक्स्ट की पूरी सूची वापस पानी होगी.
    
    

  • किसी संसाधन को वापस पाने के लिए, part ��ैरामीटर ��ैल्यू ��ें localizations ��ामिल करें. इससे आपको उस संसाधन की स्थानीय भाषा में उपलब्ध सभी जानकारी मिल जाएगी. अगर आपको किसी ऐसी भाषा के लिए स्थानीय डेटा पाना है जो YouTube ऐप्लिकेशन की मौजूदा भाषा नहीं है, तो आपको सभी स्थानीय भाषाओं में उपलब्ध डेटा पाने के लिए इस तरीके का इस्तेमाल करना होगा. इसके बाद, आपको फ़िल्टर करके यह तय करना होगा कि स्थानीय भाषा में उपलब्ध ज़रूरी डेटा मौजूद है या नहीं.

• स्थानीय भाषा में दी गई टेक्स्ट वैल्यू से जुड़ी गड़बड़ियां

  एपीआई, स्थानीय भाषा में टेक्स्ट वैल्यू के लिए इन नई गड़बड़ियों को भी ठीक करता है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest (400)	defaultLanguageNotSetError	इस गड़बड़ी से पता चलता है कि किसी संसाधन के लिए localizations ऑब्जेक्ट को डालने या अपडेट करने का अनुरोध पूरा नहीं हो सका. इसकी वजह यह है कि उस संसाधन के लिए snippet.defaultLanguage प्रॉपर्टी सेट नहीं की गई है. channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert, और videos.update तरीके इस गड़बड़ी के साथ काम करते हैं.
  badRequest (400)	localizationValidationError	इस गड़बड़ी से पता चलता है कि किसी संसाधन के localizations ऑब्जेक्ट में मौजूद किसी वैल्यू की पुष्टि नहीं हो सकी. उदाहरण के लिए, अगर ऑब्जेक्ट में भाषा का अमान्य कोड शामिल है, तो यह गड़बड़ी हो सकती है. channels.update, channelSections.insert, channelSections.update, playlists.insert, और playlists.update तरीके इस गड़बड़ी के साथ काम करते हैं.

4 नवंबर, 2015

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

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

  • search.list तरीके के order पैरामीटर को अपडेट किया गया है. इसमें बताया गया है कि अगर लाइव ब्रॉडकास्ट को viewCount के हिसाब से क्रम से लगाया जाता है, तो एपीआई के नतीजे, ब्रॉडकास्ट को एक साथ देखने वाले दर्शकों की संख्या के हिसाब से क्रम से लगाए जाते हैं. ऐसा तब होता है, जब ब्रॉडकास्ट चल रहे होते हैं.

  • search.list तरीके के relatedToVideoId पैरामीटर को अपडेट किया गया है. इससे यह पता चलता है कि अगर पैरामीटर सेट है, तो इस्��ेमाल किए जा सकने वाले अन्य पैरामीटर सिर्फ़ part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (जिसे video पर सेट किया जाना चाहिए) और fields हैं. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता.

  • video संसाधन की snippet.publishedAt प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि प्रॉपर्टी की वैल्यू, वीडियो पब्लिश होने की तारीख और समय के बारे में बताती है. यह वैल्यू, वीडियो अपलोड होने के समय से अलग हो सकती है. उदाहरण के लिए, अगर किसी वीडियो को निजी वीडियो के तौर पर अपलोड किया जाता है और बाद में उसे सार्वजनिक किया जाता है, तो प्रॉपर्टी वैल्यू से यह पता चलता है कि वीडियो को कब सार्वजनिक किया गया था. अपडेट की गई परिभाषा में यह भी बताया गया है कि निजी और सबके लिए मौजूद नहीं के तौर पर सेट वीडियो के लिए, वैल्यू कैसे भरी जाती है.

    इस बदलाव से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता.

  • video संसाधन की status.publishAt प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें यह जानकारी शामिल की गई है:

    • अगर videos.update तरीके को कॉल करते समय, इस प्रॉपर्टी की वैल्यू सेट की जाती है, तो आपको status.privacyStatus प्रॉपर्टी की वैल्यू को private पर भी सेट करना होगा. भले ही, वीडियो पहले से ही निजी के तौर पर सेट हो.
    • अगर अनुरोध में, वीडियो को बीते समय में पब्लिश करने के लिए शेड्यूल किया गया है, तो उसे तुरंत पब्लिश कर दिया जाता है. इसलिए, status.publishAt प्रॉपर्टी को पिछली तारीख और समय पर सेट करने का असर, वीडियो की privacyStatus प्रॉपर्टी को private से public में बदलने जैसा ही होता है.

  • video संसाधन की contentDetails.contentRating.cncRating प्रॉपर्टी, फ़्रांस की Commission de classification cinematographique के हिसाब से वीडियो की रेटिंग तय करती है. यह प्रॉपर्टी, अब काम न करने वाली contentDetails.contentRating.fmocRating प्रॉपर्टी की जगह ले लेगी.

  • channel रिसॉर्स के brandingSettings.channel.keywords की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि प्रॉपर्टी की वैल्यू में स्पेस से अलग की गई स्ट्रिंग की सूची शामिल होती है, न कि कॉमा से अलग की गई स��ची. यह जानकारी पहले के दस्तावेज़ में दी गई थी. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता.

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

  • activity रिसॉर्स के ब्यौरे को अपडेट किया गया है. इससे यह पता चलता है कि फ़िलहाल, activities.list तरीके में वीडियो पर की गई नई टिप्पणियों से जुड़े रिसॉर्स शामिल नहीं हैं. संसाधन के snippet.type और contentDetails.comment को भी अपडेट कर दिया गया है.

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

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

    गड़बड़ी की जानकारी
    activities.insert	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण invalidMetadata ब्यौरा kind प्रॉपर्टी, दिए गए आईडी के टाइप से मेल नहीं खाती.
    commentThreads.update comments.insert comments.update	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण commentTextTooLong ब्यौरा जिस comment रिसॉर्स को डाला या अपडेट किया जा रहा है उसकी snippet.topLevelComment.snippet.textOriginal प्रॉपर्टी में बहुत ज़्यादा वर्ण हैं.
    playlistItems.insert playlistItems.update	एचटीटीपी रिस्पॉन्स कोड forbidden (403) कारण playlistItemsNotAccessible ब्यौरा अनुरोध को, बताई गई प्लेलिस्ट आइटम को डालने, अपडेट करने या मिटाने की अनुमति नहीं है.
    playlists.delete playlists.insert playlists.update	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण playlistForbidden ब्यौरा इस कार्रवाई पर रोक लगी हुई है या अनुरोध को स��ी तरीके से अनुमति नहीं दी गई है.
    search.list	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण invalidLocation ब्यौरा location और/या locationRadius पैरामीटर की वैल्यू को गलत तरीके से फ़ॉर्मैट किया गया था.
    search.list	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण invalidRelevanceLanguage ब्यौरा relevanceLanguage पैरामीटर की वैल्यू को गलत तरीके से फ़ॉर्मैट किया गया था.
    subscriptions.insert	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण subscriptionForbidden ब्यौरा यह गड़बड़ी तब होती है, जब इनमें से कोई भी शर्त पूरी होती है: आपको जिस सदस्यता को बनाना है वह पहले से मौजूद है आपने सदस्यता लेने की तय सीमा पहले ही पूरी कर ली है आपने अपने ही चैनल की सदस्यता लेने की कोशिश की है. हालांकि, ऐसा नहीं किया जा सकता. आपने हाल ही में बहुत सारी सदस्यताएं ली हैं. इसलिए, आपको कुछ घंटों तक इंतज़ार करना होगा. इसके बाद, सदस्यता लेने का अनुरोध फिर से करें.
    videos.update	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण invalidDefaultBroadcastPrivacySetting ब्यौरा इस अनुरोध में, डिफ़ॉल्ट ब्रॉडकास्ट के लिए अमान्य निजता सेटिंग सेट करने की कोशिश की गई है.

28 अगस्त, 2015

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

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

  • video संसाधन की statistics.favoriteCount प्रॉपर्टी अब काम नहीं करती है.

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

7 अगस्त, 2015

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

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

  • video संसाधन की snippet.tags[] प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि एपीआई सर्वर, प्रॉपर्टी की वैल्यू की लंबाई का हिसाब कैसे लगाता है. ध्यान दें कि इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं हुआ है.

    खास तौर पर, अब परिभाषा में यह बताया गया है कि अगर किसी ��ैग में स्पेस है, तो API सर्वर टैग की वैल्यू को इस तरह से हैंडल करता है जैसे कि उसे कोटेशन मार्क में रैप किया गया हो. साथ ही, कोटेशन मार्क की गिनती वर्ण सीमा में की जाती है. इसलिए, वर्णों की सीमा के हिसाब से, Foo-Baz टैग में सात वर्ण हैं, लेकिन Foo Baz टैग में नौ वर्ण हैं.

  • commentThreads.insert तरीके में अब shareOnGooglePlus पैरामीटर काम नहीं करता. पहले, इस पैरामीटर से यह पता चलता था कि किसी टिप्पणी और उसके जवाबों को लेखक की Google+ प्रोफ़ाइल पर भी पोस्ट किया जाना चाहिए या नहीं. अगर कोई अनुरोध इस पैरामीटर को सबमिट करता है, तो एपीआई सर्वर इस पैरामीटर को अनदेखा कर देता है. हालांकि, वह अनुरोध को प्रोसेस करता है.

18 जून, 2015

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

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

  • commentThreads.list तरीके का नया order पैरामीटर, यह तय करता है कि एपीआई के जवाब में टिप्पणी थ्रेड किस क्रम में दिखनी चाहिए. थ्रेड को समय या काम के होने के हिसाब से क्रम में लगाया जा सकता है. डिफ़ॉल्ट रूप से, इन्हें समय के हिसाब से क्रम में लगाया जाता है.

  • video संसाधन की नई snippet.defaultAudioLanguage प्रॉपर्टी से, वीडियो के डिफ़ॉल्ट ऑडियो ट्रैक में बोली जाने वाली भाषा के बारे में पता चलता है.

  • video संसाधन की contentDetails.licensedContent प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह साफ़ तौर पर पता चलता है कि कॉन्टेंट को मूल रूप से, YouTube कॉन्टेंट पार्टनर से लिंक किए गए चैनल पर अपलोड किया गया हो. इसके बाद, उस पार्टनर ने उस पर दावा किया हो. इससे एपीआई के असल व्यवहार में कोई बदलाव नहीं होता.

  • captions.delete, captions.download, captions.insert, captions.list, और captions.update तरीकों में अब onBehalfOfContentOwner पैरामीटर काम करता है. यह पैरामीटर, पहले से ही कई अन्य तरीकों के लिए काम करता है. इस तरीके का इस्तेमाल करने वाले अनुरोधों को भी ऐसे टोकन से अनुमति दी जानी चाहिए जो https://www.googleapis.com/auth/youtubepartner स्कोप का ऐक��सेस देता हो.

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

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

    गड़बड़ी की जानकारी
    videos.rate	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण emailNotVerified ब्यौरा उपयोगकर्ता को वीडियो को रेटिंग देने से पहले, अपने ईमेल पते की पुष्टि करनी होगी.
    videos.rate	एचटीटीपी रिस्पॉन्स कोड badRequest (400) कारण videoPurchaseRequired ब्यौरा किराए पर लिए गए वीडियो को सिर्��़ ���� ��ो�� ��ेटिंग दे ��कते हैं जिन्होंने उन्हें किराए पर लिया है.

  • subscriptions.delete और subscriptions.insert तरीके, अब accountClosed और accountSuspended गड़बड़ियों के साथ काम नहीं करते.

27 अप्रैल, 2015

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

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

  • नए videoAbuseReportReason संसाधन में, यह जानकारी दी गई है कि किसी वीडियो को अपमानजनक कॉन्टेंट के लिए फ़्लैग क्यों किया जाएगा. videoAbuseReportReasons.list तरीके से, उन सभी वजहों की सूची वापस पाई जा सकती है जिनकी वजह से वीडियो को फ़्लैग किया जा सकता है.

  • videos.reportAbuse के नए तरीके से, बुरे बर्ताव वाले कॉन्टेंट वाले वीडियो को फ़्लैग किया जा सकता है. अनुरोध के मुख्य हिस्से में एक JSON ऑब्जेक्ट होता है. इसमें उस वीडियो के बारे में जानकारी होती है जिसे फ़्लैग किया जा रहा है. साथ ही, इसमें यह भी बताया जाता है कि वीडियो में आपत्तिजनक कॉन्टेंट क्यों शामिल है. मान्य वजहों के बारे में जानने के लिए, videoAbuseReportReason.list ऊपर बताया गया तरीका अपनाएं.

    माइग्रेशन गाइड को भी अपडेट किया गया है. इसमें आपत्तिजनक वीडियो की शिकायत करने का एक उदाहरण दिया गया है. इस बदलाव के बाद, v3 एपीआई में अब v2 एपीआई की वे सभी सुविधाएं काम करती हैं जिनके साथ इसे काम करना है. इन सभी सुविधाओं के बारे में, माइग्रेशन गाइड में भी बताया गया है.

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

  • search.list तरीके का नया forDeveloper फ़िल्टर पैरामीटर, खोज के नतीजों में सिर्फ़ उन वीडियो को शामिल करता है जिन्हें डेवलपर के ऐप्लिकेशन या वेबसाइट के ज़रिए अपलोड किया गया ह��. forDeveloper पैरामीटर का इस्तेमाल, खोज के लिए इस्तेमाल होने वाले वैकल्पिक पैरामीटर के साथ किया जा सकता है. जैसे, q पैरामीटर.

    इस सुविधा के लिए, अपलोड किए गए हर वीडियो को उस प्रोजेक्ट नंबर के साथ अपने-आप टैग कर दिया जाता है जो Google Developers Console में डेवलपर के ऐप्लिकेशन से जुड़ा होता है.

    जब कोई खोज अनुरोध, forDeveloper पैरामीटर को true पर सेट करता है, तो एपीआई सर्वर, डेवलपर की पहचान करने के लिए अनुरोध के अनुमति वाले क्रेडेंशियल का इस्तेमाल करता है. इसलिए, डेवलपर नतीजों को सिर्फ़ अपने ऐप्लिकेशन या वेबसाइट के ज़रिए अपलोड किए गए वीडियो तक सीमित कर सकता है. हालांकि, वह अन्य ऐप्लिकेशन या साइटों के ज़रिए अपलोड किए गए वीडियो को सीमित नहीं कर सकता.

    नई सुविधा में, v2 एपीआई में उपलब्ध डेवलपर टैग की सुविधा के जैसी ही सुविधाएं मिलती हैं. हालांकि, ये सुविधाएं पूरी तरह से एक जैसी नहीं हैं.

  • channel संसाधन की नई snippet.country प्रॉपर्टी की मदद से, चैनल के मालिक अपने चैनलों को किसी देश के साथ असोसिएट कर सकते हैं.

    ध्यान दें: किसी channel संसाधन के लिए snippet.country प्रॉपर्टी सेट करने के लिए, आपको brandingSettings.channel.country प्रॉपर्टी को अपडेट करना होगा.

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

    एपीआई, टारगेटिंग के तीन विकल्प दिखाता है. किसी चैनल सेक्शन को दिखने के लिए, उपयोगकर्ता को टारगेटिंग की सभी सेटिंग पूरी करनी होंगी.

    • targeting.languages[]: YouTube ऐप्लिकेशन की भाषाओं की सूची. जिन लोगों ने इनमें से कोई भाषा चुनी है वे चैनल का वह सेक्शन देख सकते हैं.

    • targeting.regions[]: YouTube पर कॉन्टेंट के लिए पसंदीदा क्षेत्रों की सूची. चैनल सेक्शन उन लोगों को दिखता है जिन्होंने इनमें से किसी एक देश/इलाके को चुना है. साथ ह��, उन लोगों को भी दिखता है जिनके लिए इनमें से कोई एक देश/इलाका अपने-आप चुना गया है.

    • targeting.countries[]: उन देशों की सूची जहां चैनल सेक्शन दिखता है. सूची में मौजूद हर वैल्यू, आईएसओ 3166-1 ऐल्फ़ा-2 देश का कोड है.

  • video संसाधन की contentDetails.duration प्रॉपर्टी की परिभाषा को ठीक किया गया है, ताकि यह पता चल सके कि वैल्यू में घंटे, दिन वगैरह दिख सकते हैं.

  • channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete, और videos.delete मेथड के दस्तावेज़ में सुधार किया गया है. इसमें बताया गया है कि अगर ये मेथड काम करते हैं, तो ये सभी एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाते हैं.

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

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

    गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
    badRequest (400)	targetInvalidCountry	अगर डाली गई channelSection संसाधन में targeting.countries[] प्रॉपर्टी के लिए अमान्य वैल्यू शामिल है, तो channelSections.insert और channelSections.update तरीके यह गड़बड़ी दिखाते हैं.
    badRequest (400)	targetInvalidLanguage	अगर डाली गई channelSection संसाधन में targeting.languages[] प्रॉपर्टी के लिए अमान्य वैल्यू शामिल है, तो channelSections.insert और channelSections.update तरीके यह गड़बड़ी दिखाते हैं.
    badRequest (400)	targetInvalidRegion	अगर डाली गई channelSection संसाधन में targeting.regions[] प्रॉपर्टी के लिए अमान्य वैल्यू शामिल है, तो channelSections.insert और channelSections.update तरीके यह गड़बड़ी दिखाते हैं.
    badRequest (400)	operationNotSupported	अगर एपीआई का इस्तेमाल करने वाला व्यक्ति, snippet.parentId प्रॉपर्टी से पहचानी गई टॉप-लेवल की टिप्पणी के जवाब में कोई टिप्पणी नहीं डाल पाता है, तो comments.insert तरीके से यह गड़बड़ी दिखती है. commentThread रिसॉर्स में, snippet.canReply प्रॉपर्टी से पता चलता है कि मौजूदा दर्शक थ्रेड का जवाब दे सकता है या नहीं.
    badRequest (400)	invalidChannelId	अगर अनुरोध में channelId पैरामीटर में अमान्य चैनल आईडी दिया गया है, तो search.list तरीके से यह गड़बड़ी दिखती है.
    badRequest (400)	subscriptionForbidden	अगर एपीआई का इस्तेमाल करने वाला व्यक्ति, अपने ही चैनल क�� सदस्यता लेने की कोशिश करता है, तो subscriptions.insert तरीके से यह गड़बड़ी दिखती है.

  • captions.update तरीके में अब invalidMetadata और videoNotFound गड़बड़ियों को ठीक नहीं किया जा सकता.

16 अप्रैल, 2015

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

• डेटा को दूसरी जगह भेजने से जुड़ी गाइड को अपडेट कर दिया गया है. इसमें बताया गया है कि v2 API से टिप्पणियों की सुविधा का इस्तेमाल करने वाले ऐप्लिकेशन को कैसे माइग्रेट करें.

  गाइड में, टिप्पणी करने से जुड़ी कई ऐसी सुविधाओं के बारे में भी बताया गया है जो v2 एपीआई के साथ काम नहीं करती थीं, लेकिन v3 एपीआई के साथ काम करती हैं. इनमें शामिल हैं:

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

• पुश नोटिफ़िकेशन के लिए ऑप्ट-इन करना गाइड को अपडेट किया गया है. इसमें बताया गया है कि नोटिफ़िकेशन सिर्फ़ Google PubSubHubBub हब को भेजे जाते हैं. पहले बताया गया था कि इन्हें Superfeedr हब को भी भेजा जाता है.

9 अप्रैल, 2015

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

• एपीआई के नए commentThread और comment संसाधनों की मदद से, टिप्पणियां वापस पाई जा सकती हैं, डाली जा सकती हैं, अपडेट की जा सकती हैं, मिटाई जा सकती हैं, और मॉडरेट की जा सकती हैं.

  • commentThread संसाधन में, YouTube पर की गई टिप्पणी की थ्रेड के बारे में जानकारी होती है. इसमें सबसे ऊपर दिखने वाली टिप्पणी और उस टिप्पणी के जवाब शामिल होते हैं. commentThread संसाधन, किसी वीडियो या चैनल के बारे में की गई टिप्पणियों को दिखाता है.

    टॉप-लेवल की टिप्पणी और जवाब, असल में comment संसाधन होते हैं. ये commentThread संसाधन के अंदर नेस्ट किए जाते हैं. यह ध्यान रखना ज़रूरी है कि commentThread संसाधन में, किसी टिप्पणी के सभी जवाब शामिल नहीं होते. अगर आपको किसी टिप्पणी के सभी जवाब वापस पाने हैं, तो आपको comments.list तरीके का इस्तेमाल करना होगा. इसके अलावा, कुछ टिप्पणियों के जवाब नहीं दिए गए हैं.

    एपीआई, commentThread संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

    • commentThreads.list – टिप्पणी की थ्रेड की सूची वापस पाएं. इस तरीके का इस्तेमाल, किसी वीडियो या चैनल से जुड़ी टिप्पणियां वापस पाने के लिए करें.
    • commentThreads.insert – सबसे ऊपर दिखने वाली नई टिप्पणी लिखें. (किसी मौजूदा टिप्पणी का जवाब देने के लिए, comments.insert तरीके का इस्तेमाल करें.)
    • commentThreads.update – टॉप-लेवल की टिप्पणी में बदलाव करें.

  • comment संसाधन में, YouTube पर की गई किसी एक टिप्पणी के बारे में जानकारी होती है. comment संसाधन, किसी वीडियो या चैनल के बारे में की गई टिप्पणी को दिखाता है. इसके अलावा, टिप्पणी सबसे ऊपर दिखने वाली टिप्पणी या सबसे ऊपर दिखने वाली टिप्पणी का जवाब हो सकती है.

    एपीआई, comment संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

    • comments.list – टिप्पणी की सूची वापस पाएं. किसी टिप्पणी के सभी जवाब पाने के लिए, इस तरीके का इस्तेमाल करें.
    • comments.insert – किसी मौजूदा टिप्पणी का जवाब दें.
    • comments.update – किसी टिप्पणी में बदलाव करना.
    • comments.markAsSpam – एक या उससे ज़्यादा टिप्पणियों को स्पैम के तौर पर फ़्लैग करें.
    • comments.setModerationStatus – एक या उससे ज़्यादा टिप्पणियों के मॉडरेशन का स्टेटस सेट करें. उदाहरण के लिए, किसी टिप्पणी को सार्वजनिक तौर पर दिखाने के लिए मंज़ूरी देना या उसे दिखाने के लिए अस्वीकार करना. एपीआई का अनुरोध, टिप्पणियों से जुड़े चैनल या वीडियो के मालिक ने किया हो.
    • comments.delete – किसी टिप्पणी को मिटाएं.

  ध्यान दें कि comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert, और commentThreads.update तरीकों को कॉल करने के लिए, एपीआई के नए https://www.googleapis.com/auth/youtube.force-ssl स्कोप की ज़रूरत होती है. इसके बारे में 2 अप्रैल, 2015 के लिए संशोधन इतिहास में बताया गया है.

• पुश नोटिफ़िकेशन के लिए ऑप्ट-इन करना से जुड़ी नई गाइड में, PubSubHubBub के ��़र����� ������ नोटिफ़िकेशन ��ाने के लिए, ��पीआई क�� नई ����विधा के बारे में बताया गया है. PubSubHubBub, वेब पर उपलब्ध संसाधनों के लिए, सर्वर-टू-सर्वर पब्लिश/सब्सक्राइब प्रोटोकॉल है. जब कोई चैनल इनमें से कोई भी गतिविधि करता है, तब आपका PubSubHubBub कॉलबैक सर्वर, ऐटम फ़ीड की सूचनाएं पा सकता है:

  • वीडियो अपलोड करता है
  • वीडियो का टाइटल अपडेट करता है
  • वीडियो की जानकारी अपडेट करता है

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

• एपीआई का नया https://www.googleapis.com/auth/youtube.force-ssl स्कोप, अब किसी भी एपीआई तरीके के लिए मान्य स्कोप है. इससे पहले, यह https://www.googleapis.com/auth/youtube स्कोप के साथ काम करता था.

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

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest (400)	invalidRating	अगर अनुरोध में rating पैरामीटर के लिए कोई ऐसी वैल्यू शामिल की गई है जिसकी उम्मीद नहीं थी, तो videos.rate तरीके से यह गड़बड़ी दिखती है.

• subscriptions.insert तरीके में अब subscriptionLimitExceeded गड़बड़ी नहीं होती है. पहले, इस गड़बड़ी से पता चलता था कि अनुरोध करने वाले सदस्य ने सदस्यता की दर सीमा पार कर ली है.

2 अप्रैल, 2015

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

• नया captions संसाधन, YouTube के कैप्शन ट्��ैक को दिखाता है. कैप्शन ट्रैक, सिर्फ़ एक YouTube वीडियो से जुड़ा होता है.

  एपीआई, कैप्शन ट्रैक को सूचीबद्ध करने, जोड़ने, अपडेट करने, डाउनलोड करने, और मिटाने के तरीकों के साथ काम करता है.

• माइग्रेशन गाइड को भी अपडेट किया गया है. इसमें बताया गया है कि v2 API में कैप्शन की सुविधा का इस्तेमाल करने वाले ऐप्लिकेशन को कैसे माइग्रेट किया जाए.

• एपीआई के नए https://www.googleapis.com/auth/youtube.force-ssl स्कोप के लिए, एपीआई सर्वर के साथ कम्यूनिकेशन, एसएसएल कनेक्शन के ज़रिए होना ज़रूरी है.

  इस नए स्कोप से, https://www.googleapis.com/auth/youtube स्कोप के बराबर ऐक्सेस मिलता है. हालांकि, फ़ंक्शन के हिसाब से ये दोनों स्कोप एक जैसे हैं, क्योंकि YouTube API सर्वर सिर्फ़ एचटीटीपीएस एंडपॉइंट के ज़रिए उपलब्ध होता है. इस वजह से, भले ही https://www.googleapis.com/auth/youtube स्कोप के लिए एसएसएल कनेक्शन की ज़रूरत न हो, लेकिन एपीआई अनुरोध करने का कोई और तरीका नहीं है.

  caption संसाधन के सभी तरीकों को कॉल करने के लिए, नए स्कोप की ज़रूरत होती है.

11 मार्च, 2015

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

• YouTube Data API (v3) पर माइग्रेट करने से जुड़ी गाइड में एक नया टैब है. इसका नाम v3 API में नई सुविधाएं है. इसमें उन सुविधाओं की सूची दी गई है जो v3 API के साथ काम करती हैं, लेकिन v2 API के साथ काम नहीं करती थीं. ये सुविधाएं, पहले भी गाइड के अन्य टैब में मौजूद थीं और अब भी मौजूद हैं. उदाहरण के लिए, चैनल के इन-वीडियो प्रमोशनल कैंपेन के डेटा को अपडेट करने का तरीका बताने वाली नई सुविधा के बारे में जानकारी भी चैनल (प्रोफ़ाइलें) टैब में दी गई है.

• YouTube Data API (v3) पर माइग्रेट करने से जुड़ी गाइड को अपडेट किया गया है. इसमें बताया गया है कि v3 API, v2 API की इस सुविधा के साथ काम करेगा:

  • किसी वीडियो को फ़्लैग करना

• YouTube Data API (v3) की माइग्रेशन गाइड को अपडेट कर दिया गया है. इसमें बताया गया है कि v2 API की ये सुविधाएं, v3 API में काम नहीं करेंगी:

  • वीडियो के सुझाव पाना – v3 API, ऐसी सूची नहीं दिखाता जिसमें सिर्फ़ एपीआई का इस्तेमाल करने वाले मौजूदा व्यक्ति के लिए सुझाए ग�� वीडियो शामिल हों. हालांकि, v3 एपीआई का इस्तेमाल करके, सुझाए गए वीडियो ढूंढे जा सकते हैं. इसके लिए, activities.list तरीके को कॉल करें और home पैरामीटर की वैल्यू को true पर सेट करें.

    एपीआई से मिले जवाब में, किसी संसाधन को सुझाई गई वीडियो के तौर पर तब दिखाया जाता है, जब snippet.type प्रॉपर्टी की वैल्यू recommendation होती है. ऐसे में, contentDetails.recommendation.reason और contentDetails.recommendation.seedResourceId प्रॉपर्टी में यह जानकारी शामिल होगी कि वीडियो का सुझाव क्यों दिया गया. ध्यान दें कि इस बात की कोई गारंटी नहीं है कि जवाब में, सुझाए गए वीडियो की कोई तय संख्या होगी.

  • चैनल के सुझाव पाना

  • सदस्यता वाले चैनलों पर हाल ही में अपलोड किए गए वीडियो पाना – v3 API, ऐसी सूची नहीं दिखाता जिसमें सिर्फ़ उन चैनलों पर हाल ही में अपलोड किए गए वीडियो शामिल हों जिनकी सदस्यता API का इस्तेमाल करने वाले व्यक्ति ने ली है. हालांकि, v3 API का इस्तेमाल करके, सदस्यता वाले नए वीडियो ढूंढे जा सकते हैं. इसके लिए, activities.list तरीके को कॉल करें और home पैरामीटर की वैल्यू को true पर सेट करें.

    एपीआई से मिले जवाब में, कोई संसाधन नए सदस्यता वीडियो से तब जुड़ा होता है, जब snippet.type प्रॉपर्टी की वैल्यू upload होती है. ध्यान दें कि इस बात की कोई गारंटी नहीं है कि जवाब में, सदस्यता वाले नए वीडियो की कोई खास संख्या शामिल होगी.

  • आरएसएस फ़ीड की सुविधा

  • फ़ीड अपडेट के लिए पुश नोटिफ़िकेशन – v2 API, YouTube उपयोगकर्ताओं के लिए उपयोगकर्ता गतिविधि फ़ीड को मॉनिटर करने के लिए, पुश नोटिफ़िकेशन की सुविधा देता था. इसके लिए, Simple Update Protocol (SUP) या PubSubHubbub का इस्तेमाल किया जाता था. नए चैनल की सदस्यता लेने पर सूचनाएं मिलती थीं. साथ ही, वीडियो को रेटिंग देने, शेयर करने, पसंदीदा के तौर पर मार्क करने, टिप्पणी करने या अपलोड करने पर भी सूचनाएं मिलती थीं.

    v3 API, PubSubHubbub प्रोटोकॉल का इस्तेमाल करके पुश नोटिफ़िकेशन की सुविधा देगा. हालांकि, ये सूचनाएं सिर्फ़ वीडियो अपलोड करने और वीडियो के टाइटल या वीडियो के ब्यौरे में किए गए अपडेट के बारे में होंगी.

  • चैनल की जगह की जानकारी – v2 API, <yt:location> टैग का इस्तेमाल करके, उपयोगकर्ता की उस जगह की जानकारी का पता लगाता था जिसे चैनल की YouTube सार्वजनिक प्��ोफ़ाइल में डाला गया है. कुछ डेवलपर ने इस फ़ील्ड का इस्तेमाल, किसी चैनल को किसी देश से जोड़ने के लिए किया. हालांकि, इस फ़ील्ड के डेटा का इस्तेमाल लगातार इस काम के लिए नहीं किया जा सका.

  • डेवलपर टैग सेट करना या वापस पाना – v2 API की मदद से, वीडियो अपलोड करते समय कीवर्ड या डेवलपर टैग को वीडियो से जोड़ा जा सकता था. डेवलपर टैग, YouTube उपयोगकर्ताओं को नहीं दिखेंगे. हालांकि, वीडियो के मालिक उन वीडियो को वापस पा सकते हैं जो किसी डेवलपर टैग से मेल खाते हैं.

    v3 एपीआई में, मिलती-जुलती सुविधा उपलब्ध होगी. हालांकि, यह सुविधा v2 एपीआई में उपलब्ध सुविधा से अलग होगी. खास तौर पर, डेवलपर अपने ऐप्लिकेशन से अपलोड किए गए वीडियो खोज पाएगा. इस सुविधा के लिए, अपलोड किए गए हर वीडियो को उस प्रोजेक्ट नंबर के साथ अपने-आप टैग कर दिया जाता है जो Google Developers Console में डेवलपर के ऐप्लिकेशन से जुड़ा होता है. इसके बाद, डेवलपर वीडियो ढूंढने के लिए उसी प्रोजेक्ट नंबर का इस्तेमाल करता है.

  • वीडियो को पब्लिश होने की तारीख, व्यू की संख्या या रेटिंग के हिसाब से क्रम में लगाएं – v2 API में, orderby पैरामीटर की मदद से, किसी प्लेलिस्ट में मौजूद वीडियो को उनकी पोज़िशन, अवधि, पब्लिश होने की तारीख, टाइटल, और अन्य वैल्यू के हिसाब से क्रम में लगाया जा सकता है. v3 API में, प्लेलिस्ट के आइटम को आम तौर पर क्रम संख्या के हिसाब से बढ़ते क्रम में लगाया जाता है. इसमें क्रम से लगाने के अन्य विकल्प उपलब्ध नहीं होते हैं.

    हालांकि, इसके कुछ अपवाद हैं. यहां दी गई प्लेलिस्ट में, नया अपलोड किया गया वीडियो, पसंदीदा वीडियो, पसंद किया गया वीडियो या हाल ही में देखा गया वीडियो, पहले आइटम (snippet.position=0) के तौर पर अपने-आप जुड़ जाता है. इसलिए, इन सूचियों में आइटम को सबसे नए से सबसे पुराने के क्रम में लगाया जाता है. यह क्रम, सूची में आइटम जोड़े जाने के समय के हिसाब से तय होता है.

    • उपयोगकर्ता के अपलोड किए गए वीडियो
    • पसंदीदा वीडियो
    • पसंद किए गए वीडियो
    • देखने का इतिहास

    हालांकि, ध्यान दें कि "बाद में देखें" प्लेलिस्ट में जोड़ा गया नया आइटम, उस सूची में सबसे आखिर में जोड़ा जाता है. ��सलिए, सूची में सबसे पुराना आइटम सबसे ऊपर और सबसे नया आइटम सबसे नीचे दिखता है.

  • बैच प्रोसेसिंग – v3 API, बैच प्रोसेसिंग के उस इस्तेमाल के साथ काम करता है जिसके साथ v2 API काम करता था. v3 API के channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list, और videos.list तरीकों में id पैरामीटर का इस्तेमाल किया जा सकता है. इसका इस्तेमाल, कॉमा लगाकर अलग किए गए आईडी (वीडियो आईडी, चैनल आईडी वगैरह) की सूची तय करने के लिए किया जा सकता है. इन तरीकों का इस्तेमाल करके, एक ही अनुरोध में कई संसाधनों की सूची वापस पाई जा सकती है.

  इ�� ������ावों के बाद, गाइड में अब उन सभी सुविधाओं की जानकारी दी गई है जो एपीआई के पुराने वर्शन (v2) में काम करती थीं. हालांकि, एपीआई के मौजूदा वर्शन (v3) में ये सुविधाएं काम नहीं करेंगी.

4 मार्च, 2015

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

• channelSections.delete और channelSections.update तरीके अब onBehalfOfContentOwner पैरामीटर के साथ काम करते हैं. यह पैरामीटर, पहले से ही कई अन्य तरीकों के साथ काम करता है.

• इन प्रॉपर्टी और इनकी चाइल्ड प्रॉपर्टी को बंद कर दिया गया है:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  ध्यान दें: इनमें से किसी भी प्रॉपर्टी पर, एपीआई बंद करने से जुड़ी नीति लागू नहीं हुई थी.

• video रिसॉर्स की नई contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons प्रॉपर्टी से, यह पता चलता है कि वीडियो को डीजेसीक्यूटी (ब्राज़ील) रेटिंग क्यों मिली.

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

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  notFound (404)	channelNotFound	अगर अनुरोध के id पैरामीटर में ऐसा चैनल बताया गया है जो नहीं मिल सकता, तो channels.update तरीके से यह गड़बड़ी दिखती है.
  badRequest (400)	manualSortRequiredinvalidValue	अगर अनुरोध में प्लेलिस्ट आइटम की पोज़िशन सेट करने की कोशिश की जाती है, लेकिन प्लेलिस्ट में मैन्युअल तरीके से क्रम लगाने की सुविधा का इस्तेमाल नहीं किया जाता है, तो playlistItems.insert और playlistItems.update तरीके यह गड़बड़ी दिखाते हैं. उदाहरण के लिए, प्लेलिस्ट के आइटम को तारीख या लोकप्रियता के हिसाब से क्रम में लगाया जा सकता है. अनुरोध के मुख्य हिस्से में भेजे गए स��साधन से snippet.position एलिमेंट को हटाकर, इस गड़बड़ी को ठीक किया जा सकता है. अगर आपको प्लेलिस्ट में मौजूद किसी आइटम को सूची में किसी खास जगह पर रखना है, तो आपको पहले प्लेलिस्ट के क्रम की सेटिंग को मैन्युअल पर अपडेट करना होगा. इस सेटिंग को YouTube वीडियो मैनेजर में जाकर बदला जा सकता है.
  forbidden (403)	channelClosed	अगर अनुरोध के channelId पैरामीटर में ऐसा चैनल बताया गया है जिसे बंद कर दिया गया है, तो playlists.list तरीके से यह गड़बड़ी दिखती है.
  forbidden (403)	channelSuspended	अगर अनुरोध के channelId पैरामीटर में ऐसे चैनल के बारे में बताया गया है जिसे निलंबित कर दिया गया है, तो playlists.list तरीके से यह गड़बड़ी दिखती है.
  forbidden (403)	playlistForbidden	अगर अनुरोध का id पैरामीटर, अनुरोध के साथ काम नहीं करता है या अनुरोध को ठीक से अनुमति नहीं दी गई है, तो playlists.list तरीके से यह गड़बड़ी दिखती है.
  notFound (404)	channelNotFound	अगर अनुरोध के channelId पैरामीटर में ऐसा चैनल बताया गया है जो नहीं मिल सकता, तो playlists.list तरीके से यह गड़बड़ी दिखती है.
  notFound (404)	playlistNotFound	अगर अनुरोध के id पैरामीटर में ऐसी प्लेलिस्ट के बारे में बताया गया है जो नहीं मिल रही है, तो playlists.list मेथड यह गड़बड़ी दिखाता है.
  notFound (404)	videoNotFound	अगर अनुरोध के id पैरामीटर में ऐसा वीडियो दिया गया है जो नहीं मिल रहा है, तो videos.list तरीके से यह गड़बड़ी दिखती है.
  badRequest (400)	invalidRating	अगर अनुरोध में rating पैरामीटर के लिए कोई ऐसी वैल्यू शामिल है जिसकी उम्मीद नहीं थी, तो videos.rate तरीके से यह गड़बड़ी दिखती है.

2 मार्च, 2015

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

• search.list तरीके में अब relevanceLanguage पैरामीटर काम करता है. इसकी मदद से, किसी भाषा के हिसाब से सबसे ज़्यादा काम के नतीजे पाने का अनुरोध किया जा सकता है.

  YouTube Data API (v3) को माइग्रेट करने से जुड़ी गाइड को भी अपडेट किया गया है. इसमें बताया गया है कि इस नए पैरामीटर का इस्तेमाल कैसे करें. यह पैरामीटर, एपीआई के मौजूदा वर्शन (v3) और पिछले वर्शन (v2) के बीच मौजूद सुविधा से जुड़ी समस्या को ठीक करता है. हालांकि, पिछले वर्शन को पहले ही बंद कर दिया गया है.

• YouTube Data API (v3) माइग्रेशन गाइड को भी अपडेट किया गया है. इसमें यह बताया गया है कि खास फ़ीड और मेटाडेटा फ़ील्ड अब काम नहीं करेंगे. v2 API, फ़िल्मों, ट्रेलर, टेलीविज़न शो, टेलीविज़न सीज़न, और टेलीविज़न एपिसोड के बारे में जानकारी देने के लिए इनका इस्तेमाल करता था.

14 जनवरी, 2015

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

• YouTube Data API (v3) माइग्रेशन गाइड को अपडेट किया गया है. इसमें बताया गया है कि JavaScript का इस्तेमाल करके वी��ियो अपलोड करने के लिए, v3 API का इस्तेमाल कैसे करें. (ज़्यादा जानकारी के लिए, वीडियो अपलोड करना सेक्शन देखें.) यह सुविधा, ब्राउज़र पर आधारित अपलोड करने की सुविधा के जैसी है. यह सुविधा, v2 API के साथ काम करती है. ध्यान दें कि माइग्रेशन गाइड में हुए इस बदलाव से, एपीआई में कोई बदलाव नहीं हुआ है. हालांकि, क्लाइंट-साइड JavaScript का इस्तेमाल करके वीडियो अपलोड करने के लिए, नया सैंपल कोड उपलब्ध कराया गया है.

  JavaScript क्लाइंट लाइब्रेरी और सीओआरएस की मदद से वीडियो अपलोड करने की सुविधा उपलब्ध है. इसलिए, माइग्रेशन गाइड में अब ब्राउज़र पर आधारित अपलोड करने की सुविधा को ऐसी सुविधा के तौर पर नहीं दिखाया गया है जिसे v3 API में बंद किया जा सकता है.

• videos.insert तरीके के दस्तावेज़ को अपडेट कर दिया गया है, ताकि इसमें ऊपर बताया गया नया JavaScript कोड सैंपल शामिल किया जा सके. YouTube Data API (v3) के लिए, JavaScript कोड के सैंपल की सूची को भी अपडेट किया गया है.

11 नवंबर, 2014

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

• search.list तरीके को कॉल करने के लिए, कोटा की लागत 100 यूनिट हो गई है.

  अहम जानकारी: कई मामलों में, कम कोटे की लागत पर जानकारी पाने के लिए, एपीआई के अन्य तरीकों का इस्तेमाल किया जा सकता है. उदाहरण के लिए, GoogleDevelopers चैनल पर अपलोड किए गए वीडियो ढूंढने के इन दो तरीकों पर विचार करें.

  • कोटे की लागत: 100 यूनिट

    search.list वाले तरीके को कॉल करें और GoogleDevelopers खोजें.

  • कोटे की लागत: 6 यूनिट

    सही चैनल आईडी ढूंढने के लिए, channels.list वाले तरीके को कॉल करें. forUsername पैरामीटर को GoogleDevelopers और part पैरामीटर को contentDetails पर सेट करें. एपीआई के जवाब में, contentDetails.relatedPlaylists.uploads प्रॉपर्टी से चैनल पर अपलोड किए गए वीडियो के लिए प्लेलिस्ट आईडी का पता चलता है.

    इसके बाद, playlistItems.list तरीके को कॉल करें. साथ ही, कैप्चर किए गए आईडी के लिए playlistId पैरामीटर और snippet के लिए part पैरामीटर सेट करें.

8 अक्टूबर, 2014

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

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

  • status.longUploadsStatus प्रॉपर्टी से पता चलता है कि चैनल, 15 मिनट से ज़्यादा अवधि वाले वीडियो अपलोड करने की ज़रूरी शर्तें पूरी करता है या नहीं. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब चैनल के मालिक ने एपीआई अनुरोध को अनुमति दी हो. प्रॉपर्टी की मान्य वैल्यू ये हैं:

    • allowed – चैनल पर 15 मिनट से ज़्यादा अवधि वाले वीडियो अपलोड किए जा सकते हैं.
    • eligible – चैनल पर 15 मिनट से ज़्यादा अवधि के वीडियो अपलोड किए जा सकते हैं. हालांकि, इसके लिए पहले इस सुविधा को चालू करना होगा.
    • disallowed – चैनल पर 15 मिनट से ज़्यादा अवधि के वीडियो अपलोड नहीं किए जा सकते.

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

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

• video संसाधन की snippet.title और snippet.categoryId प्रॉपर्टी की परिभाषाओं को अपडेट किया गया है. इससे यह साफ़ तौर पर पता चलता है कि एपीआई, videos.update तरीके के कॉल को कैसे हैंडल करता है. अगर आपको video रिसॉर्स के snippet हिस्से को अपडेट करने के लिए उस तरीके का इस्तेमाल करना है, तो आपको उन दोनों प्रॉपर्टी के लिए वैल्यू सेट करनी होगी.

  अगर video रिसॉर्स के snippet हिस्से को अपडेट करने की कोशिश की जाती है और उन दोनों प्रॉपर्टी के लिए कोई वैल्यू सेट नहीं की जाती है, तो एपीआई invalidRequest गड़बड़ी दिखाता है. उस गड़बड़ी के बारे में दी गई जानकारी को भी अपडेट कर दिया गया है.

• video संसाधन की contentDetails.contentRating.oflcRating प्रॉपर्टी, न्यूज़ीलैंड के ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन से वीडियो की रेटिंग की पहचान करती है. अब यह दो नई रेटिंग के साथ काम करती है: oflcRp13 और oflcRp16. ये RP13 और RP16 रेटिंग के हिसाब से होते हैं.

• channelBanners.insert तरीके में अब यह गड़बड़ी ठीक की जा सकती है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	bannerAlbumFull	चैनल के मालिक के YouTube चैनल आर्ट एल्बम में तय सीमा से ज़्यादा इमेज हैं. चैनल के मालिक को http://photos.google.com पर जाना चाहिए. इसके बाद, एल्बम पेज पर जाकर, उस एल्बम से कुछ इमेज हटानी चाहिए.

12 सितंबर, 2014

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

• search.list तरीके को कॉल करने के लिए, कोटा की लागत को 1 यूनिट से बदलकर 2 यूनिट कर दिया गया है. इसके अलावा, तय किए गए संसाधन के हिस्सों की लागत भी देनी होगी.

13 अगस्त, 2014

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

• subscriptions.insert तरीके में अब यह गड़बड़ी ठीक की जा सकती है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	subscriptionLimitExceeded	अनुरोध करने वाले व्यक्ति ने सदस्यता के लिए तय सीमा पार कर ली है. कुछ घंटों बाद, अन्य सदस्यताएं ली जा सकती हैं.

12 अगस्त, 2014

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

• अपने ऐप्लिकेशन को YouTube Data API (v3) पर माइग्रेट करना नाम की नई गाइड में बताया गया है कि YouTube Data API (v3) का इस्तेमाल करके, YouTube Data API (v2) में उपलब्ध सुविधाओं को कैसे इस्तेमाल किया जा सकता है. पुराने एपीआई को आधिकारिक तौर पर 4 मार्च, 2014 को बंद कर दिया गया था. इस गाइड का मकसद, उन ऐप्लिकेशन को माइग्रेट करने में आपकी मदद करना है जो अब भी v2 API का इस्तेमाल कर रहे हैं. इन ऐप्लिकेशन को एपीआई के सबसे नए वर्शन पर माइग्रेट किया जा सकता है.

8 जुलाई, 2014

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

• playlists.insert तरीके में अब यह गड़बड़ी ठीक की जा सकती है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	maxPlaylistExceeded	यह गड़बड़ी तब होती है, जब किसी चैनल में प्लेलिस्ट बनाने की तय सीमा पूरी हो जाती है.

18 जून, 2014

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

• हर एपीआई तरीके के ब्यौरे ��ो अपडेट किया गया है, ताकि उस तरीके को कॉल करने पर लगने वाले कोटे की लागत को शामिल किया जा सके. इसी तरह, part पैरामीटर की परिभाषाओं को अपडेट किया गया है, ताकि एपीआई कॉल में वापस पाए जा सकने वाले हर हिस्से की कोटा लागत के बारे में बताया जा सके. उदाहरण के लिए, subscriptions.insert तरीके को कॉल करने पर, कोटा की लागत करीब 50 यूनिट होती है. subscription संसाधन में भी तीन हिस्से (snippet, contentDetails, और subscriberSnippet) होते हैं. इनमें से हर हिस्से की लागत दो यूनिट होती है.

  कृपया ध्यान रखें कि कोटे की लागत में बिना किसी सूचना के बदलाव किया जा सकता है.

• video संसाधन में अब कॉन्टेंट रेटिंग के 43 नए सिस्टम काम करते हैं. इनसे यह पता चलता है कि वीडियो को अलग-अलग देशों की रेटिंग एजेंसियों से कौनसी रेटिंग मिली हैं. जिन देशों/इलाकों के लिए रेटिंग सिस्टम उपलब्ध हैं वे ये हैं: अर्जेंटीना, ऑस्ट्रिया, बेल्जियम, बुल्गारिया, चिली (टेलीविज़न), चिली (फ़िल्म), चेक गणराज्य, कोलंबिया, डेनमार्क, मिस्र, एस्टोनिया, फ़िनलैंड, फ़्रांस, ग्रीस, हॉन्ग कॉन्ग, आइसलैंड, इंडोनेशिया, आयरलैंड, इज़रायल, इटली, केन्या, लातविया, लक्ज़मबर्ग, मलेशिया, मालदीव, माल्टा, नीदरलैंड्स, नाइजीरिया, नॉर्वे, पेरू, फ़िलिपींस, पुर्तगाल, रोमानिया, सिंगापुर, स्लोवाकिया, दक्षिण अफ़्रीका, स्वीडन, स्विट्ज़रलैंड, ताइवान, थाइलैंड, और वेनेज़ुएला.

28 मई, 2014

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

• search.list तरीके में अब location और locationRadius पैरामीटर काम करते हैं. इनकी मदद से, किसी भौगोलिक जगह से जुड़े वीडियो खोजे जा सकते हैं. जगह के हिसाब से नतीजे पाने के लिए, अनुरोध में दोनों पैरामीटर की वैल्यू तय करनी होगी. अगर किसी अनुरोध में सिर्फ़ एक पैरामीटर शामिल है, तो एपीआई गड़बड़ी का मैसेज दिखाएगा.

  • location पैरामीटर, गोलाकार भौगोलिक क्षेत्र के केंद्र में मौजूद अक्षांश/देशांतर के निर्देशांकों के बारे में बताता है.

  • locationRadius पैरामीटर से पता चलता है कि किसी वीडियो से जुड़ी जगह, खोज के नतीजों में शामिल होने के लिए, उस इलाके के सेंटर से कितनी दूर हो सकती है.

13 मई, 2014

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

• channel संसाधन की invideoPromotion.items[] प्रॉपर्टी को अपडेट किया गया है. इसमें बताया गया है कि आम तौर पर, अपने चैनल के लिए सिर्फ़ एक प्रमोशन वाला आइटम सेट किया जा सकता है. अगर बहुत सारे प्रमोट किए गए आइटम डालने की कोशिश की जाती है, तो एपीआई tooManyPromotedItems गड़बड़ी दिखाएगा. इसमें एचटीटीपी 400 स्टेटस कोड होता है.

• channelSection संसाधन में अब चुनिंदा कॉन्टेंट के कुछ नए टाइप के बारे में जानकारी शामिल की जा सकती है. channelSection संसाधन की snippet.type प्रॉपर्टी के लिए, अब इन वैल्यू का इस्तेमाल किया जा सकता है:

  • postedPlaylists - चैनल के मालिक ने चैनल की गतिविधि फ़ीड में ये प्लेलिस्ट पोस्ट की हैं
  • postedVideos - ऐसे वीडियो जिन्हें चैनल के मालिक ने चैनल की गतिविधि फ़ीड में पोस्ट किया है
  • subscriptions - ऐसे चैनल जिनकी सदस्यता चैनल के मालिक ने ली है

• video संसाधन की नई contentDetails.contentRating.ifcoRating प्रॉपर्टी से, उस रेटिंग की पहचान होती है जो किसी वीडियो को Irish Film Classification Office से मिली है.

• watermark संसाधन position.cornerPosition प्रॉपर्टी की परिभाषा ��ो अपडेट किया गया है. इसमें बताया गया है कि वॉटरमार्क हमेशा प्लेयर के सबसे ऊपर दाएं कोने में दिखता है.

• search.list तरीके के लिए q पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि क्वेरी टर्म, बूलियन NOT (-) ऑपरेटर का इस्तेमाल करके, किसी खास सर्च टर्म से जुड़े वीडियो को बाहर रख सकता है. वैल्यू में बूलियन OR (|) ऑपरेटर का इस्तेमाल करके, खोज के लिए डाले गए कई शब्दों में से किसी एक से जुड़े वीडियो भी ढूंढे जा सकते हैं.

• search.list कॉल के लिए एपीआई से मिले जवाब में, pageInfo.totalResults प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि वैल्यू अनुमानित है और यह सटीक वैल्यू नहीं हो सकती. इसके अलावा, ज़्यादा से ज़्यादा वैल्यू 1,000,000 हो सकती है. पेज नंबर वाले लिंक बनाने के लिए, इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए. इसके बजाय, nextPageToken और prevPageToken प्रॉपर्टी की वैल्यू का इस्तेमाल करके यह तय करें कि पेज नंबर वाले लिंक दिखाने हैं या नहीं.

• watermarks.set और watermarks.unset तरीकों को अपडेट किया गया है. इससे पता चलता है कि एपीआई, इन तरीकों के लिए किए गए अनुरोधों के पूरा होने पर, एचटीटीपी 204 रिस्पॉन्स कोड दिखाता है.

2 मई, 2014

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

• नई i18nLanguage संसाधन, ऐप्लिकेशन की उस भाषा की पहचान करता है जिसे YouTube की वेबसाइट पर इस्तेमाल किया जा सकता है. ऐप्लिकेशन की भाषा को यूज़र इंटरफ़ेस (यूआई) की भाषा भी कहा जा सकता है. YouTube की वेबसाइट के लिए, Google खाते की सेटिंग, ब्राउज़र की भाषा या आईपी पते की जगह की जानकारी के आधार पर, ��प्लिकेशन की भाषा ������े-आ�� �������� जा सकती है. इसके अलावा, उपयोगकर्ता YouTube की साइट के फ़ुटर से, यूज़र इंटरफ़ेस (यूआई) की भाषा को मैन्युअल तरीके से भी चुन सकता है.

  एपीआई, ऐप्लिकेशन में इस्तेमाल की जा सकने वाली भाषाओं की सूची बनाने का तरीका उपलब्ध कराता है. एपीआई के videoCategories.list और guideCategories.list जैसे तरीकों को कॉल करते समय, इस्तेमाल की जा सकने वाली भाषाओं को hl पैरामीटर की वैल्यू के तौर पर इस्तेमाल किया जा सकता है.

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

  यह एपीआई, कॉन्टेंट के लिए उपलब्ध क्षेत्रों की सूची बनाने का तरीका उपलब्ध कराता है. एपीआई के तरीकों को कॉल करते समय, regionCode पैरामीटर की वैल्यू के तौर पर, उपलब्धता वाले देश या इलाके के कोड का इस्तेमाल किया जा सकता है. जैसे, search.list, videos.list, activities.list, और videoCategories.list.

7 अप्रैल, 2014

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

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

  एपीआई, चैनल के सेक्शन को सूचीबद्ध करने, जोड़ने, अपडेट करने या मिटाने के तरीकों के साथ काम करता है. किसी खास चैनल आईडी या चैनल सेक्शन के यूनीक आईडी की सूची देकर, पुष्टि किए गए उपयोगकर्ता के चैनल के लिए चैनल के सेक्शन की सूची वा��स पाई जा सकती है.

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

• video रिसॉर्स के fileDetails ऑब्जेक्ट की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि यह ऑब्जेक्ट सिर्फ़ तब दिखेगा, जब वीडियो की processingDetails.fileDetailsAvailability प्रॉपर्टी की वैल्यू available होगी.

  इसी तरह, video संसाधन के suggestions ऑब्जेक्ट की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि उस ऑब्जेक्ट को सिर्फ़ तब दिखाया जाएगा, जब वीडियो की processingDetails.tagSuggestionsAvailability प्रॉपर्टी या उसकी processingDetails.editorSuggestionsAvailability प्रॉपर्टी की वैल्यू available हो.

• videos.insert और videos.update तरीकों के दस्तावेज़ को अपडेट किया गया है. इससे पता चलता है कि इन तरीकों को कॉल करते समय, status.publishAt प्रॉपर्टी सेट की जा सकती है.

• channel संसाधन के invideoPromotion ऑब्जेक्ट की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि ऑब्जेक्ट को सिर्फ़ चैनल का मालिक ही वापस पा सकता है.

• videos.rate मेथड के लिए पैरामीटर की सूची को अपडेट कर दिया गया है. इससे पता चलता है कि यह मेथड, onBehalfOfContentOwner पैरामीटर के साथ काम नहीं करता. यह दस्तावेज़ से जुड़ी गड़बड़ी थी, क्योंकि इस पैरामीटर को सेट करने वाले videos.rate अनुरोधों में 500 गड़बड़ी दिखती है.

31 मार्च, 2014

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

• video संसाधन की नई status.publishAt प्रॉपर्टी की मदद से, यह तय किया जा सकता है कि किसी निजी वीडियो को किस तारीख और समय पर पब्लिश किया जाएगा. इस प्रॉपर्टी को सिर्फ़ तब सेट किया जा सकता है, जब वीडियो का निजता स्टेटस private पर सेट हो और वीडियो को कभी पब्लिश न किया गया हो. इस नई प्रॉपर्टी पर, इस्तेमाल बंद करने से जुड़ी नीति लागू नहीं होती.

13 मार्च, 2014

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

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

• दस्तावेज़ में अब इन प्रॉपर्टी के लिए, इस्तेमाल किए जा सकने वाले वर्णों की ज़्यादा से ज़्यादा संख्या दी गई है:

  संसाधन	प्रॉपर्टी	ज़्यादा से ज़्यादा लंबाई
  channel	invideoPromotion.items[].customMessage	40 वर्ण
  video	snippet.title	100 वर्ण
  video	snippet.description	5,000 बाइट
  video	snippet.tags	500 वर्ण. ध्यान दें कि प्रॉपर्टी की वैल्यू एक सूची होती है. साथ ही, सूची में मौजूद आइटम के बीच मौजूद कॉमा, सीमा में गिने जाते हैं.

• channel संसाधन की brandingSettings.watch.featuredPlaylistId प्रॉपर्टी अब काम नहीं करती है. अगर आपने इसकी वैल्यू सेट करने की कोशिश की, तो एपीआई गड़बड़ी का मैसेज दिखाएगा.

• वीडियो जोड़ते या अपडेट करते समय सेट की जा सकने वाली वैल्यू की सूची में, video संसाधन की ये प्रॉपर्टी जोड़ी गई हैं:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

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

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

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest (400)	invalidCriteria	अगर अनुरोध में ऐसे फ़िल्टर पैरामीटर दिए गए हैं जिनका एक साथ इस्तेमाल नहीं किया जा सकता, तो channels.list तरीके से यह गड़बड़ी दिखती है.
  badRequest (400)	channelTitleUpdateForbidden	अगर किसी चैनल के brandingSettings हिस्से को अपडेट करने और brandingSettings.channel.title प्रॉपर्टी की वैल्यू बदलने की कोशिश की जाती है, तो channels.update तरीके से यह गड़बड़ी दिखती है. (ध्यान दें कि प्रॉपर्टी को शामिल न करने पर, एपीआई गड़बड़ी का मैसेज नहीं दिखाता है.)
  badRequest (400)	invalidRecentlyUploadedBy	अगर invideoPromotion.items[].id.recentlyUploadedBy प्रॉपर्टी में अमान��य चैनल आईडी दिया गया है, तो channels.update तरीके से यह गड़बड़ी दिखती है.
  badRequest (400)	invalidTimingOffset	अगर invideoPromotion वाले हिस्से में टाइमिंग का अमान्य ऑफ़सेट दिया गया है, तो channels.update वाला तरीका यह गड़बड़ी दिखाता है.
  badRequest (400)	tooManyPromotedItems	अगर invideoPromotion वाले हिस्से में, प्रमोशन वाले प्रॉडक्ट की तय सीमा से ज़्यादा प्रॉडक्ट शामिल किए गए हैं, तो channels.update तरीके से यह गड़बड़ी दिखती है.
  forbidden (403)	promotedVideoNotAllowed	अगर invideoPromotion.items[].id.videoId प्रॉपर्टी में ऐसा वीडियो आईडी दिया गया है जिसे न तो ढूंढा जा सकता है और न ही प्रमोट किए गए आइटम के तौर पर इस्तेमाल किया जा सकता है, तो channels.update तरीके से यह गड़बड़ी दिखती है.
  forbidden (403)	websiteLinkNotAllowed	अगर invideoPromotion.items[].id.websiteUrl प्रॉपर्टी में ऐसा यूआरएल दिया गया है जिसका इस्तेमाल करने की अनुमति नहीं है, तो channels.update तरीके से यह गड़बड़ी दिखती है.
  required (400)	requiredTimingType	अगर किसी अनुरोध में, YouTube पर प्रमोट किया गया आइटम दिखाने के लिए डिफ़ॉल्ट टाइमिंग सेटिंग नहीं दी गई हैं, तो channels.update तरीके से यह गड़बड़ी दिखती है.
  required (400)	requiredTiming	channels.update तरीके में, प्रमोट किए गए हर आइटम के लिए invideoPromotion.items[].timing ऑब्जेक्ट की जानकारी देना ज़रूरी है.
  required (400)	requiredWebsiteUrl	channels.update तरीके में, प्रमोट किए गए हर आइटम के लिए invideoPromotion.items[].id.websiteUrl प्रॉपर्टी की जानकारी देनी होगी.
  badRequest (400)	invalidPublishAt	अगर अनुरोध के मेटाडेटा में, शेड्यूल किए गए पब्लिशिंग का अमान्य समय बताया गया है, तो videos.insert वाला तरीका यह गड़बड़ी दिखाता है.

4 मार्च, 2014

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

• YouTube Data API v3 पर अब YouTube API की सेवा की शर्तों में बताई गई, बंद की जा रही सुविधाओं से जुड़ी नीति लागू होगी. ध्यान दें कि एपीआई के बंद होने से जुड़ी नीति के दायरे में आने वाले एपीआई की सूची वाले पेज पर, नीति के दायरे से v3 API की कुछ सुविधाओं को खास तौर पर बाहर रखा गया है.

5 दिसंबर, 2013

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

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

• search.list तरीके के पैरामीटर की परिभाषाओं को अपडेट किया गया है. इसमें ब��ाया गया है कि अगर आपको इनमें से किसी भी पैरामीटर के लिए वैल्यू तय करनी है, तो आपको type पैरामीटर की वैल्यू को video पर सेट करना होगा:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• अपलोड की गई चैनल बैनर इमेज का कम से कम साइज़, 2048 पिक्सल x 1152 पिक्सल कर दिया गया है. (इससे पहले, कम से कम साइज़ 2120 पिक्सल x 1192 पिक्सल था.) इसके अलावा, ध्यान दें कि channel संसाधन के दस्तावेज़ में, एपीआई से दिखाए जाने वाले सभी बैनर इमेज के ज़्यादा से ज़्यादा साइज़ के बारे में बताया गया है. उदाहरण के लिए, टीवी ऐप्लिकेशन के लिए brandingSettings.image.bannerTvImageUrl इमेज का ज़्यादा से ज़्यादा साइज़ 2120 पिक्सल x 1192 पिक्सल होता है. हालांकि, असल इमेज 2048 पिक्सल x 1152 पिक्सल की हो सकती है. YouTube सहायता केंद्र में, अलग-अलग तरह के डिवाइसों पर दिखाने के लिए चैनल आर्ट को ऑप्टिमाइज़ करने के बारे में ज़्यादा जानकारी दी गई है.

• channel संसाधन प्रॉपर्टी की कई परिभाषाओं को अपडेट किया गया है, ताकि यह जानकारी दिखाई जा सके:

  • brandingSettings.channel.description प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 1,000 वर्ण हो सकते हैं.
  • brandingSettings.channel.featuredChannelsTitle प्रॉपर्टी में ज़्यादा से ज़्यादा 30 वर्ण हो सकते हैं.
  • brandingSettings.channel.featuredChannelsUrls[] प्रॉपर्टी में अब ज़्यादा से ज़्यादा 100 चैनल जोड़े जा सकते हैं.
  • अगर brandingSettings.channel.unsubscribedTrailer प्रॉपर्टी की वैल्यू सेट की गई है, तो उसमें सार्वजनिक या सबके लिए मौजूद नहीं के तौर पर सेट किए गए ऐसे वीडियो का YouTube वीडियो आईडी होना चाहिए जिसका मालिकाना हक चैनल के मालिक के पास हो.

• channels.update तरीके से अब invideoPromotion.items[].promotedByContentOwner प्रॉपर्टी को अपडेट किया जा सकता है. इस प्रॉपर्टी से पता चलता है कि प्रमोशन दिखाते समय, कॉन्टेंट के मालिक का नाम दिखेगा या नहीं. इसे सिर्फ़ तब सेट किया जा सकता है, जब प्रॉपर्टी की वैल्यू सेट करने वाला एपीआई अनुरोध, कॉन्टेंट के मालिक की ओर से onBehalfOfContentOwner पैरामीटर का इस्तेमाल करके किया जा रहा हो.

• playlistItems.list और playlistItems.insert तर���के अब onBehalfOfContentOwner पैरामीटर के साथ काम करते हैं. यह पैरामीटर, पहले से ही कई अन्य तरीकों के साथ काम करता है.

• contentDetails.contentRating.acbRating प्रॉपर्टी अब फ़िल्मों के लिए ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी) या बच्चों के लिए बने टीवी प्रोग्राम के लिए ऑस्ट्रेलियन कम्युनिकेशंस ऐंड मीडिया अथॉरिटी (एसीएमए) से रेटिंग तय कर सकती है.

• नई contentDetails.contentRating.catvRating और contentDetails.contentRating.catvfrRating प्रॉपर्टी, उन रेटिंग की पहचान करती हैं जो किसी वीडियो को कनाडाई टीवी क्लासिफ़िकेशन सिस्टम और फ़्रेंच भाषा के Régie du cinéma रेटिंग सिस्टम के तहत मिली हैं. इन रेटिंग सिस्टम का इस्तेमाल क्रमशः कनाडा और क्यूबेक में किया जाता है.

• videoCategory संसाधन की नई snippet.assignable प्रॉपर्टी से पता चलता है कि अपडेट किए गए वीडियो या नए अपलोड किए गए वीडियो को उस वीडियो कैटगरी से जोड़ा जा सकता है या नहीं.

• इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:

  • activities.insert (Go)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Go)
  • search.list (Go)
  • thumbnails.set (Java)
  • videos.insert (Go)

24 अक्टूबर, 2013

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

• एपीआई में दो और सुविधाएं शामिल की गई हैं. इन्हें लाइव ब्रॉडकास्ट कॉन्टेंट ढूंढने और उसे दिखाने में मदद करने के लिए डिज़ाइन किया गया है:

  खोज के नतीजों में मौजूद नई snippet.liveBroadcastContent प्रॉपर्टी से पता चलता है कि किसी वीडियो या चैनल संसाधन में लाइव ब्रॉडकास्ट कॉन्टेंट है या नहीं. प्रॉपर्टी की मान्य वैल्यू upcoming, active, और none हैं.

  • video संसाधन की नई snippet.liveBroadcastContent प्रॉपर्टी से पता चलता है कि वीडियो, आने वाले समय में होने वाला लाइव ब्रॉडकास्ट है या अभी लाइव ब्रॉडकास्ट हो रहा है. यहां दी गई सूची में, प्रॉपर्टी की संभावित वैल्यू के बारे में बताया गया है:

    • upcoming – वीडियो एक लाइव ब्रॉडकास्ट है, जो अभी शु��ू नहीं हुआ है.
    • active – वीडियो, लाइव ब्रॉडकास्ट किया जा रहा है.
    • none – वीडियो, आने वाले समय में होने वाला या अभी चल रहा लाइव ब्रॉडकास्ट नहीं है. यह उन ब्रॉडकास्ट के लिए प्रॉपर्टी वैल्यू होगी जिन्हें पूरा कर लिया गया है और जो अब भी YouTube पर देखे जा सकते हैं.

  • video संसाधन की नई liveStreamingDetails प्रॉपर्टी एक ऑब्जेक्ट है. इसमें लाइव वीडियो ब्रॉडकास्ट के बारे में मेटाडेटा होता है. इस मेटाडेटा को वापस पाने के लिए, part पैरामीटर वैल्यू के संसाधन के हिस्सों की सूची में liveStreamingDetails को शामिल करें. मेटाडेटा में ये नई प्रॉपर्टी शामिल हैं:

    • liveStreamingDetails.actualStartTime – ब्रॉडकास्ट शुरू होने का असल समय. (ब्रॉडकास्ट की स्थिति active होने पर, यह वैल्यू मौजूद होगी.)
    • liveStreamingDetails.actualEndTime – ब्रॉडकास्ट के खत्म होने का असल समय. (ब्रॉडकास्ट खत्म होने के बाद, यह वैल्यू दिखेगी.)
    • liveStreamingDetails.scheduledStartTime – ब्रॉडकास्ट शुरू होने का शेड्यूल किया गया समय.
    • liveStreamingDetails.scheduledEndTime – ब्रॉडकास्ट के खत्म होने का शेड्यूल किया गया समय. अगर प्रॉपर्टी की वैल्यू खाली है या प्रॉपर्टी मौजूद नहीं है, तो ब्रॉडकास्ट को अनिश्चित काल के लिए शेड्यूल किया जाता है.
    • liveStreamingDetails.concurrentViewers – लाइव ब्रॉडकास्ट देखने वाले लोगों की संख्या.

    इस मेटाडेटा को वापस पाने के लिए, videos.list, videos.insert या videos.update मेथड को कॉल करते समय, part पैरामीटर की वैल्यू में liveStreamingDetails को शामिल करें.

  ध्यान दें कि लाइव ब्रॉडकास्ट के कॉन्टेंट की पहचान करने के लिए, 1 अक्टूबर, 2013 को दो अन्य सुविधाएं लॉन्च की गई थीं. ये सुविधाएं हैं: search.list तरीके का eventType पैरामीटर और खोज के नतीजों की snippet.liveBroadcastContent प्रॉपर्टी.

• videos.insert तरीके में अब notifySubscribers पैरामीटर काम करता है. इससे यह पता चलता है कि YouTube को उन लोगों को नए वीडियो की सूचना भेजनी चाहिए या नहीं जिन्होंने वीडियो के चैनल की सदस्यता ली है. इस पैरामीटर की डिफ़ॉल्ट वैल्यू True होती है. इसका मतलब है कि सदस्यों को, नए वीडियो अपलोड होने की सूचना मिलेगी. हालांकि, अगर कोई चैनल का मालिक कई वीडियो अपलोड कर रहा है, तो वह वैल्यू को False पर सेट कर सकता है. इससे चैनल के सदस्यों को हर नए वीडियो की सूचना नहीं भेजी जाएगी.

• channels.update तरीके को कॉल करते समय, बदली जा सकने वाली प्रॉपर्टी की सूची को अपडेट कर दिया गया है. इसमें invideoPromotion.items[].customMessage और invideoPromotion.items[].websiteUrl प्रॉपर्टी शामिल हैं. इसके अलावा, सूची में बदलाव किया गया है, ताकि बदली जा सकने वाली brandingSettings प्रॉपर्टी की पहचान की जा सके. इन brandingSettings प्रॉपर्टी में पहले से ही बदलाव किया जा सकता था. इसलिए, दस्तावेज़ में किए गए बदलाव से, एपीआई की मौजूदा सुविधा में कोई बदलाव नहीं होता.

• playlists.insert, playlists.update, और playlists.delete तरीकों में अब onBehalfOfContentOwner पैरामीटर का इस्तेमाल किया जा सकता है. इस पैरामीटर का इस्तेमाल पहले से ही कई अन्य तरीकों के लिए किया जा सकता है.

• playlists.insert तरीके में अब onBehalfOfContentOwnerChannel पैरामीटर का इस्तेमाल किया जा सकता है. इस पैरामीटर का इस्तेमाल, पहले से ही कई अन्य तरीकों के लिए किया जा सकता है.

• video रिसॉर्स की contentDetails.contentRating.tvpgRating प्रॉपर्टी के लिए अब pg14 वैल्यू का इस्तेमाल किया जा सकता है. यह TV-14 रेटिंग के बराबर है.

• खोज के नतीजों में दिखने वाली snippet.liveBroadcastContent प्रॉपर्टी की परिभाषा को ठीक कर दिया गया है. इससे पता चलता है कि live प्रॉपर्टी की मान्य वैल्यू है, लेकिन active प्रॉपर्टी की मान्य वैल्यू नहीं है.

• video संसाधन की contentDetails.contentRating.mibacRating प्रॉपर्टी के लिए, अब दो और रेटिंग इस्तेमाल की जा सकती हैं:

  • mibacVap (वीएपी) – बच्चों के साथ किसी वयस्क का होना ज़रूरी है.
  • mibacVm6 (वी॰एम॰6) – सिर्फ़ छह साल और उससे ज़्यादा उम्र के लोगों के लिए.
  • mibacVm12 (वी॰एम॰12) – सिर्फ़ 12 साल और इससे ज़्यादा उम्र के लोगों के लिए.

• channel संसाधन की नई invideoPromotion.items[].promotedByContentOwner प्रॉपर्टी से पता चलता है कि प्रमोशन दिखाते समय, कॉन्टेंट के मालिक का नाम दिखेगा या नहीं. इस फ़ील्ड को सिर्फ़ तब सेट किया जा सकता है, जब वैल्यू सेट करने का एपीआई अनुरोध, कॉन्टेंट के मालिक की ओर से किया जा रहा हो. ज़्यादा जानकारी के लिए, onBehalfOfContentOwner पैरामीटर देखें.

1 अक्टूबर, 2013

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

• channel संसाधन के नए auditDetails ऑब्जेक्ट में चैनल का डेटा होता है. इस डेटा का इस्तेमाल करके, मल्टीचैनल नेटवर्क (एमसीएन) यह तय करता है कि किसी चैनल को स्वीकार करना है या नहीं. ध्यान दें कि इस संसाधन के हिस्से ��ो वापस पाने के लिए, एपीआई के किसी भी अनुरोध में अनुमति वाला टोकन होना चाहिए. इसमें https://www.googleapis.com/auth/youtubepartner-channel-audit स्कोप शामिल होना चाहिए. इसके अलावा, अगर एमसीएन चैनल को स्वीकार या अस्वीकार करने का फ़ैसला करता है, तो उस स्कोप का इस्तेमाल करने वाले किसी भी टोकन को रद्द करना होगा. ऐसा टोकन जारी होने की तारीख के दो हफ़्तों के अंदर करना होगा.

• channel संसाधन की invideoPromotion.items[].id.type प्रॉपर्टी अब recentUpload वैल्यू के साथ काम करती है. इससे पता चलता है कि प्रमोट किया गया आइटम, किसी चैनल पर हाल ही में अपलोड किया गया वीडियो है.

  डिफ़ॉल्ट रूप से, चैनल वही होता है जिसके लिए इन-वीडियो प्रमोशन का डेटा सेट किया गया है. हालांकि, किसी दूसरे चैनल पर हाल ही में अपलोड किए गए वीडियो का प्रमोशन किया जा सकता है. इसके लिए, नई invideoPromotion.items[].id.recentlyUploadedBy प्रॉपर्टी की वैल्यू को उस चैनल के आईडी पर सेट करें.

• channel रिसॉर्स में तीन नई प्रॉपर्टी शामिल हैं – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl. इनसे टीवी ऐप्लिकेशन में चैनल पेजों पर दिखने वाली बैनर इमेज के यूआरएल के बारे में पता चलता है.

• खोज के नतीजों में मौजूद नई snippet.liveBroadcastContent प्रॉपर्टी से पता चलता है कि किसी वीडियो या चैनल संसाधन में लाइव ब्रॉडकास्ट कॉन्टेंट है या नहीं. प्रॉपर्टी की मान्य वैल्यू upcoming, active, और none हैं.

  • video संसाधन के लिए, upcoming वैल्यू का मतलब है कि वीडियो एक ऐसा लाइव ब्रॉडकास्ट है जो अभी शुरू नहीं हुआ है. वहीं, active वैल्यू का मतलब है कि वीडियो एक ऐसा लाइव ब्रॉडकास्ट है जो अभी चल रहा है.
  • channel रिसॉर्स के लिए, upcoming वैल्यू का मतलब है कि चैनल पर शेड्यूल किया गया ब्रॉडकास्ट अभी शुरू नहीं हुआ है. वहीं, acive वैल्यू का मतलब है कि चैनल पर लाइव ब्रॉडकास्ट चल रहा है.

• watermark संसाधन में, targetChannelId प्रॉपर्टी को ऑब्जेक्ट से बदलकर स्ट्रिंग कर दिया गया है. वॉटरमार्क इमेज जिस चैनल से लिंक होती है उसकी चाइल्ड प्रॉपर्टी में, उस चैनल का YouTube चैनल आईडी होता है. हालांकि, अब targetChannelId प्रॉपर्टी में ही यह वैल्यू मौजूद होती है. इसलिए, संसाधन की targetChannelId.value प्रॉपर्टी को हटा दिया गया है.

• thumbnails.set तरीके में अब onBehalfOfContentOwner पैरामीटर का इस्तेमाल किया जा सकता है. इस पैरामीटर का इस्तेमाल, पहले से ही कई अन्य तरीकों के लिए किया जा सकता है.

• search.list तरीके में अब eventType पैरामीटर काम करता है. इससे खोज के नतीजों में सिर्फ़ चालू, आने वाले या पूरे हो चुके ब्रॉडकास्ट इवेंट दिखते हैं.

• नई contentDetails.contentRating.mibacRating प्रॉपर्टी से पता चलता है कि किसी वीडियो को इटली के Ministero dei Beni e delle Attivita Culturali e del Turismo से कौनसी रेटिंग मिली है.

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

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	invalidImage	अगर दी गई इमेज का कॉन्टेंट अमान्य है, तो thumbnails.set तरीके से यह गड़बड़ी दिखती है.
  forbidden	videoRatingDisabled	अगर वीडियो के मालिक ने रेटिंग की सुविधा बंद कर दी है, तो videos.rate तरीके से यह गड़बड़ी दिखती है.

27 अगस्त, 2013

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

• नई watermark संसाधन फ़ाइल, किसी चैनल के वीडियो चलाने के दौरान दिखने वाली इमेज की पहचान करती है. आपके पास टारगेट चैनल तय करने का विकल्प भी होता है. इससे यह तय किया जा सकता है कि इमेज किस चैनल से लिंक होगी. साथ ही, आपके पास यह तय करने का विकल्प भी होता है कि वीडियो चलाने के दौरान वॉटरमार्क कब दिखेगा और कितनी देर तक दिखेगा.

  watermarks.set तरीके से, चैनल के वॉटरमार्क की इमेज अपलोड की जाती है और उसे सेट किया जाता है. watermarks.unset तरीके से, चैनल के वॉटरमार्क की इमेज मिटाई जाती है.

  गड़बड़ी के दस्तावेज़ में, उन गड़बड़ी के मैसेज के बारे में बताया गया है जो एपीआई, खास तौर पर watermarks.set और watermarks.unset तरीकों के लिए इस्तेमाल करता है.

• channel संसाधन की नई statistics.hiddenSubscriberCount प्रॉपर्टी में एक बूलियन वैल्यू होती है. इससे पता चलता है कि चैनल के सदस्यों की संख्या छिपी हुई है या नहीं. इसलिए, अगर चैनल के सदस्यों की संख्या सार्वजनिक तौर पर दिखती है, तो प्रॉपर्टी की वैल्यू false होती है.

• playlists.list तरीके में अब onBehalfOfContentOwner और onBehalfOfContentOwnerChannel पैरामीटर इस्तेमाल किए जा सकते हैं. ये दोनों पैरामीटर, पहले से ही कई अन्य तरीकों के लिए काम करते हैं.

• videos.list तरीके में अब regionCode पैरामीटर काम करता है. यह पैरामीटर, उस कॉन्टेंट क्षेत्र की पहचान करता है जिसके लिए चार्ट को वापस पाना है. इस पैरामीटर का इस्तेमाल सिर्फ़ chart पैरामीटर के साथ किया जा सकता है. इस पैरामीटर की वैल्यू, ISO 3166-1 alpha-2 देश का कोड है.

• error documentation में, अनुरोध से जुड़ी इस नई सामान्य गड़बड़ी के बारे में बताया गया है. यह गड़बड़ी, कई एपीआई तरीकों के लिए हो सकती है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  forbidden	insufficientPermissions	अनुरोध के लिए दिए गए OAuth 2.0 टोकन से जुड़े स्कोप, अनुरोध किए गए डेटा को ऐक्सेस करने के लिए काफ़ी नहीं हैं.

15 अगस्त, 2013

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

• channel रिसॉर्स के invideoPromotion ऑब्जेक्ट में, ये नई और अपडेट की गई प्रॉपर्टी मौजूद हैं:

  • अब एपीआई की मदद से, किसी वेबसाइट को प्रमोट किए गए आइटम के तौर पर सेट किया जा सकता है. इसके लिए, invideoPromotion.items[].id.type प्रॉपर्टी की वैल्यू को website पर सेट करें. साथ ही, यूआरएल की जानकारी देने के लिए नई invideoPromotion.items[].id.websiteUrl प्रॉपर्टी का इस्तेमाल करें. प्रमोशन के लिए, कस्टम मैसेज दिखाने के लिए नई invideoPromotion.items[].customMessage प्रॉपर्टी का भी इस्तेमाल करें.

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

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

  • वीडियो चलाने के दौरान प्रमोट किए गए आइटम दिखाने के लिए, दिखने की अवधि वाली सेटिंग से जुड़ी प्रॉपर्टी को फिर से व्यवस्थित किया गया है:

    • invideoPromotion.timing ऑब्जेक्ट को invideoPromotion.items[].timing में ले जाया गया है. इस ऑब्जेक्ट की मदद से, अब invideoPromotion.items[] सूची में शामिल हर प्रमोट किए गए आइटम के लिए, समय के डेटा को पसंद के मुताबिक बनाया जा सकता है.

    • नया invideoPromotion.defaultTiming ऑब्जेक्ट, आपके प्रमोशन के लिए डिफ़ॉल्ट टाइमिंग सेटिंग तय करता है. इन सेटिंग से यह तय होता है कि आपके चैनल के किसी वीडियो के चलने के दौरान, प्रमोशन वाला आइटम कब दिखेगा. invideoPromotion.items[].timing ऑब्जेक्ट का इस्तेमाल करके, प्रमोट किए गए किसी भी आइटम के लिए डिफ़ॉल्ट समय को बदला जा सकता है.

    • नई invideoPromotion.items[].timing.durationMs प्रॉपर्टी से पता चलता है कि प्रमोशन को कितने समय तक दिखाना है. यह समय मिलीसेकंड में होता है. invideoPromotion.defaultTiming ऑब्जेक्ट में एक durationMs फ़ील्ड भी होता है. यह फ़ील्ड, उस डिफ़ॉल्ट समय के बारे में बताता है जब तक प्रमोट किया गया आइटम दिखेगा.

  • invideoPromotion.items[].type और invideoPromotion.items[].videoId, दोनों प्रॉपर्टी को invideoPromotion.items[].id ऑब्जेक्ट में ट्रांसफ़र कर दिया गया है.

• subscriptions.list तरीके में अब onBehalfOfContentOwner और onBehalfOfContentOwnerChannel पैरामीटर इस्तेमाल किए जा सकते हैं. ये दोनों पैरामीटर, पहले से ही कई अन्य तरीकों के लिए काम करते हैं.

• thumbnails.set अनुरोध के जवाब में, एपीआई ने kind प्रॉपर्टी की वैल्यू को youtube#thumbnailListResponse से बदलकर youtube#thumbnailSetResponse कर दिया है.

• इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:

  • channels.update (Java, Python)
  • playlists.insert (.NET, PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP, Python)

  ध्यान दें कि playlistItems.insert तरीके के लिए Python का उदाहरण भी हटा दिया गया है, क्योंकि अब इस उदाहरण में दिखाई गई सुविधा को videos.rate तरीके से हैंडल किया जाता है.

• error documentation में अनुरोध के कॉन्टेक्स्ट से जुड़ी इस नई गड़बड़ी के बारे में बताया गया है. यह गड़बड़ी, एपीआई के उस तरीके के लिए हो सकती है जो mine अनुरोध पैरामीटर के साथ काम करता है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	invalidMine	mine पैरामीटर का इस्तेमाल उन अनुरोधों में नहीं किया जा सकता जहां पुष्टि किया गया उपयोगकर्ता, YouTube पार्टनर हो. आपको mine पैरामीटर हटाना चाहिए. इसके अलावा, YouTube उपयोगकर्ता के तौर पर पुष्टि करने के लिए, onBehalfOfContentOwner पैरामीटर हटाएं. अगर कॉल किए गए तरीके के लिए onBehalfOfContentOwnerChannel पैरामीटर उपलब्ध है, तो पार्टनर के किसी चैनल के तौर पर काम करें.

8 अगस्त, 2013

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

• YouTube Data API का इस्तेमाल शुरू करना गाइड के कोटा का इस्तेमाल सेक्शन को अपडेट किया गया है. इसमें वीडियो अपलोड करने के कोटा की लागत में बदलाव दिखाया गया है. यह लागत, करीब 16,000 यूनिट से घटकर करीब 1,600 यूनिट हो गई है.

30 जुलाई, 2013

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

• channelBanner संसाधन में, kind प्रॉपर्टी की वैल्यू को youtube#channelBannerInsertResponse से बदलकर youtube#channelBannerResource कर दिया गया है. यह संसाधन, channelBanners.insert अनुरोध के जवाब में दिखाया जाता है.

• channel संसाधन की नई brandingSettings.channel.profileColor प्रॉपर्टी, चैनल के कॉन्टेंट से मेल खाने वाला मुख्य रंग तय करती है. प्रॉपर्टी की वैल्यू, पाउंड का निशान (#) होती है. इसके बाद, छह वर्णों वाली हेक्साडेसिमल स्ट्रिंग होती है. जैसे, #2793e6.

• एपीआई अब यह तय करने की सुविधा देता है कि सदस्यता, चैनल की सभी गतिविधियों के लिए है या सिर्फ़ नए वीडियो अपलोड के लिए. subscription संसाधन की नई contentDetails.activityType प्रॉपर्टी से, उन गतिविधियों के टाइप की पहचान होती है जिनके बारे में सदस्य को सूचना दी जाएगी. प्रॉपर्टी की मान्य वैल्यू all और uploads हैं.

• videos.list तरीके से, YouTube पर सबसे लोकप्रिय वीडियो का चार्ट पाने के लिए नए पैरामीटर इस्तेमाल किए जा सकते हैं:

  • chart पैरामीटर, उस चार्ट की पहचान करता है जिसे आपको वापस पाना है. फ़िलहाल, सिर्फ़ mostPopular वैल्यू का इस्तेमाल किया जा सकता है. ध्यान दें कि chart पैरामीटर, फ़िल्टर पैरामीटर है. इसका मतलब है कि इसका इस्तेमाल, फ़िल्टर वाले अन्य पैरामीटर (id और myRating) के साथ एक ही अनुरोध में नहीं किया जा सकता.
  • videoCategoryId पैरामीटर, उस वीडियो कैटगरी की पहचान करता है जिसके लिए चार्ट को वापस पाना है. इस पैरामीटर का इस्तेमाल सिर्फ़ chart पैरामीटर के साथ किया जा सकता है. डिफ़ॉल्ट रूप से, चार्ट को किसी खास कैटगरी तक सीमित नहीं किया जाता.

• video संसाधन की नई topicDetails.relevantTopicIds[] प्रॉपर्टी, Freebase के उन विषय आईडी की सूची उपलब्ध कराती है जो वीडियो या उसके कॉन्टेंट से मिलते-जुलते हैं. इन विषयों के बारे में वीडियो में बताया जा सकता है या ये वीडियो में दिख सकते हैं.

• video संसाधन की recordingDetails.location.elevation प्रॉपर्टी का नाम बदलकर recordingDetails.location.altitude कर दिया गया है. साथ ही, इसकी fileDetails.recordingLocation.location.elevation प्रॉपर्टी का नाम बदलकर fileDetails.recordingLocation.location.altitude कर दिया गया है.

• video संसाधन का contentDetails.contentRating ऑब्जेक्ट, उन रेटिंग के बारे में बताता है जो किसी वीडियो को अलग-अलग रेटिंग स्कीम के तहत मिली हैं. जैसे, एमपीएए रेटिंग, टीवीपीजी रेटिंग वगैरह. हर रेटिंग सिस्टम के लिए, API अब एक ऐसी रेटिंग वैल्यू का इस्तेमाल करता है जिससे पता चलता है कि वीडियो को रेटिंग नहीं दी गई है. ध्यान दें कि MPAA रेटिंग के लिए, "बगैर रेटिंग वाला" रेटिंग का इस्तेमाल अक्सर फ़िल्मों के ऐसे वर्शन की पहचान करने के लिए किया जाता है जिन्हें काटा नहीं गया है. हालांकि, फ़िल्म के कट वर्शन को आधिकारिक रेटिंग मिली है.

• video संसाधन की नई contentDetails.contentRating.ytRating प्रॉपर्टी, उम्र की पाबंदी वाले कॉन्टेंट की पहचान करती है. अगर YouTube को लगता है कि वीडियो में ऐसा कॉन्टेंट है जो 18 साल से कम उम्र के लोगों के लिए सही नहीं है, तो प्रॉपर्टी की वैल्यू ytAgeRestricted होगी. अगर प्रॉपर्टी मौजूद नहीं है या प्रॉपर्टी की वैल्यू खाली है, तो इसका मतलब है कि कॉन्टेंट को उम्र से जुड़ी पाबंदी वाले कॉन्टेंट के तौर पर नहीं पहचाना गया है.

• channels.list तरीके के mySubscribers पैरामीटर का इस्तेमाल बंद कर दिया गया है. पुष्टि किए गए उपयोगकर्ता के चैनल के सदस्यों की सूची पाने के लिए, subscriptions.list तरीके और इसके mySubscribers पैरामीटर का इस्तेमाल करें.

• channelBanners.insert, channels.update, videos.getRating, और videos.rate, इन सभी तरीकों में अब onBehalfOfContentOwner पैरामीटर काम करता है. इस पैरामीटर से पता चलता है कि पुष्टि किया गया उपयोगकर्ता, पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई कर रहा है.

• channels.update तरीके के दस्तावेज़ को अपडेट कर दिया गया है. इससे पता चलता है कि इस तरीके का इस्तेमाल, channel संसाधन के brandingSettings ऑब्जेक्ट और उसकी चाइल्ड प्रॉपर्टी को अपडेट करने के लिए किया जा सकता है. दस्तावेज़ में अब प्रॉपर्टी की अपडेट की गई सूची भी दी गई है. इस सूची में वे प्रॉपर्टी शामिल हैं जिन्हें channel संसाधन के invideoPromotion ऑब्जेक्ट के लिए सेट किया जा सकता है.

• error documentation में, इन नई गड़बड़ियों के बारे में बताया गया है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  forbidden	accountDelegationForbidden	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता को, बताए गए Google खाते की ओर से कार्रवाई करने की अनुमति नहीं है.
  forbidden	authenticatedUserAccountClosed	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता का YouTube खाता बंद कर दिया गया है. अगर उपयोगकर्ता किसी दूसरे Google खाते की ओर से कार्रवाई कर रहा है, तो इस गड़बड़ी का मतलब है कि वह दूसरा खाता बंद कर दिया गया है.
  forbidden	authenticatedUserAccountSuspended	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता का YouTube खाता निलंबित कर दिया गया है. अगर उपयोगकर्ता किसी दूसरे Google खाते की ओर से कार्रवाई कर रहा है, तो इस गड़बड़ी का मतलब है कि वह दूसरा खाता निलंबित कर दिया गया है.
  forbidden	authenticatedUserNotChannel	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. इससे पता चलता है कि एपीआई सर्वर, एपीआई अनुरोध से जुड़�� चैनल की पहचान नहीं कर सकता. अगर अनुरोध को अनुमति मिली है और उसमें onBehalfOfContentOwner पैरामीटर का इस्तेमाल किया गया है, तो आपको onBehalfOfContentOwnerChannel पैरामीटर भी सेट करना चाहिए.
  forbidden	cmsUserAccountNotFound	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. सीएमएस उपयोगकर्ता को, बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई करने की अनुमति नहीं है.
  notFound	contentOwnerAccountNotFound	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. कॉन्टेंट के मालिक का दिया गया खाता नहीं मिला.
  badRequest	invalidPart	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. अनुरोध के part पैरामीटर में ऐसे हिस्से शामिल हैं जिन्हें एक साथ नहीं लिखा जा सकता.
  badRequest	videoChartNotFound	अनुरोध में ऐसे वीडियो चार्ट के बारे में बताया गया है जिसका इस्तेमाल नहीं किया जा सकता या जो उपलब्ध नहीं है. ऐसे में, videos.list वाला तरीका यह गड़बड़ी दिखाता है.
  notFound	videoNotFound	videos.update तरीके से यह गड़बड़ी तब दिखती है, जब अपडेट किया जाने वाला वीडियो नहीं मिलता. अनुरोध के मुख्य हिस्से में मौजूद id प्रॉपर्टी की वैल्यू की जांच करें, ताकि यह पक्का किया जा सके कि यह सही है.

10 जून, 2013

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

• channels.list तरीके के नए forUsername पैरामीटर की मदद से, किसी चैनल के YouTube उपयोगकर्ता नाम को सेट करके, उसके बारे में जानकारी पाई जा सकती है.

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

• प्लेलिस्ट के संसाधनों में अब snippet.tags प्रॉपर्टी शामिल है. प्रॉपर्टी सिर्फ़ उन उपयोगकर्ताओं को वापस मिलेगी जिनके पास अपनी प्लेलिस्ट का डेटा वापस पाने का अधिकार है. अनुमति वाले उपयोगकर्ता, playlists.insert या playlists.update तरीकों को कॉल करते समय प्लेलिस्ट टैग भी सेट कर सकते हैं.

• onBehalfOfContentOwner पैरामीटर का इस्तेमाल पहले channels.list और search.list तरीकों के लिए किया जा सकता था. अब इसका इस्तेमाल videos.insert, videos.update, और videos.delete तरीकों के लिए भी किया जा सकता है. ध्यान दें कि इस पैरामीटर का इस्तेमाल videos.insert तरीके के लिए किए गए कॉल में किया जाता है. इसलिए, अनुरोध में नए onBehalfOfContentOwnerChannel पैरामीटर के लिए भी कोई वैल्यू तय करनी होगी. इससे उस चैनल की पहचान की जा सकेगी जिसमें वीडियो जोड़ा जाएगा. चैनल, कॉन्टेंट के उस मालिक के खाते से लिंक होना चाहिए जिसके बारे में onBehalfOfContentOwner पैरामीटर बताता है.

  इस पैरामीटर से पता चलता है कि अनुरोध की पुष्टि करने वाले क्रेडेंशियल, YouTube सीएमएस के उस उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई कर रहा है. उपयोगकर्ता जिस सीएमएस खाते से पुष्टि करता है वह YouTube कॉन्टेंट के मालिकाना हक वाले खाते से लिंक होना चाहिए.

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

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

• error documentation में, इन नई गड़बड़ियों के बारे में बताया गया है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  forbidden	insufficientCapabilities	यह गड़बड़ी, किसी खास एपीआई तरीके से जुड़ी नहीं है. इससे पता चलता है कि एपीआई को कॉल करने वाले सीएमएस उपयोगकर्ता के पास, अनुरोध की गई कार्रवाई को पूरा करने के लिए ज़रूरी अनुमतियां नहीं हैं. यह गड़बड़ी, onBehalfOfContentOwner पैरामीटर के इस्तेमाल से जुड़ी है. यह पैरामीटर, एपीआई के कई तरीकों के साथ काम करता है.
  unauthorized	authorizationRequired	जब अनुरोध में home पैरामीटर का इस्तेमाल किया जाता है, लेकिन उसे सही तरीके से अनुमति नहीं दी जाती है, तब activities.list तरीके से यह गड़बड़ी दिखती है.

• channels संसाधन में, invideoPromotion.channelId प्रॉपर्टी को हटा दिया गया है, क्योंकि संसाधन की id प्रॉपर्टी का इस्तेमाल करके चैनल आईडी पहले ही बताया जा चुका है.

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

22 मई, 2013

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

• नई channelBanners.insert विधि की मदद से, ऐसी बैनर इमेज अपलोड की जा सकती है जिसे बाद में channel संसाधन की नई brandingSettings.image.bannerExternalUrl प्रॉपर्टी का इस्तेमाल करके, किसी चैनल की बैनर इमेज के तौर पर सेट किया जा सकता है.

• channels.update तरीके के दस्तावेज़ को अपडेट किया गया है. इसमें उन प्रॉपर्टी की सूची दी गई है जिनमें इस तरीके को कॉल करते समय बदलाव किया जा सकता है.

• video संसाधन के दस्तावेज़ में, suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[], और suggestions.editorSuggestions[] प्रॉपर्टी के लिए, unspecified को मान्य प्रॉपर्टी वैल्यू के तौर पर नहीं दिखाया गया है.

• videos.list तरीके के maxResults पैरामीटर की डिफ़ॉल्ट वैल्यू अब 5 है.

• error documentation में अब channelBanners.insert और subscriptions.list तरीकों से जुड़ी गड़बड़ियों की जानकारी दिखती है. इसमें channels.update तरीके के लिए, कई नई गड़बड़ियों की सूची भी दी गई है.

14 मई, 2013

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

• स्टैंडअलोन पेजों पर अब Java, .NET, PHP, और Ruby के लिए कोड सैंपल की सूची दी गई है.

• Python कोड के सैंपल दिखाने वाले पेज पर, अब सदस्यता जोड़ने, प्लेलिस्ट बनाने, और वीडियो अपडेट करने के उदाहरण भी शामि�� हैं.

10 मई, 2013

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

• YouTube अब एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई की सुविधाओं और सेवाओं की पहचान नहीं करता. इसके बजाय, अब हम YouTube API की ऐसी सूची उपलब्ध कराते हैं जिन पर समर्थन नहीं होने की नीति लागू होती है.

8 मई, 2013

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

• चैनल के संसाधनों में अब inVideoPromotion ऑब्जेक्ट का इस्तेमाल किया जा सकता है. इसमें चैनल से जुड़े प्रमोशनल कैंपेन के बारे में जानकारी होती है. कोई चैनल, इन-वीडियो प्रमोशन कैंपेन का इस्तेमाल करके, वीडियो प्लेयर में प्रमोट किए गए वीडियो की थंबनेल इमेज दिखा सकता है. ऐसा चैनल के वीडियो के प्लेबैक के दौरान किया जाता है.

  इस डेटा को वापस पाने के लिए, channels.list अनुरोध में part पैरामीटर वैल्यू में invideoPromotion को शामिल करें.

• channels.update के नए तरीके का इस्तेमाल करके, किसी चैनल के इन-वीडियो प्रमोशनल कैंपेन के डेटा को अपडेट किया जा सकता है. ध्यान दें कि इस तरीके से, सिर्फ़ channel संसाधन के invideoPromotion हिस्से को अपडेट किया जा सकता है. फ़िलहाल, इस संसाधन के अन्य हिस्सों को अपडेट नहीं किया जा सकता.

2 मई, 2013

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

• चैनल के संसाधन अब status.isLinked प्रॉपर्टी के साथ काम करते हैं. इससे पता चलता है कि चैनल का डेटा, ऐसे उपयोगकर्ता की पहचान करता है जो पहले से ही किसी YouTube उपयोगकर्ता नाम या Google+ खाते से लिंक है. जिस उपयोगकर्ता के पास इनमें से कोई लिंक पहले से है उसके पास सार्वजनिक YouTube पहचान होती है. यह कई कार्रवाइयों के लिए ज़रूरी है. जैसे, वीडियो अपलोड करना.

• सदस्यता से जुड़े संसाधनों में अब subscriberSnippet वाला हिस्सा शामिल किया जा सकता है. इस ऑब्जेक्ट में, सदस्य के चैनल के लिए स्निपेट डेटा होता है.

• एपीआई अब videos.getRating तरीके के साथ काम करता है. इससे उन रेटिंग को वापस पाया जा सकता है जो पुष्टि किए गए उपयोगकर्ता ने एक या उससे ज़्यादा वीडियो को दी हैं.

• videos.list तरीके के नए myRating पैरामीटर की मदद से, उन वीडियो की सूची वापस पाई जा सकती है जिन्हें पुष्टि किए गए उपयोगकर्ता ने like या dislike रेटिंग दी है.

  myRating पैरामीटर और id पैरामीटर, दोनों को अब फ़िल्टर पैरामीटर माना जाता है. इसका मतलब है कि एपीआई अनुरोध में, इनमें से सिर्फ़ एक पैरामीटर तय किया जाना चाहिए. (इससे पहले, इस तरीके के लिए id पैरामीटर को शामिल करना ज़रूरी था.)

  यह तरीका, उन अनुरोधों के लिए forbidden गड़बड़ी दिखाता है जो वीडियो की रेटिंग की जानकारी पाने की कोशिश करते हैं, लेकिन ऐसा करने के लिए उन्हें सही तरीके से अनुमति नहीं मिली है.

• myRating पैरामीटर के लॉन्च होने के साथ-साथ, videos.list तरीके को भी अपडेट किया गया है, ताकि पेज नंबर डालने की सुविधा काम कर सके. हालांकि, ध्यान दें कि पेजिंग पैरामीटर सिर्फ़ उन अनुरोधों के लिए काम करते हैं जिनमें myRating पैरामीटर का इस्तेमाल किया गया है. (पेजिंग पैरामीटर और जानकारी, id पैरामीटर का इस्तेमाल करने वाले अनुरोधों के लिए काम नहीं करती.)

  • maxResults पैरामीटर से, उन वीडियो की ज़्यादा से ज़्यादा संख्या तय की जाती है जो एपीआई, नतीजों के सेट में दिखा सकता है. वहीं, pageToken पैरामीटर से, नतीजों के सेट में मौजूद उस पेज की पहचान की जाती है जिसे आपको वापस पाना है.

  • youtube#videoListResponse अनुरोध के जवाब में मिलने वाले youtube#videoListResponse संसाधन में अब pageInfo ऑब्जेक्ट शामिल है. इसमें नतीजों की कुल संख्या और नतीजों के मौजूदा सेट में शामिल नतीजों की संख्या जैसी जानकारी होती है.videos.list youtube#videoListResponse रिसॉर्स में nextPageToken और prevPageToken प्रॉपर्टी भी शामिल हो सकती हैं. इनमें से हर प्रॉपर्टी, एक ऐसा टोकन उपलब्ध कराती है जिसका इस्तेमाल, नतीजों के सेट में किसी खास पेज को वापस पाने के लिए किया जा सकता है.

• videos.insert तरीके में ये नए पैरामीटर इस्तेमाल किए जा सकते हैं:

  • autoLevels – इस पैरामीटर की वैल्यू को true पर सेट करें, ताकि YouTube को वीडियो की रोशनी और रंग को अपने-आप बेहतर बनाने का निर्देश दिया जा सके.
  • stabilize – इस पैरामीटर वैल्यू को true पर सेट करें. इससे YouTube को यह निर्देश मिलेगा कि वह कैमरे की गतिविधियों की वजह से वीडियो में होने वाली गड़बड़ी को ठीक करे.

• channelTitle प्रॉपर्टी को इन संसाधनों के लिए snippet में जोड़ा गया है:

  • playlistItem – इस प्रॉपर्टी से, उस चैनल का नाम पता चलता है जिसने प्लेलिस्ट में आइटम जोड़ा है.
  • playlist – इस प्रॉपर्टी से, उस चैनल का नाम पता चलता है जिसने प्लेलिस्ट बनाई है.
  • subscription – इस प्रॉपर्टी से, उस चैनल के नाम के बारे में पता चलता है जिसकी सदस्यता ली गई है.

• इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java, Ruby)
  • videos.insert (.NET, Ruby)

• subscriptions.list तरीके के नए mySubscribers पैरामीटर की मदद से, पुष्टि किए गए मौजूदा उपयोगकर्ता के सदस्यों की सूची वापस पाई जा सकती है. इस पैरामीटर का इस्तेमाल सिर्फ़ ऐसे अनुरोध में किया जा सकता है जिसे सही तरीके से अनुमति मिली हो.

  ध्यान दें: इस सुविधा का मकसद, channels.list तरीके के लिए फ़िलहाल काम करने वाले mySubscribers पैरामीटर की जगह लेना है. उस पैरामीटर का इस्तेमाल बंद कर दिया जाएगा.

• video संसाधन में, प्रॉपर्टी वैल्यू unspecified अब इनमें से किसी भी प्रॉपर्टी के लिए मान्य वैल्यू नहीं है:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• एपीआई के ऐसे अनुरोध जिनमें कोई अनचाहा पैरामीटर शामिल होता है उनके लिए अब badRequest गड़बड़ी का मैसेज दिखता है. साथ ही, गड़बड़ी की वजह के तौर पर unexpectedParameter दिखता है.

• अगर प्लेलिस्ट में पहले से ही तय सीमा से ज़्यादा आइटम मौजूद हैं, तो playlistItems.insert तरीके से मिलने वाली गड़बड़ी को अपडेट कर दिया गया है. अब गड़बड़ी को forbidden ��ड़बड़ी के तौर पर रिपोर्ट किया गया है. साथ ही, गड़बड़ी की वजह playlistContainsMaximumNumberOfVideos है.

19 अप्रैल, 2013

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

• videos.rate तरीके से, कोई उपयोगकर्ता किसी वीडियो को like या dislike रेटिंग दे सकता है. इसके अलावा, वह किसी वीडियो से रेटिंग हटा भी सकता है.

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

• एपीआई के दस्तावेज़ में, थंबनेल इमेज को अब अलग रिसॉर्स के तौर पर पहचाना जाता है. साथ ही, नई thumbnails.set विधि की मदद से, YouTube पर कस्टम वीडियो का थंबनेल अपलोड किया जा सकता है और उसे किसी वीडियो के लिए सेट किया जा सकता है.

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

  ध्यान दें कि इस बदलाव से, थंबनेल इमेज दिखाने वाले मौजूदा संसाधनों पर कोई असर नहीं पड़ता. उन संसाधनों में थंबनेल इमेज उसी तरह से दिखती हैं जैसे पहले दिखती थीं. हालांकि, दस्तावेज़ में अब थंबनेल के अलग-अलग साइज़ के नाम दिए गए हैं. एपीआई इन साइज़ में थंबनेल दिखा सकता है.

• channel संसाधन के नए brandingSettings हिस्से में, चैनल पेज और वीडियो के वॉच पेजों के लिए सेटिंग, टेक्स्ट, और इमेज की पहचान की जाती है.

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

  • नए status ऑब्जेक्ट में, प्लेलिस्ट आइटम की स्थिति के बारे में जानकारी होती है. साथ ही, status.privacyStatus प्रॉपर्टी से, प्लेलिस्ट आइटम की निजता की स्थिति का पता चलता है.

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

  • status.publicStatsViewable प्रॉपर्टी से पता चलता है कि वॉच पेज पर वीडियो के ज़्यादा आंकड़े सार्वजनिक तौर पर देखे जा सकते हैं या नहीं. डिफ़ॉल्ट रूप से, ये आंकड़े देखे जा सकते हैं. साथ ही, वीडियो के व्यू की संख्या और रेटिंग जैसे आंकड़े अब भी सार्वजनिक तौर पर दिखेंगे. भले ही, इस प्रॉपर्टी की वैल्यू false पर सेट हो. videos.insert या videos.update तरीके को कॉल करते समय, इस प्रॉपर्टी की वैल्यू सेट की जा सकती है.

  • contentDetails.contentRating ऑब्जेक्ट में, रेटिंग की अलग-अलग स्कीम के तहत वीडियो को मिली रेटिंग शामिल होती हैं. यहां दी गई सूची में, इस्तेमाल किए जा सकने वाले रेटिंग सिस्टम के बारे में बताया गया है. साथ ही, हर रेटिंग सिस्टम से जुड़ी प्रॉपर्टी का लिंक दिया गया है. प्रॉपर्टी की परिभाषाओं से, हर सिस्टम के लिए इस्तेमाल की जा सकने वाली रेटिंग वैल्यू की पहचान होती है.

    देश	रेटिंग सिस्टम	प्रॉपर्टी
    United States	मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए)	contentDetails.contentRating.mpaaRating
    United States	माता-पिता के लिए टीवी से जुड़े दिशा-निर्देश	contentDetails.contentRating.tvpgRating
    Australia	ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी)	contentDetails.contentRating.acbRating
    Brazil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canada	कनाडा का होम वीडियो रेटिंग सिस्टम (सीएचवीआरएस)	contentDetails.contentRating.chvrsRating
    France	सेंट्र नैशनल ड्यू सिनेमा ऐट डे लइमेज एनिमे (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर)	contentDetails.contentRating.fmocRating
    Germany	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Great Britain	ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी)	contentDetails.contentRating.bbfcRating
    India	सेंट्रल बोर्ड ऑफ़ फ़िल्म सर्टिफ़िकेशन (सीबीएफ़सी)	contentDetails.contentRating.cbfcRating
    Japan	映倫管理委員会 (EIRIN)	contentDetails.contentRating.eirinRating
    Korea	영상물등급위원회 (KMRB)	contentDetails.contentRating.kmrbRating
    Mexico	जनरल डायरेक्टोरेट ऑफ़ रेडियो, टेलीविज़न ऐंड सिनेमैटोग्राफ़ी (आरटीसी)	contentDetails.contentRating.rtcRating
    New Zealand	ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन	contentDetails.contentRating.oflcRating
    Russia	नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन	contentDetails.contentRating.russiaRating
    Spain	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• playlistItems.update तरीके के दस्तावेज़ को अपडेट किया गया है. इससे पता चलता है कि अनुरोध के मुख्य हिस्से के तौर पर भेजे गए संसाधन में snippet.resourceId प्रॉपर्टी को तय करना ज़रूरी है.

• search.list तरीके में अब ये सुविधाएं उपलब्ध हैं:

  • नए forMine पैरामीटर की मदद से, खोज के नतीजों में सिर्फ़ पुष्टि किए गए उपयोगकर्ता के वीडियो दिखाए जाते हैं.

  • order पैरामीटर अब नतीजों को वर्णमाला के क्रम में टाइटल (order=title) के हिसाब से या वीडियो की संख्या के हिसाब से घटते क्रम (order=videoCount) में क्रम से लगाने की सुविधा के साथ काम करता है.

  • नए safeSearch पैरामीटर से पता चलता है कि खोज के नतीजों में प्रतिबंधित कॉन्टेंट शामिल होना चाहिए या नहीं.

• videos.insert तरीके में कई नई गड़बड़ियों का पता लगाया जा सकता है. इनकी सूची यहां दी गई है:

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	invalidCategoryId	snippet.categoryId प्रॉपर्टी में, अमान्य कैटगरी आईडी दिया गया है. videoCategories.list तरीके का इस्तेमाल करके, स्वीकार की गई कैटगरी वापस पाएं.
  badRequest	invalidRecordingDetails	metadata एट्रिब्यूट की वैल्यू के तौर पर, रिकॉर्डिंग की अमान्य जानकारी दी गई है.
  badRequest	invalidVideoGameRating	अनुरोध के मेटाडेटा में, वीडियो गेम की अमान्य रेटिंग दी गई है.
  badRequest	invalidVideoMetadata	अनुरोध का मेटाडेटा अमान्य है.

• onBehalfOfContentOwner पैरामीटर को, videos.update और videos.delete तरीकों के ��िए काम करने वाले पैरामीटर की सूची से हटा दिया गया है.

12 मार्च, 2013

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

• channelTitle प्रॉपर्टी को इन संसाधनों के लिए snippet में जोड़ा गया है:

  • activity – इस प्रॉपर्टी से, गतिविधि के लिए ज़िम्मेदार चैनल का नाम पता चलता है.
  • search – इस प्रॉपर्टी से, उस चैनल के नाम का पता चलता है जो खोज के नतीजे में पहचाने गए संसाधन से जुड़ा है.
  • video – इस प्रॉपर्टी से, वीडियो अपलोड करने वाले चैनल का नाम पता चलता है.

• search.list तरीके में ये नए पैरामीटर इस्तेमाल किए जा सकते हैं:

  • channelType पैरामीटर की मदद से, चैनलों को खोजने की सुविधा को सीमित किया जा सकता है. इससे सभी चैनल या सिर्फ़ शो वापस पाए जा सकते हैं.

  • videoType पैरामीटर की मदद से, वीडियो खोजने की सुविधा को सीमित किया जा सकता है. इससे सभी वीडियो या सिर्फ़ फ़िल्में या सिर्फ़ शो के एपिसोड वापस पाए जा सकते हैं.

• video संसाधन के recordingDetails हिस्से की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि किसी वीडियो के लिए ऑब्जेक्ट की जानकारी सिर्फ़ तब दिखेगी, जब वीडियो के जियोलोकेशन का डेटा या रिकॉर्डिंग का समय सेट किया गया हो.

• playlistItems.update तरीके से अब invalidSnippet गड़बड़ी का मैसेज मिलता है. यह मैसेज तब मिलता है, जब एपीआई अनुरोध में मान्य स्निपेट के बारे में नहीं बताया जाता.

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

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

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

    channels.list, search.list, videos.delete, videos.list, और videos.update, ये सभी तरीके इस पैरामीटर के साथ काम करते हैं.

  • managedByMe पैरामीटर, channels.list तरीके के साथ काम करता है. यह एपीआई को निर्देश देता है कि वह कॉन्टेंट के मालिक के उन सभी चैनलों को दिखाए जिन्हें onBehalfOfContentOwner पैरामीटर तय करता है.

  • forContentOwner पैरामीटर, search.list तरीके के साथ काम करता है. यह एपीआई को निर्देश देता है कि खोज के नतीजों को सिर्फ़ उन संसाधनों तक सीमित रखा जाए जिनका मालिकाना हक, कॉन्टेंट के उस मालिक के पास है जिसे onBehalfOfContentOwner पैरामीटर तय करता है.

25 फ़रवरी, 2013

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

• एपीआई, video संसाधनों के लिए कई नए हिस्सों और प्रॉपर्टी के साथ काम करता है:

  • fileDetails, processingDetails, और suggestions सेक्शन में, वीडियो के मालिकों को उनके अपलोड किए गए वीडियो के बारे में जानकारी मिलती है. यह डेटा, वीडियो अपलोड करने की सुविधा देने वाले ऐप्लिकेशन के लिए बहुत काम का होता है. इसमें यह जानकारी शामिल होती है:

    • प्रोसेस होने की स्थिति और प्रोग्रेस
    • वीडियो प्रोसेस करते समय हुई गड़बड़ियां या अन्य समस्याएं
    • थंबनेल इमेज की उपलब्धता
    • वीडियो या मेटाडेटा की क्वालिटी को बेहतर बनाने के सुझाव
    • YouTube पर अपलोड की गई ओरिजनल फ़ाइल के ��ारे में जानकारी

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

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

    • processingProgress ऑब्जेक्ट में, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने में YouTube की प्रोग्रेस के बारे में जानकारी होती है. ऑब्जेक्ट की प्रॉपर्टी से, प्रोसेस होने की मौजूदा स्थिति का पता चलता है. साथ ही, इससे यह भी पता चलता है कि YouTube को वीडियो प्रोसेस करने में कितना समय लगेगा. इस हिस्से से यह भी पता चलता है कि वीडियो के लिए अलग-अलग तरह का डेटा या कॉन्टेंट उपलब्ध है या नहीं. जैसे, फ़ाइल की जानकारी या थंबनेल इमेज.

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

    • suggestions ऑब्जेक्ट में ऐसे सुझाव शामिल होते हैं जिनसे अपलोड किए गए वीडियो की क्वालिटी या मेटाडेटा को बेहतर बनाया जा सकता है.

  • contentDetails वाले हिस्से में चार नई प्रॉपर्टी शामिल हैं. इन प्रॉपर्टी को बिना पुष्टि वाले अनुरोधों के ज़रिए वापस पाया जा सकता है.

    • dimension – इससे पता चलता है कि वीडियो 2D या 3D में उपलब्ध है या नहीं.
    • definition – इससे पता चलता है कि वीडियो स्टैंडर्ड डेफ़िनिशन या हाई डेफ़िनिशन में उपलब्ध है या नहीं.
    • caption – इससे पता चलता है कि वीडियो के लिए कैप्शन उपलब्ध हैं या नहीं.
    • licensedContent – इससे पता चलता है कि वीडियो में ऐसा कॉन्टेंट शामिल है जिस पर YouTube कॉन्टेंट पार्टनर ने दावा किया है.

  • status हिस्से में दो नई प्रॉपर्टी शामिल हैं. वीडियो के मालिक, वीडियो डालने या अपडेट करने के दौरान दोनों प्रॉपर्टी के लिए वैल्यू सेट कर सकते हैं. इन प्रॉपर्टी को बिना पुष्टि किए गए अनुरोधों से भी वापस पाया जा सकता है.

    • embeddable – इससे पता चलता है कि वीडियो को किसी दूसरी वेबसाइट पर एम्बेड किया जा सकता है या नहीं.
    • license – इससे वीडियो के लाइसेंस के बारे में पता चलता है. creativeCommon और youtube को वैल्यू के तौर पर इस्तेमाल किया ��ा सकता है.

• videos.list, videos.insert, और videos.update तरीकों के लिए, part पैरामीटर की परिभाषा को अपडेट किया गया है. इससे ऊपर बताए गए नए जोड़े गए हिस्सों के साथ-साथ recordingDetails हिस्से को ��ी ������ी में शामिल किया जा सकेगा. हिस्से को गलती से छोड़ दिया गया था.

• channel संसाधन की नई contentDetails.googlePlusUserId प्रॉपर्टी, चैनल से जुड़े Google+ प्रोफ़ाइल आईडी के बारे में बताती है. इस वैल्यू का इस्तेमाल, Google+ प्रोफ़ाइल का लिंक जनरेट करने के लिए किया जा सकता है.

• अब हर थंबनेल इमेज ऑब्जेक्ट में, इमेज की चौड़ाई और ऊंचाई के बारे में बताया गया है. फ़िलहाल, थंबनेल इमेज activity, channel, playlist, playlistItem, search result, subscription, और video संसाधनों में दिखती हैं.

• playlistItems.list अब videoId पैरामीटर के साथ काम करता है. इसका इस्तेमाल playlistId पैरामीटर के साथ किया जा सकता है. इससे सिर्फ़ उस प्लेलिस्ट आइटम को वापस पाया जा सकता है जो बताए गए वीडियो को दिखाता है.

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

• गड़बड़ी के दस्तावेज़ में नई forbidden गड़बड़ी के बारे में बताया गया है. इससे पता चलता है कि अनुरोध की गई कार्रवाई के लिए, अनुरोध को सही तरीके से अनुमति नहीं दी गई है.

• channel संसाधन की snippet.channelId प्रॉपर्टी हटा दी गई है. संसाधन की id प्रॉपर्टी की वैल्यू भी यही होती है.

30 जनवरी, 2013

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

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

16 जनवरी, 2013

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

• नीचे दी गई सूची में दिखाए गए तरीकों और भाषाओं के लिए, कोड के सैंपल अब उपलब्ध हैं:

  • activities.insert – Java
  • playlistItems.insert – Python
  • playlistItems.list – Java, JavaScript, PHP, Python, Ruby
  • playlists.insert – Java, JavaScript, Python
  • search.list – Java, JavaScript, Python, Ruby
  • videos.insert – Java

• activity संसाधन अब channelItem कार्रवाई की शिकायत कर सकता है. यह कार्रवाई तब होती है, जब YouTube किसी वीडियो को अपने-आप जनरेट होने वाले YouTube चैनल में जोड़ता है. (YouTube का एल्गोरिदम, YouTube वेबसाइट पर मौजूद ऐसे विषयों की पहचान करता है जो काफ़ी लोकप्रिय हैं. साथ ही, उन विषयों के लिए अपने-आप चैनल जनरेट करता है.)

• इन search.list पैरामीटर को अपडेट किया गया है:

  • q पैरामीटर को अब फ़िल्टर के तौर पर इस्तेमाल नहीं किया जा सकता. इसका मतलब है कि ....
  • relatedToVideo पैरामीटर का नाम बदलकर relatedToVideoId कर दिया गया है.
  • published पैरामीटर को दो नए पैरामीटर, publishedAfter और publishedBefore से बदल दिया गया है. इनके बारे में यहां बताया गया है.

• search.list तरीके में ये नए पैरामीटर इस्तेमाल किए जा सकते हैं:

  पैरामीटर का नाम	वैल्यू	ब्यौरा
  channelId	string	इस तरीके से, तय किए गए चैनल से बनाए गए संसाधन वापस मिलते हैं.
  publishedAfter	datetime	तय किए गए समय के बाद बनाए गए संसाधन दिखाता है.
  publishedBefore	datetime	तय की गई समयावधि से पहले बनाए गए संसाधन दिखाता है.
  regionCode	string	चुने गए देश के लिए, सामान लौटाने से जुड़े संसाधन दिखाएं.
  videoCategoryId	string	वीडियो खोज के नतीजों को फ़िल्टर करके, सिर्फ़ चुनी गई वीडियो कैटगरी से जुड़े वीडियो दिखाएं.
  videoEmbeddable	string	वीडियो के खोज नतीजों को फ़िल्टर करके, सिर्फ़ ऐसे वीडियो दिखाएं जिन्हें वेब पेज पर एम्बेड किए गए प्लेयर में चलाया जा सकता है. सिर्फ़ एम्बेड किए जा सकने वाले वीडियो पाने के लिए, पैरामीटर वैल्यू को true पर सेट करें.
  videoSyndicated	string	वीडियो खोजने के नतीजों को फ़िल्टर करके, सिर्फ़ ऐसे वीडियो दिखाएं जिन्हें YouTube.com के बाहर चलाया जा सकता है. सिर्फ़ सिंड��केट किए गए वीडियो पाने के लिए, पैरामीटर की वैल्यू को true पर सेट करें.

• कई एपीआई रिसॉर्स, नई प्रॉपर्टी के साथ काम करते हैं. नीचे दी गई टेबल में, संसाधनों और उनकी नई प्रॉपर्टी के बारे में बताया गया है:

  संसाधन	प्रॉपर्टी का नाम	वैल्यू	ब्यौरा
  activity	contentDetails.playlistItem.playlistItemId	string	यह प्लेलिस्ट आइटम का वह आईडी है जिसे YouTube ने असाइन किया है. इससे प्लेलिस्ट में मौजूद आइटम की यूनीक तरीके से पहचान की जाती है.
  activity	contentDetails.channelItem	object	यह एक ऐसा ऑब्जेक्ट होता है जिसमें किसी चैनल में जोड़े गए संसाधन के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब मौजूद होती है, जब snippet.type की वैल्यू channelItem हो.
  activity	contentDetails.channelItem.resourceId	object	यह एक ऐसा ऑब्जेक्ट है जिससे उस संसाधन की पहचान होती है जिसे चैनल में जोड़ा गया है. अन्य resourceId प्रॉपर्टी की तरह, इसमें भी एक kind प्रॉपर्टी होती है. यह प्रॉपर्टी, संसाधन के टाइप के बारे में बताती है. जैसे, वीडियो या प्लेलिस्ट. इसमें कई प्रॉपर्टी में से सिर्फ़ एक प्रॉपर्टी होती है. जैसे, videoId, playlistId वगैरह. यह प्रॉपर्टी, उस आईडी के बारे में बताती है जो उस संसाधन की यूनीक पहचान करता है.
  channel	status	object	इस ऑब्जेक्ट में, चैनल की निजता की स्थिति के बारे में जानकारी होती है.
  channel	status.privacyStatus	string	चैनल की निजता की स्थिति. private और public को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
  playlist	contentDetails	object	इस ऑब्जेक्ट में, प्लेलिस्ट के कॉन्टेंट के बारे में मेटाडेटा होता है.
  playlist	contentDetails.itemCount	unsigned integer	प्लेलिस्ट में मौजूद वीडियो की संख्या.
  playlist	player	object	इस ऑब्जेक्ट में ऐसी जानकारी होती है जिसका इस्तेमाल, एंबेड किए गए प्लेयर में प्लेलिस्ट चलाने के लिए किया जाता है.
  playlist	player.embedHtml	string	<iframe> टैग, जो प्लेलिस्ट चलाने वाले वीडियो प्लेयर को एम्बेड करता है.
  video	recordingDetails	object	इस ऑब्जेक्ट में ऐसी जानकारी शामिल होती है जिससे यह पता चलता है कि वीडियो किस जगह और किस समय रिकॉर्ड किया गया था.
  video	recordingDetails.location	object	इस ऑब्जेक्ट में, वीडियो से जुड़ी जियोलोकेशन की जानकारी होती है.
  video	recordingDetails.location.latitude	double	डिग्री में अक्षांश.
  video	recordingDetails.location.longitude	double	डिग्री में देशांतर.
  video	recordingDetails.location.elevation	double	ज़मीन से ऊंचाई, मीटर में.
  video	recordingDetails.locationDescription	string	वीडियो रिकॉर्ड करने की जगह के बारे में टेक्स्ट में जानकारी.
  video	recordingDetails.recordingDate	datetime	वीडियो रिकॉर्ड करने की तारीख और समय. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में तय किया जाता है.

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

  ध्यान दें: अन्य तरीकों के दस्तावेज़ में, ज़रूरी और बदली जा सकने वाली प्रॉपर्टी पहले से ही दी गई हो सकती हैं.

  तरीका	प्रॉपर्टी
  activities.insert	ज़रूरी प्रॉपर्टी: snippet.description बदली जा सकने वाली प्रॉपर्टी: snippet.description contentDetails.bulletin.resourceId
  playlists.update	ज़रूरी प्रॉपर्टी: id
  playlistItems.update	ज़रूरी प्रॉपर्टी: id
  videos.update	ज़रूरी प्रॉपर्टी: id

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

• एपीआई के कई तरीकों में, गड़बड़ी के नए टाइप काम करते हैं. यहां दी गई टेबल में, गड़बड़ी ठीक करने के तरीके और नई गड़बड़ियों के बारे में बताया गया है:

  तरीका	गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  guideCategories.list	notFound	notFound	id पैरामीटर से पहचानी गई गाइड कैटगरी नहीं मिली. मान्य वैल्यू की सूची पाने के लिए, guideCategories.list तरीके का इस्तेमाल करें.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	अनुरोध करने वाले व्यक्ति के पास, प्लेलिस्ट में मौजूद आइटम को मिटाने का सही अधिकार न��ीं है.
  videoCategories.list	notFound	videoCategoryNotFound	id पैरामीटर से पहचानी गई वीडियो कैटगरी नहीं मिली. मान्य वैल्यू की सूची पाने के लिए, videoCategories.list तरीके का इस्तेमाल करें.