बदलावों का इतिहास

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

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 हैंडल की जानकारी देकर उसके बारे में जानकारी पाई जा सकती है.

9 नवंबर, 2023

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

12 सितंबर, 2023

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

comments.markAsSpam तरीके का इस्तेमाल करने वाले सभी दस्तावेज़ों में, एपीआई बंद होने की सूचना जोड़ी गई है.

22 अगस्त, 2023

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

18 अगस्त, 2023

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

7 अगस्त, 2023

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

28 जून, 2023

thumbnails.set वाला तरीका अब uploadRateLimitExceeded गड़बड़ी के साथ काम करता है. इससे पता चलता है कि चैनल पर पिछले 24 घंटों में कई थंबनेल अपलोड किए गए हैं. कुछ देर बाद कोशिश करें.

12 जून, 2023

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

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

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

22 अगस्त, 2022

बिना साइन किए हुए लॉन्ग स्ट्रिंग की वैल्यू में, video.statistics के लिए दिए गए फ़ील्ड के लिए, सही तरह के एनोटेशन दिए गए थे.

5 अगस्त, 2022

YouTube ने कैप्शन आईडी जनरेट करने का तरीका बदल दिया है और इस बदलाव के तहत, 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 API का इस्तेमाल किस तरह करते हैं. साथ ही, इससे हम बेहतर ढंग से आपकी मदद कर पाएंगे.

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

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 पर एम्बेड किए गए प्लेयर से इंटरैक्ट करता है. 'वीडियो अपने-आप चलने की सुविधा' को 'गलत है' पर सेट करके, यह तय किया जा सकता है कि कोई उपयोगकर्ता, प्लेयर से इंटरैक्ट करे और 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

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

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

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

21 जुलाई, 2020

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

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

7 जुलाई, 2020

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

15 जून, 2020

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

इस दिशा-निर्देश में इस बारे में अहम जानकारी दी गई है कि 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 रिसॉर्स को अब बंद कर दिया गया है. एपीआई क्लाइंट को इसके बजाय, members.list तरीके का इस्तेमाल करने के लिए, sponsors.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 लाख
12,34,567 1230000 12.3 लाख
1,23,45,678 12300000 1.23 करोड़
12,34,56,789 123000000 12.3 करोड़

4 अप्रैल, 2019

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

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

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

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

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

    फ़िलहाल, कोड सैंपल Java, JavaScript, PHP, Python, और curl के लिए इस्तेमाल किए जा सकते हैं.

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

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

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

ध्यान दें कि ऊपर बताए गए बदलाव, उस इंटरैक्टिव टूल की जगह ले लेंगे जिसे 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 का डेटा वापस पाया जा सकता है और उसे सेट किया जा सकता है. YouTube TV की सदस्यता रद्द करने की तारीख के बाद:

    • 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 की नई क्विकस्टार्ट गाइड उपलब्ध है. इस गाइड में बताया गया है कि सामान्य iOS ऐप्लिकेशन में, YouTube Data API इस्तेमाल कैसे किया जा सकता है. यह ऐप्लिकेशन Objective-C या Swift में लिखा गया होता है.
  • 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 वाले तरीके को कॉल किया जा सकता है.

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

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

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

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

    ध्यान दें कि इस टूल ने उन पेजों पर एपीआई एक्सप्लोरर को बदल दिया है जहां यह उपलब्ध है. (हर पेज एक लिंक दिखाता है, ताकि आपके पास उस अनुरोध को लोड करने का विकल्प भी हो जिस पर आप 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 के संसाधनों के साथ-साथ search.list तरीके के topicId पैरामीटर की topicDetails प्रॉपर्टी में भी शामिल की जाती है.

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

  • इन विषयों को 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 खोज पैरामीटर का इस्तेमाल भी किया जा सकता है.

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

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

  • ध्यान दें: यह सुविधा बंद करने की घोषणा है.

    ये प्रॉपर्टी बंद की जा रही हैं:

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

  • Freebase को पहले ही बंद कर दिया गया है. इसलिए, Freebase Topics की मदद से खोजना गाइड को दस्तावेज़ से हटा दिया गया है. इस गाइड ने यह दिखाने के लिए कोड के नमूने दिए हैं कि कोई ऐप्लिकेशन, 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 को बदलावों के इतिहास के अपडेट में दी गई थी:

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

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

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

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

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

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

11 अगस्त, 2016

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

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

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

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

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

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

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

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

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

  • कई API फ़ील्ड और पैरामीटर 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 पैरामीटर का इस्तेमाल करें. यह पैरामीटर, जो किसी खास क्रम में सदस्यों की जानकारी नहीं दिखाता है, वापस पाने के लिए सदस्यों की संख्या को सीमित नहीं करता.

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

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

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

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

17 मई, 2016

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

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

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

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

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

28 अप्रैल, 2016

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

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

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

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

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

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

20 अप्रैल, 2016

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

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

  • शुरुआती निर्देश के कोटा उपयोग सेक्शन को Google Developer के 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",
    }
  }
}

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

  • जगह के हिसाब से वैल्यू पाना

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

    • अपने channels.list, channelSections.list, playlists.list या videos.list अनुरोध में hl पैरामीटर जोड़ें. इससे 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 API के साथ काम करने वाले डेवलपर टैग फ़ंक्शन से मिलती-जुलती हैं. हालांकि, यह उनके जैसी नहीं है.

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

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

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

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

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 – कोई टिप्पणी मिटाएं.

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

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

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

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

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

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

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

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

