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

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

2 नवंबर, 2026

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

अगर आपने videos.insert अनुरोध में status.privacyStatus प्रॉपर्टी के लिए कोई वैल्यू नहीं दी है, तो अपलोड किए गए वीडियो की निजता स्थिति डिफ़ॉल्ट रूप से public पर सेट हो जाती है. क्रिएटर के खाते की सेटिंग के आधार पर, कुछ वीडियो डिफ़ॉल्ट रूप से private के तौर पर सेट हो सकते हैं. इस बारे में YouTube सहायता केंद्र पर बताया गया है.

15 अक्टूबर, 2026

videos.list तरीके के बारे में साफ़ तौर पर बताया गया है कि status.selfDeclaredMadeForKids और status.madeForKids प्रॉपर्टी सिर्फ़ तब अपडेट की जाती हैं, जब अनुरोध में इनके बारे में बताया गया हो. साथ ही, अगर अनुरोध में इनके बारे में नहीं बताया गया है, तो इन्हें बदला नहीं जाता.

30 सितंबर, 2026

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

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

14 सितंबर, 2026

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

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

11 सितंबर, 2026

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

1 सितंबर, 2026

videos.getRating मेथड अब https://www.googleapis.com/auth/youtube.readonly अनुमति के स्कोप को स्वीकार करता है.

27 अगस्त, 2026

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

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

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

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

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

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

6 अगस्त, 2026

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

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

7 जुलाई, 2026

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

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

इन तरीकों को कॉल करते समय, brandPartner पार्ट के बारे में बताया जा सकता है:

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

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

23 जून, 2026

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

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

3 जून, 2026

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

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

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

1 जून, 2026

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

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

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

4 दिसंबर, 2025

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

10 जुलाई, 2025

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

26 मार्च, 2025

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

Data API में मौजूद ये फ़ील्ड, 31 मार्च, 2025 से इस बदलाव के मुताबिक शॉर्ट वीडियो के व्यू की संख्या दिखाएंगे:

  • 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 फ़ील्ड के लिए, टाइप एनोटेशन को अनसाइंड लॉन्ग से स्ट्रिंग में बदला गया.

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 की एपीआई सेवाओं का इस्तेमाल करने वाले सभी डेवलपर को एपीआई की शर्तों के पालन से जुड़ा ऑडिट पूरा करना होगा. इससे उन्हें 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 पर एम्बेड किए गए किसी भी प्लेयर के ज़रिए, अपने एपीआई क्लाइंट पर कॉन्टेंट एम्बेड करने से पहले, YouTube Data API सेवा का इस्तेमाल करके कॉन्टेंट की स्थिति की जांच करनी होगी.

किसी वीडियो के लिए, 'बच्चों के लिए बना' स्टेटस ढूंढने की नई गाइड में, YouTube Data API सेवा का इस्तेमाल करके, किसी वीडियो के लिए एमएफ़के स्टेटस देखने का तरीका बताया गया है.

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

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

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

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

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

21 जुलाई, 2020

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

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

7 जुलाई, 2020

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

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

15 जून, 2020

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

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

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 में अब भी सदस्यों की सटीक संख्या देख सकते हैं.

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

सदस्यों की संख्या का उदाहरण YouTube डेटा एपीआई सार्वजनिक तौर पर दिखने वाले YouTube यूज़र इंटरफ़ेस
1,234 1230 1.23 हज़ार
12,345 12300 12.3 हज़ार
1,23,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 में वैल्यू लोड की जा सकती हैं और फ़ुलस्क्रीन APIs Explorer को खोला जा सकता है. इससे आपको Java, JavaScript, PHP, और Python में कोड सैंपल मिल सकते हैं.

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

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

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

9 जुलाई, 2018

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

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

    जुलाई 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 लाइब्रेरी का इस्तेमाल किया जाएगा. लाइब्रेरी अब काम नहीं करती.

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

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

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

29 अगस्त, 2017

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

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

24 जुलाई, 2017

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

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

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

1 जून, 2017

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

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

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

