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

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

30 अक्टूबर, 2024

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

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

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

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

30 अप्रैल, 2024

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

13 मार्च, 2024

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

12 मार्च, 2024

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

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

7 मार्च, 2024

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

31 जनवरी, 2024

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

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

9 नवंबर, 2023

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

12 सितंबर, 2023

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

22 अगस्त, 2023

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

18 अगस्त, 2023

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

7 अगस्त, 2023

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

28 जून, 2023

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

12 जून, 2023

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

22 अगस्त, 2022

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

5 अगस्त, 2022

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

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

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

12 जुलाई, 2022

YouTube API Services की सेवा की शर्तों को अपडेट कर दिया गया है. ज़्यादा जानकारी के लिए, कृपया 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 एंडपॉइंट पर कोई असर नहीं पड़ेगा.

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

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

2 जुलाई, 2021

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

1 जुलाई, 2021

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

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

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

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

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

12 मई, 2021

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

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

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

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

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

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

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

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

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

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

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

9 फ़रवरी, 2021

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

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

28 जनवरी, 2021

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

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

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

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

15 अक्टूबर, 2020

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

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

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

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

8 अक्टूबर, 2020

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

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

9 सितंबर, 2020

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

29 जुलाई, 2020

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

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

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

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

28 जुलाई, 2020

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

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

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

21 जुलाई, 2020

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

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

7 जुलाई, 2020

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

15 जून, 2020

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

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

4 जून, 2020

ध्यान दें: यह, बंद होने की पिछली सूचना का अपडेट है.

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

17 अप्रैल, 2020

ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

31 मार्च, 2020

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

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

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

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

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

10 जनवरी, 2020

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

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

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

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

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

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

10 सितंबर, 2019

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

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

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

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

4 अप्रैल, 2019

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

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

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

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

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

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

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

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

  • Java, JavaScript, PHP, और Python के लिए क्विकस्टार्ट गाइड अपडेट कर दी गई हैं. बदली गई गाइड में, API Explorer के कोड सैंपल का इस्तेमाल करके, एपीआई पासकोड के साथ एक सैंपल और 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 लाइब्रेरी का इस्तेमाल किया जा सकता है. oauth2client लाइब्रेरी अब काम नहीं करती.

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

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

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

29 अगस्त, 2017

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

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

24 जुलाई, 2017

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

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

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

1 जून, 2017

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

  • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

17 मई, 2017

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

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

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

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

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

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

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

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

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

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

27 अप्रैल, 2017

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

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

30 मार्च, 2017

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

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

27 फ़रवरी, 2017

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

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

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

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

29 नवंबर, 2016

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

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

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

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

10 नवंबर, 2016

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

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

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

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

  • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

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

2 नवंबर, 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • अन्य अपडेट

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

15 सितंबर, 2016

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

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

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

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

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

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

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

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

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

11 अगस्त, 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

13 जून, 2016

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

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

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

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

31 मई, 2016

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

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

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

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

    • 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 Developers Console से लिंक किया जा सके. यहां आपको अपना असल कोटा और कोटा का इस्तेमाल दिखेगा.

16 मार्च, 2016

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

  • मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट

    • channelBanner संसाधन दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि चैनल के बैनर की अपलोड की गई इमेज का सुझाया गया साइज़ 2560x1440 पिक्सल है. इमेज का कम से कम साइज़ (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",
    }
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

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

4 नवंबर, 2015

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

  • मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट

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

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

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

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

    • video रिसॉर्स की status.publishAt प्रॉपर्टी की परिभाषा को अपडेट किया गया है, ताकि यह जानकारी दी जा सके:

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

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

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

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

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

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

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

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

28 अगस्त, 2015

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

  • मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट

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

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

7 अगस्त, 2015

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

  • मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट

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

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

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

18 जून, 2015

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

  • मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट

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

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

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

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

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

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

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

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

27 अप्रैल, 2015

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

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

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

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

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

  • मौजूदा रिसॉर्स और तरीकों में होने वाले अपडेट

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

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

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

      नई सुविधा, डेवलपर टैग की सुविधाओं से मिलती-जुलती है. हालांकि, यह सुविधा पूरी तरह से उस सुविधा जैसी नहीं है जो v2 API के साथ काम करती थी.

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

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

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

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

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

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

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

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

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

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

16 अप्रैल, 2015

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

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

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

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

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