2 अप्रैल, 2015

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

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

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

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

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

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

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

11 मार्च, 2015

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

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

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

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

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

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

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

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

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

    • आरएसएस फ़ीड से जुड़ी सहायता

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

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

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

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

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

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

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

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

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

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

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

4 मार्च, 2015

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

  • channelSections.delete और channelSections.update वाले तरीके अब onBehalfOfContentOwner पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है.

  • नीचे दी गई प्रॉपर्टी और उनकी चाइल्ड प्रॉपर्टी अब काम नहीं करतीं:

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

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

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

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

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

2 मार्च, 2015

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

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

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

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

14 जनवरी, 2015

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

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

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

  • ऊपर बताए गए नए JavaScript कोड के नमूने को शामिल करने के लिए, videos.insert तरीके के दस्तावेज़ को अपडेट किया गया है. 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 प्रॉपर्टी से पता चलता है कि चैनल का प्रमोशन कैंपेन, "स्मार्ट टाइमिंग" का इस्तेमाल करता है या नहीं. इस सुविधा की मदद से, वीडियो में प्रमोशन को ऐसे समय पर दिखाया जाता है जब उन्हें क्लिक किए जाने की संभावना ज़्यादा होती है और दर्शकों को वीडियो देखने में कोई परेशानी नहीं होती है. इस सुविधा की मदद से, हर वीडियो पर एक ही प्रमोशन दिखाया जाता है.

  • एपीआई किस तरीके से videos.update तरीके को कॉल मैनेज करता है, यह बताने के लिए video संसाधन की snippet.title और snippet.categoryId प्रॉपर्टी की परिभाषाएं अपडेट की गई हैं. अगर 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

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

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

    कृपया याद रखें कि कोटा शुल्क बिना किसी चेतावनी के बदल सकता है.

  • video के संसाधन में अब 43 नए कॉन्टेंट रेटिंग सिस्टम काम करते हैं. सिस्टम, वीडियो को मिलने वाली अलग-अलग राष्ट्रीय रेटिंग एजेंसियों से मिलने वाली रेटिंग की पहचान करते हैं.

28 मई, 2014

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

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

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

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

13 मई, 2014

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

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

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

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

  • video के रिसॉर्स की नई contentDetails.contentRating.ifcoRating प्रॉपर्टी, वीडियो को आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस से मिली रेटिंग की पहचान करती है.

  • 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

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

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

