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

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

30 अप्रैल, 2024

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

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

यह API अब चैनल चर्चाओं को शामिल करने या पुनर्प्राप्त करने की क्षमता का समर्थन नहीं करता है. यह बदलाव YouTube वेबसाइट पर काम करने वाली सुविधा के मुताबिक है. वेबसाइट पर चैनल पर टिप्पणियां पोस्ट करने की सुविधा काम नहीं करती.

13 मार्च, 2024

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

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

sync पैरामीटर captions.insert और captions.update तरीके को बंद कर दिया गया है. 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 पर वीडियो को एक साथ देखने वाले उन दर्शकों की संख्या से अलग होती है जो स्पैम वाले वीडियो से स्पैम के तौर पर मार्क नहीं किए जाते आंकड़े. कॉन्टेंट बनाने YouTube सहायता केंद्र से लाइव स्ट्रीमिंग की मेट्रिक के बारे में ज़्यादा जानकारी मिलती है.

7 अगस्त, 2023

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

28 जून, 2023

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

12 जून, 2023

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

search.list वाले तरीके की relatedToVideoId पैरामीटर अब काम नहीं करता. YouTube, पैरामीटर का डेटा 7 अगस्त, 2023 तक का है.

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

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

22 अगस्त, 2022

video.statistics के लिए ठीक किए गए एनोटेशन .

5 अगस्त, 2022

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

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

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

12 जुलाई, 2022

YouTube API सेवाओं की सेवा की शर्तें अपडेट कर दी गई हैं. प्लीज़ YouTube API सेवाओं की सेवा की शर्तें - संशोधन देखें इतिहास पर क्लिक करें.

27 अप्रैल, 2022

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

8 अप्रैल, 2022

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

15 दिसंबर, 2021

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

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

18 नवंबर, 2021

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

videos.rate एंडपॉइंट पर कोई असर नहीं पड़ा है कितना असर पड़ रहा है.

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

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

2 जुलाई, 2021

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

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

तरीका और अगर आपके कोड को commentThreads संसाधन की ज़रूरत है, तो commentThreads.list तरीका.

1 जुलाई, 2021

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

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

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

हर नए फ़ॉर्म से हमें यह पता चलेगा कि आपने YouTube 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 पर ये वैल्यू पहले से इस्तेमाल नहीं की जा सकतीं और इस वजह से, वे अब API के ज़रिए भी काम नहीं करते.

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

  • playlist संसाधन का snippet.tags[] प्रॉपर्टी रोक दी गई है. यह प्रॉपर्टी पहले से ही काम नहीं कर रही है को डाउनलोड किया है और इस वजह से, यह अब API के ज़रिए काम नहीं करता.

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

15 अक्टूबर, 2020

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

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

नया किसी वीडियो के लिए MadeForKids के स्टेटस का पता लगाना इस गाइड में बताया गया है कि 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 तरीका
  • एपीआई से मिले जवाब channels.list तरीके का नंबर लंबे समय तक prevPageToken प्रॉपर्टी, अगर एपीआई अनुरोध managedByMe पैरामीटर true तक. इस बदलाव का असर prevPageToken प्रॉपर्टी पर नहीं पड़ेगा अन्य channels.list अनुरोधों के लिए है और इससे 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, एपीआई की सेवा की शर्तों के कुछ पहलुओं को कैसे लागू करता है, लेकिन किसी मौजूदा दस्तावेज़ को न बदलें. इस गाइड में, आम तौर पर पूछे जाने वाले कुछ सवालों के जवाब दिए गए हैं डेवलपर, एपीआई के अनुपालन से जुड़े ऑडिट के दौरान पूछते हैं. हमें उम्मीद है कि इससे सुविधाओं को डेवलप करने में आसानी होगी हम अपनी नीतियों को कैसे समझ पाते हैं और उन्हें कैसे लागू करते हैं.

4 जून, 2020

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

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

17 अप्रैल, 2020

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

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

31 मार्च, 2020

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

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

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

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

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

10 जनवरी, 2020

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

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

  • selfDeclaredMadeForKids प्रॉपर्टी की मदद से कॉन्टेंट क्रिएटर्स यह तय कर सकते हैं कि channel या वीडियो बच्चों के लिए बना है.

    चैनलों के लिए, इस प्रॉपर्टी को channels.update तरीका. वीडियो के लिए, इस प्रॉपर्टी को तब सेट किया जा सकता है, जब videos.insert या videos.update तरीके.

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

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

10 सितंबर, 2019

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

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

    इस बदलाव के साथ ही, 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 ऑब्जेक्ट के ज़रिए एपीआई में काम करती हैं. इस वजह से, वह ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी अब काम नहीं करतीं.

    आप अब भी invideoPromotion का डेटा वापस पा सकते हैं और उसे 14 दिसंबर, 2017 तक सेट कर सकते हैं. 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. वेब सर्वर के उदाहरण पर स्विच करने के लिए, लिंक पर क्लिक करें. वह सैंपल, फ़्लास्क वेब ऐप्लिकेशन फ़्रेमवर्क और अनुमति देने के एक अलग फ़्लो का इस्तेमाल करता है.

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

29 अगस्त, 2017

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

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

24 जुलाई, 2017

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

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

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

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

27 अप्रैल, 2017

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

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

30 मार्च, 2017

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

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

27 फ़रवरी, 2017

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

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

  • इन विषयों को Society के उप-विषयों के तौर पर जोड़ा गया है:
    नामविषय आईडी
    कारोबार/m/09s1f
    स्वास्थ्य/m/0kt51
    सेना/m/01h6rj
    राजनीति/m/05qt0
    धर्म/m/06bvp
  • Animated cartoon विषय को हटा दिया गया है. यह विषय पहले Entertainment का चाइल्ड था.
  • Children's music विषय को हटा दिया गया है. यह विषय पहले Music का चाइल्ड था.

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