17 मई, 2017

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

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

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

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

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

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

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

    ध्यान दें कि इस टूल ने उन पेजों पर APIs explorer की जगह ले ली है जहां यह उपलब्ध है. (हर पेज पर एक लिंक दिखता है, ताकि आपके पास उस अनुरोध को लोड करने का विकल्प भी हो जिस पर आप 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 प्रॉपर्टी, उस रेटिंग की पहचान करती है जो मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका ने किसी फ़िल्म के ट्रेलर या झलक को दी है.

27 फ़रवरी, 2017

11 अगस्त, 2016 को किए गए एलान के मुताबिक, YouTube ने विषय के आईडी की सूची को चुनिंदा विषयों की सूची में बदल दिया है. इस्तेमाल किए जा सकने वाले विषय के आईडी की पूरी सूची, 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[] प्रॉपर्टी. इस प्रॉपर्टी का इस्तेमाल 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[] से उन वजहों का पता चलता है जिनकी वजह से वीडियो को एफ़पीबी (दक्षिण अफ़्रीका) रेटिंग मिली है.

      • नई 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 पैरामीटर का इस्तेमाल करें. यह पैरामीटर, सदस्यों को किसी खास क्रम में नहीं दिखाता. साथ ही, यह सदस्यों की संख्या को सीमित नहीं करता.

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

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

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

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

17 मई, 2016

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

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

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

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

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

28 अप्रैल, 2016

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

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

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

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

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

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

20 अप्रैल, 2016

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

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

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

16 मार्च, 2016

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

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

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

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

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

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

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

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

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

    • video संसाधन की नई contentDetails.contentRating.ecbmctRating प्रॉपर्टी, तुर्किये के मिनिस्ट्री ऑफ़ कल्चर ऐंड टूरिज़्म के इवैलुएशन ऐंड क्लासिफ़िकेशन बोर्ड से मिली वीडियो की रेटिंग की पहचान करती है.

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

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

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

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

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

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

18 दिसंबर, 2015

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

19 नवंबर, 2015

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

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

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

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

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

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

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

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

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

  • स्थानीय भाषा के हिसाब से वैल्यू पाना

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

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

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

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

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

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

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

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

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

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

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

4 नवंबर, 2015

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

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

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

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

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

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

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

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

    • video संसाधन की contentDetails.contentRating.cncRating प्रॉपर्टी से, फ़्रांस के कमीशन डी क्लासिफ़िकेशन सिनेमैटोग्राफ़िक से मिली वीडियो की रेटिंग के बारे में पता चलता है. यह प्रॉपर्टी, 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[] प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह जानकारी मिलती है कि एपीआई सर्वर, प्रॉपर्टी की वैल्यू की लंबाई का हिसाब कैसे लगाता है. ध्यान दें कि इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता है.

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

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

    • 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 एपीआई से टिप्पणियों की सुविधा का इस्तेमाल करने वाले ऐप्लिकेशन को कैसे माइग्रेट किया जाए.

    इस गाइड में, टिप्पणी करने की ऐसी कई सुविधाओं के बारे में भी बताया गया है जो 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 – किसी टिप्पणी को मिटाना.

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

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

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

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

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

  • एपीआई अब इन गड़बड़ियों के बारे में जानकारी देता है:

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

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

2 अप्रैल, 2015

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

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

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

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

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

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

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

11 मार्च, 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 मार्च, 2015

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

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

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

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

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

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

  • एपीआई अब इन गड़बड़ियों के बारे में जानकारी देता है:

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

2 मार्च, 2015

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

  • search.list मेथड अब relevanceLanguage पैरामीटर के साथ काम करता है. इससे आपको किसी खास भाषा के हिसाब से सबसे काम के नतीजे पाने का अनुरोध करने की सुविधा मिलती है.

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

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

14 जनवरी, 2015

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

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

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

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

11 नवंबर, 2014

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

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

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

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

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

    • कोटा खर्च: छह यूनिट

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

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

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 तरीके को कॉल करने के लिए, कोटा की लागत एक यूनिट से बदलकर दो यूनिट हो गई है. इसके अलावा, तय किए गए संसाधन के हिस्सों की लागत भी शामिल है.

13 अगस्त, 2014

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

  • subscriptions.insert तरीके में अब यह गड़बड़ी दिखती है:

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

12 अगस्त, 2014

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

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

8 जुलाई, 2014

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

  • playlists.insert तरीके में अब यह गड़बड़ी दिखती है:

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

18 जून, 2014

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

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 प्रॉपर्टी से, उस रेटिंग की पहचान होती है जो किसी वीडियो को आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस से मिली है.

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

  • search.list तरीके के लिए, q पैरामीटर की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि क्वेरी के लिए इस्तेमाल किए गए शब्द में, बूलियन 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

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

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 संसाधन की इन प्रॉपर्टी को वैल्यू की उस सूची में जोड़ा गया है जिसे किसी वीडियो को शामिल या अपडेट करते समय सेट किया जा सकता है:

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

  • एपीआई अब इन गड़बड़ियों के बारे में जानकारी देता है:

    गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
    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

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

5 दिसंबर, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

24 अक्टूबर, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • mibacVap (वीएपी) – बच्चों के साथ किसी वयस्क का होना ज़रूरी है.
    • mibacVm6 (V.M.6) – सिर्फ़ छह साल और उससे ज़्यादा उम्र के लोगों के लिए.
    • mibacVm12 (V.M.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 प्रॉपर्टी को ऑब्जेक्ट से स्ट्रिंग में बदल दिया गया है. targetChannelId प्रॉपर्टी में अब वॉटरमार्क इमेज से लिंक किए गए YouTube चैनल का आईडी शामिल होता है. पहले, इस प्रॉपर्टी में एक चाइल्ड प्रॉपर्टी शामिल होती थी, जिसमें YouTube चैनल का आईडी होता था. इसलिए, संसाधन की targetChannelId.value प्रॉपर्टी को हटा दिया गया है.

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

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

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

  • एपीआई अब इन गड़बड़ियों के बारे में जानकारी देता है:

    गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
    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 हो गई है.

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

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

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

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

8 अगस्त, 2013

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

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 ऑब्जेक्ट, उन रेटिंग के बारे में बताता है जो किसी वीडियो को अलग-अलग रेटिंग स्कीम के तहत मिली हैं. इनमें एमपीएए रेटिंग, टीवीपीजी रेटिंग वगैरह शामिल हैं. हर रेटिंग सिस्टम के लिए, एपीआई अब ऐसी रेटिंग वैल्यू के साथ काम करता है जिससे पता चलता है कि वीडियो को रेटिंग नहीं दी गई है. ध्यान दें कि एमपीएए रेटिंग के लिए, "बगैर रेटिंग वाला" रेटिंग का इस्तेमाल अक्सर फ़िल्मों के अनकट वर्शन की पहचान करने के लिए किया जाता है. इन फ़िल्मों के कट वर्शन को आधिकारिक रेटिंग मिली होती है.

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

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

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

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

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

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

10 जून, 2013

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

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

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

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

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

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

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

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

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

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

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

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

22 मई, 2013

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

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

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

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

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

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

14 मई, 2013

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

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

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

10 मई, 2013

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

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

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

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

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

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

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

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

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

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

  • जिन एपीआई अनुरोधों में कोई अनचाहा पैरामीटर शामिल होता है उनके लिए अब 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 (एफ़एसके) contentDetails.contentRating.fskRating
      Great Britain ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) contentDetails.contentRating.bbfcRating
      India केंद्रीय फ़िल्म प्रमाणन बोर्ड (सीबीएफ़सी) contentDetails.contentRating.cbfcRating
      Japan 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
      Korea 영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRating
      Mexico जनरल डिरेक्टरेट ऑफ़ रेडियो, टेलीविज़न, ऐंड सिनेमैटोग्राफ़ी (आरटीसी) contentDetails.contentRating.rtcRating
      New Zealand ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन contentDetails.contentRating.oflcRating
      Russia नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन contentDetails.contentRating.russiaRating
      Spain Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating

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

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

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

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

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

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

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

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

12 मार्च, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

25 फ़रवरी, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

30 जनवरी, 2013

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

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

16 जनवरी, 2013

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

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

  • 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 तरीके का इस्तेमाल करें.