13 मार्च, 2014

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

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

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

    संसाधन प्रॉपर्टी ज़्यादा से ज़्यादा लंबाई
    channel invideoPromotion.items[].customMessage 40 वर्ण
    video snippet.title 100 वर्ण
    video snippet.description 5000 बाइट
    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 channels.update तरीके से यह गड़बड़ी तब मिलती है, जब किसी अनुरोध में यह तय न किया गया हो कि YouTube को प्रमोट किया गया आइटम कब दिखाना चाहिए.
    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 रेटिंग सिस्टम, क्विबेक में इस्तेमाल की जाती हैं.

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

  • thumbnails.set वाला तरीका अब onBehalfOfContentOwner पैरामीटर के साथ काम करता है. यह पैरामीटर पहले से ही कई दूसरे तरीकों के साथ काम करता है.

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

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

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

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

27 अगस्त, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

10 जून, 2013

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

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

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

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

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

    पैरामीटर से पता चलता है कि अनुरोध के लिए, अनुमति देने वाले क्रेडेंशियल से YouTube सीएमएस का इस्तेमाल करने वाले उस व्यक्ति की पहचान होती है जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. उपयोगकर्ता जिस कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है वह खाता, 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 के संसाधन दस्तावेज़ में अब suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[], और suggestions.editorSuggestions[] प्रॉपर्टी के लिए, unspecified को मान्य प्रॉपर्टी वैल्यू के तौर पर शामिल नहीं किया गया है.

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

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

14 मई, 2013

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

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

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

10 मई, 2013

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

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 पैरामीटर नतीजे के सेट में उस खास पेज की पहचान करता है जिसे आपको वापस लाना है.

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

  • videos.insert वाला तरीका, इन नए पैरामीटर के साथ काम करता है:

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

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

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

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

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

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

  • 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 ऑब्जेक्ट में, अलग-अलग रेटिंग स्कीम के तहत वीडियो को मिली रेटिंग को इकट्ठा किया जाता है. यहां दी गई सूची, इस्तेमाल किए जा सकने वाले रेटिंग सिस्टम की पहचान करती है. साथ ही, हर रेटिंग सिस्टम से जुड़ी प्रॉपर्टी का लिंक भी देती है. प्रॉपर्टी की परिभाषाएं, हर सिस्टम के लिए इस्तेमाल की जा सकने वाली रेटिंग की वैल्यू की पहचान करती हैं.

      देश रेटिंग सिस्टम प्रॉपर्टी
      अमेरिका मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए) contentDetails.contentRating.mpaaRating
      अमेरिका माता-पिता के लिए टीवी से जुड़े दिशा-निर्देश contentDetails.contentRating.tvpgRating
      ऑस्ट्रेलिया ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी) contentDetails.contentRating.acbRating
      ब्राज़ील Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
      कनाडा कैनेडियन होम वीडियो रेटिंग सिस्टम (CHVRS) contentDetails.contentRating.chvrsRating
      फ़्रांस सेंटर नैशनल डू सिनेमा एट डे एल इमेज एनिमी (फ़्रेंच संस्कृति मंत्रालय) contentDetails.contentRating.fmocRating
      जर्मनी Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
      ग्रेट ब्रिटेन ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) contentDetails.contentRating.bbfcRating
      भारत सेंट्रल बोर्ड ऑफ़ फ़िल्म सर्टिफ़िकेशन (सीबीएफ़सी) contentDetails.contentRating.cbfcRating
      जापान 映倫管理委員会 (EIRIN) में साइन इन करना contentDetails.contentRating.eirinRating
      कोरिया 영상물등ACCESS위원 जी (KMRB) contentDetails.contentRating.kmrbRating
      मेक्सिको जनरल डायरेक्टरेट ऑफ़ रेडियो, टेलीविज़न ऐंड सिनेमैटोग्राफ़ी (आरटीसी) contentDetails.contentRating.rtcRating
      न्यूज़ीलैंड ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन contentDetails.contentRating.oflcRating
      रूस नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन contentDetails.contentRating.russiaRating
      स्पेन इंस्टीट्यूटो डे ला Cinematografía y de las Artes Audioविज़ुअलes (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 specifies invalid recording details.
    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 तरीके इस पैरामीटर के साथ काम करते हैं.

    • channels.list तरीके के साथ काम करने वाले managedByMe पैरामीटर से, एपीआई को कॉन्टेंट के मालिक के मालिकाना हक वाले ऐसे सभी चैनलों को दिखाने का निर्देश मिलता है जिन्हें 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 वाले तरीके का इस्तेमाल करें.