29 नवंबर, 2016

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

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

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

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

10 नवंबर, 2016

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

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

    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[] से, वीडियो को FPB (दक्षिण अफ़्रीका) में मिलने की वजहों का पता चलता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • अन्य अपडेट

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

15 सितंबर, 2016

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

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

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

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

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

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

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

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

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

11 अगस्त, 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

13 जून, 2016

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

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

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

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

31 मई, 2016

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

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

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

  • गतिविधि, playlistItem, playlist, खोज के नतीजे, थंबनेल, और वीडियो संसाधनों के लिए 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 एपीआई से टिप्पणी करने की सुविधा का इस्तेमाल करके अब भी ऐप्लिकेशन कैसे माइग्रेट किए जा सकते हैं.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • बैच प्रोसेसिंग – v3 API, बैच प्रोसेसिंग के इस्तेमाल के उन उदाहरणों में से एक के साथ काम करता है जो v2 API के साथ काम करता था. v3 एपीआई के 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 एपीआई से बंद किया जा सकता है.

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

11 नवंबर, 2014

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

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

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

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

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

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

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

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

8 अक्टूबर, 2014

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

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

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

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

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

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

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

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

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

  • channelBanners.insert तरीके अब इस गड़बड़ी के साथ काम करता है:

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

12 सितंबर, 2014

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

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

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 नए कॉन्टेंट रेटिंग सिस्टम के साथ काम करता है. ये सिस्टम, अलग-अलग राष्ट्रीय रेटिंग एजेंसियों से वीडियो को मिली रेटिंग की पहचान करते हैं. इन रेटिंग सिस्टम के नए रेटिंग सिस्टम, अर्जेंटीना, ऑस्ट्रेलिया, ऑस्ट्र, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेल टेलीविज़न, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेलीविज़न), चिली (फ़िल्म) (टेलीविज़न, (टेलीविज़न), चिली (फ़िल्म</11}, चेक गणराज्य हों, चेक गणराज्य,

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 प्रॉपर्टी की परिभाषा को इस तरह अपडेट किया गया है कि यह वैल्यू अनुमान के मुताबिक है और हो सकता है कि यह सटीक वैल्यू न दिखाए. इसके अतिरिक्त, अधिकतम मान 1,000,000 है. पेजों को क्रम में लगाने वाले लिंक बनाने के लिए आपको इस वैल्यू का इस्तेमाल नहीं करना चाहिए. इसके बजाय, nextPageToken और prevPageToken प्रॉपर्टी वैल्यू का इस्तेमाल करके यह तय करें कि पेज पर नंबर डालने वाले लिंक दिखाने हैं या नहीं.

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

2 मई, 2014

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

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

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

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

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

7 अप्रैल, 2014

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

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

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

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

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

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

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

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

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

31 मार्च, 2014

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

13 मार्च, 2014

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

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

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

    संसाधन प्रॉपर्टी ज़्यादा से ज़्यादा लंबाई
    channel invideoPromotion.items[].customMessage 40 वर्ण
    video snippet.title 100 वर्ण
    video snippet.description 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 channels.update तरीका यह गड़बड़ी तब दिखाता है, जब invideoPromotion.items[].id.websiteUrl प्रॉपर्टी ऐसा यूआरएल तय करती है जिसकी अनुमति नहीं है.
    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 (वीएपी) – बच्चों के साथ वयस्क होना चाहिए.
    • 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 की नई प्रॉपर्टी, उस वीडियो को मिली रेटिंग की पहचान करती है जो इटली के मिनिस्टरो dei Beni e delle Attivita Culturali e del Turismo से मिला है.

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

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

27 अगस्त, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ध्यान दें: इस सुविधा का मकसद, 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
      ब्राज़ील Deparamento de Justiça, Classificação, Qualificação e Títules के साथ contentDetails.contentRating.djctqRating
      कनाडा कैनेडियन होम वीडियो रेटिंग सिस्टम (सीएचवीआरएस) contentDetails.contentRating.chvrsRating
      फ़्रांस Center National du cinéma et de l'image animée (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर) contentDetails.contentRating.fmocRating
      जर्मनी फ़्रीविलेज सेल्बस्टकोंट्रोल डे फ़िल्मवर्टसाफ़्ट (एफ़एसके) contentDetails.contentRating.fskRating
      ग्रेट ब्रिटेन ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) contentDetails.contentRating.bbfcRating
      भारत केंद्रीय फ़िल्म सर्टिफ़िकेशन बोर्ड (सीबीएफ़सी) contentDetails.contentRating.cbfcRating
      जापान 映倫管理委員会 (ईआईआरआईएन) contentDetails.contentRating.eirinRating
      कोरिया 영상물등위원 बांटे (केएमआरबी) contentDetails.contentRating.kmrbRating
      मेक्सिको जनरल डायरेक्ट्रेट ऑफ़ रेडियो, टेलीविज़न ऐंड सिनेमैटोग्राफ़ी (आरटीसी) contentDetails.contentRating.rtcRating
      न्यूज़ीलैंड ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन contentDetails.contentRating.oflcRating
      रूस नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन contentDetails.contentRating.russiaRating
      स्पेन इंस्तितूतो दे ला सिनेमेतोग्राफ़िया ई दे लास आर्तेस ऑडियोविज़ुअलेज़ (आईसीएए) 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 अनुरोध का मेटाडेटा अमान्य है.

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

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 पैरामीटर ने बताया है.

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