9 अप्रैल, 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2 अप्रैल, 2015

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

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

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

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

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

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

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

11 मार्च, 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 मार्च, 2015

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

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

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

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

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

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

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

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

2 मार्च, 2015

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

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

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

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

14 जनवरी, 2015

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

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

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

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

11 नवंबर, 2014

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

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

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

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

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

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

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

      इसके बाद, playlistItems.list तरीके को कॉल करें और playlistId पैरामीटर को कैप्चर किए गए आईडी पर सेट करें. साथ ही, 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) का इस्तेमाल करने का तरीका बताया गया है. पुराने API का इस्तेमाल 4 मार्च, 2014 से आधिकारिक तौर पर बंद कर दिया गया है. इस गाइड का मकसद, उन ऐप्लिकेशन को नए एपीआई वर्शन पर माइग्रेट करने में आपकी मदद करना है जो अब भी v2 एपीआई का इस्तेमाल कर रहे हैं.

8 जुलाई, 2014

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

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

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

18 जून, 2014

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

28 मई, 2014

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

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

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

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

13 मई, 2014

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

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

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

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

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

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

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

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

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

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

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

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

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

4 मार्च, 2014

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

5 दिसंबर, 2013

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

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

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

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

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

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

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

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

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

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

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

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

  • यहां दिए गए तरीकों के लिए, कोड के सैंपल जोड़े गए हैं:

24 अक्टूबर, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • video संसाधन की contentDetails.contentRating.mibacRating प्रॉपर्टी में अब दो और रेटिंग जोड़ी गई हैं:

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

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

1 अक्टूबर, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

27 अगस्त, 2013

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

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

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

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

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

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

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

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

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

15 अगस्त, 2013

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

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

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

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

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

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

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

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

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

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

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

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

  • यहां दिए गए तरीकों के लिए, कोड के सैंपल जोड़े गए हैं:

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

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

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

8 अगस्त, 2013

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

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

30 जुलाई, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

10 जून, 2013

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

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

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

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

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

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

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

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

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

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

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

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

22 मई, 2013

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

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

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

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

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

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

14 मई, 2013

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

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

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

10 मई, 2013

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

8 मई, 2013

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

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

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

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

2 मई, 2013

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

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

  • सदस्यता के संसाधन अब subscriberSnippet सेक्शन के साथ काम करते हैं. उस ऑब्जेक्ट में, सदस्य के चैनल का स्निपेट डेटा शामिल होता है.

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

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

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

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

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

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

    • videos.list अनुरोध के जवाब में दिखाए जाने वाले youtube#videoListResponse संसाधन में अब 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
      ऑस्ट्रेलिया ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (ACB) contentDetails.contentRating.acbRating
      ब्राज़ील Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
      कनाडा कनाडा का होम वीडियो रेटिंग सिस्टम (सीएचवीआरएस) contentDetails.contentRating.chvrsRating
      फ़्रांस सेंटर नैशनल डु सिनेमा ऐट डे ल'इमेज ऐनिमिए (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर) contentDetails.contentRating.fmocRating
      जर्मनी Freiwillige Selbstkontrolle der Filmwirtschaft (एफ़एसके) contentDetails.contentRating.fskRating
      ग्रेट ब्रिटेन ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) contentDetails.contentRating.bbfcRating
      भारत सेंट्रल बोर्ड ऑफ़ फ़िल्म सर्टिफ़िकेशन (सीबीएफ़सी) contentDetails.contentRating.cbfcRating
      जापान 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
      कोरिया 영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRating
      मेक्सिको जनरल डायरेक्टरेट ऑफ़ रेडियो, टेलीविज़न ऐंड सिनेमैटोग्राफ़ी (आरटीसी) contentDetails.contentRating.rtcRating
      न्यूज़ीलैंड ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन contentDetails.contentRating.oflcRating
      रूस नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन contentDetails.contentRating.russiaRating
      स्पेन Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating

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

  • search.list तरीका अब इन सुविधाओं के साथ काम करता है:

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

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

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

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

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

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

12 मार्च, 2013

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

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

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

  • search.list तरीका, इन नए पैरामीटर के साथ काम करता है:

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

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

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

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

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

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

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

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

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

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

25 फ़रवरी, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

30 जनवरी, 2013

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

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

16 जनवरी, 2013

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

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

  • 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

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

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

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