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

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

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 के इन फ़ील्ड में, शॉर्ट वीडियो को मिले व्यू की संख्या दिखेगी:

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

30 अक्टूबर, 2024

एपीआई अब ऐसे वीडियो की पहचान कर सकता है जिनमें असल जैसा दिखने वाला बदलाव करके बनाया गया या अप्राकृतिक (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 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 का कोई भी डेटा नहीं मिलेगा.
  • channels.update को कॉल करते समय, invideoPromotion डेटा को अपडेट करने की कोशिश करने पर, कम से कम 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 लाइब्रेरी का इस्तेमाल किया जाएगा. oauth2client लाइब्रेरी अब काम नहीं करती.

  इस बदलाव के अलावा, टूल अब इंस्टॉल किए गए 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

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

• YouTube Data API की नई क्विकस्टार्ट गाइड, iOS के लिए उपलब्ध है. इस गाइड में, 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 को बदलावों के इतिहास के अपडेट में दी गई थी:

  • अगर activities.list तरीके को home पैरामीटर के साथ true पर सेट करके कॉल किया जाता है, तो एपीआई से मिले रिस्पॉन्स में अब ऐसे आइटम शामिल होते हैं जो 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 हिस्से को वापस पाने की कोशिश करने वाले ऐसे अनुरोध पर अनुमति नहीं है (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 ऑब्जेक्ट को डालने या अपडेट करने का अनुरोध पूरा नहीं हो सका. ऐसा इसलिए हुआ, क्योंकि उस संसाधन के लिए 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 API में v2 API की वे सभी सुविधाएं काम करेंगी जिनके साथ यह काम करने वाला है. इन सभी सुविधाओं के बारे में, माइग्रेशन गाइड में भी बताया गया है.

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

  • 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[]: उन देशों की सूची जहां चैनल सेक्शन दिखता है. सूची में मौजूद हर वैल्यू, ISO 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 कॉलबैक सर्वर, ऐटम फ़ीड की सूचनाएं पा सकता है:

  • वीडियो अपलोड करता है
  • वीडियो का टाइटल अपडेट करता है
  • वीडियो के ब्यौरे को अपडेट करता है

• माइग्रेशन गाइड को भी अपडेट कर दिया गया है, ताकि पुश नोटिफ़िकेशन की नई सुविधा के बारे में बताया जा सके. हालांकि, v2 API में कई तरह की पुश नोटिफ़िकेशन की सुविधा उपलब्ध थी. ये पुश नोटिफ़िकेशन, v3 API में उपलब्ध नहीं हैं. इसलिए, 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 स्कोप के लिए, एपीआई सर्वर के साथ कम्यूनिकेशन को 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 API का इस्तेमाल करके, सुझाए गए वीडियो ढूंढे जा सकते हैं. इसके लिए, activities.list तरीके को कॉल करें और home पैरामीटर की वैल्यू को true पर सेट करें.

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

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

  • सदस्यता वाले चैनलों के नए वीडियो पाना – v3 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 प्रॉपर्टी से, उन वजहों का पता चलता है जिनकी वजह से वीडियो को DJCQT (ब्राज़ील) रेटिंग मिली है.

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

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  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 यूनिट हो गया है. यह शुल्क, तय किए गए resource parts के शुल्क के अलावा है.

13 अगस्त, 2014

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

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

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

12 अगस्त, 2014

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

• अपने ऐप्लिकेशन को YouTube Data API (v3) पर माइग्रेट करना नाम की नई गाइड में बताया गया है कि YouTube Data API (v3) का इस्तेमाल करके, YouTube Data API (v2) में उपलब्ध सुविधाओं को कैसे इस्तेमाल किया जा सकता है. पुराने API का इस्तेमाल औपचारिक रूप से 4 मार्च, 2014 को बंद कर दिया गया था. इस गाइड का मकसद, उन ऐप्लिकेशन को माइग्रेट करने में आपकी मदद करना है जो अब भी v2 API का इस्तेमाल कर रहे हैं. ऐसा सबसे नए 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 पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि क्वेरी टर्म, Boolean NOT (-) ऑपरेटर का इस्तेमाल करके, किसी खास खोज शब्द से जुड़े वीडियो को बाहर कर सकता है. वैल्यू में बूलियन OR (|) ऑपरेटर का इस्तेमाल करके, कई खोज शब्दों में से किसी एक से जुड़े वीडियो भी ढूंढे जा सकते हैं.

• search.list कॉल के जवाब में, एपीआई से मिली pageInfo.totalResults प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि वैल्यू अनुमानित है और यह सटीक वैल्यू नहीं हो सकती. इसके अलावा, इसकी ज़्यादा से ज़्यादा वैल्यू 10,00,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 साइट के फ़ुटर से, अपनी पसंद का कॉन्टेंट क्षेत्र मैन्युअल तरीके से भी चुन सकता है.

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

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 पिक्सल गुणा 1152 पिक्सल कर दिया गया है. (इससे पहले, कम से कम साइज़ 2120 पिक्सल x 1192 पिक्सल था.) इसके अलावा, ध्यान दें कि channel संसाधन के दस्तावेज़ में, एपीआई से दिखाई जाने वाली सभी बैनर इमेज के ज़्यादा से ज़्यादा साइज़ के बारे में बताया गया है. उदाहरण के लिए, टेलीविज़न ऐप्लिकेशन के लिए brandingSettings.image.bannerTvImageUrl इमेज का ज़्यादा से ज़्यादा साइज़ 2120 पिक्सल गुणा 1192 पिक्सल होता है. हालांकि, असल इमेज 2048 पिक्सल गुणा 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 रेटिंग सिस्टम के तहत मिली हैं. इन दोनों सिस्टम का इस्तेमाल, क्रमशः कनाडा और Québec में किया जाता है.

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

    • 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) – सिर्फ़ 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 में, अनुरोध के नए कॉन्टेक्स्ट से जुड़ी इस गड़बड़ी के बारे में बताया गया है. यह गड़बड़ी, एपीआई के उस तरीके के लिए हो सकती है जो error documentation अनुरोध पैरामीटर के साथ काम करता है:mine

  गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
  badRequest	invalidMine	mine पैरामीटर का इस्तेमाल उन अनुरोधों में नहीं किया जा सकता जहां पुष्टि किया गया उपयोगकर्ता, YouTube पार्टनर हो. आपको mine पैरामीटर हटाना चाहिए. इसके अलावा, onBehalfOfContentOwner पैरामीटर हटाकर, YouTube उपयोगकर्ता के तौर पर पुष्टि करें. अगर कॉल किए गए तरीके के लिए 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 ऑब्जेक्ट, उन रेटिंग के बारे में बताता है जो किसी वीडियो को अलग-अलग रेटिंग स्कीम के तहत मिली हैं. जैसे, MPAA रेटिंग, TVPG रेटिंग वगैरह. हर रेटिंग सिस्टम के लिए, एपीआई अब एक ऐसी रेटिंग वैल्यू का इस्तेमाल करता है जिससे यह पता चलता है कि वीडियो को रेटिंग नहीं दी गई है. ध्यान दें कि 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 सीएमएस के उस उपयोगकर्ता की पहचान होती है जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई कर रहा है. उपयोगकर्ता जिस CMS खाते से पुष्टि करता है वह, 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	Office of Film and Literature Classification	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 सीएमएस के उस उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई कर रहा है. उपयोगकर्ता जिस CMS खाते से पुष्टि करता है वह, 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 हिस्से को भी सूची में शामिल किया जा सकेगा. 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 तरीके का इस्तेमाल करें.