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

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

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

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

12 जुलाई, 2022

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

27 अप्रैल, 2022

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

8 अप्रैल, 2022

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

15 दिसंबर, 2021

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

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

18 नवंबर, 2021

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

इस बदलाव से videos.rate एंडपॉइंट पर कोई असर नहीं पड़ेगा.

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

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

2 जुलाई, 2021

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

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

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

1 जुलाई, 2021

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

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

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

हर नए फ़ॉर्म से, हमें यह पता चलेगा कि आपने YouTube API का इस्तेमाल कैसे किया होगा. साथ ही, इससे हमें आपकी बेहतर तरीके से मदद करने में मदद मिलेगी.

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

12 मई, 2021

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

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

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

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

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

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

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

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

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

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

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

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

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

9 फ़रवरी, 2021

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

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

28 जनवरी, 2021

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

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

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

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

15 अक्टूबर, 2020

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

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

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

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

8 अक्टूबर, 2020

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

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

9 सितंबर, 2020

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

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

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

29 जुलाई, 2020

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

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

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

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

28 जुलाई, 2020

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

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

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

21 जुलाई, 2020

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

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

7 जुलाई, 2020

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

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

15 जून, 2020

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

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

4 जून, 2020

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

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

17 अप्रैल, 2020

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

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

31 मार्च, 2020

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

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

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

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

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

10 जनवरी, 2020

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

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

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

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

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

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

10 सितंबर, 2019

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

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

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

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

4 अप्रैल, 2019

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

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

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

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

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

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

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

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

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

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

9 जुलाई, 2018

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

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

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

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

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

22 जून, 2018

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

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

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

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 तरीके को कॉल किया जा सकता है.

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

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

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

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

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

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

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

27 अप्रैल, 2017

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

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

30 मार्च, 2017

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

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

27 फ़रवरी, 2017

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

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

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

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

29 नवंबर, 2016

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

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

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

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

10 नवंबर, 2016

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

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

    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 पैरामीटर की मदद से, किसी खास विषय से जुड़े वीडियो या चैनल खोजे जा सकते हैं.

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

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

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

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

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

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

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

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

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

13 जून, 2016

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

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

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

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

31 मई, 2016

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

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

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

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

    • standard इमेज 640 पिक्सल चौड़ी और 480 पिक्सल ऊंची है.
    • maxres इमेज की चौड़ाई 1280 पिक्सल और ऊंचाई 720 पिक्सल है.
  • channelSection.list तरीके के part पैरामीटर की परिभाषा को अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि यह पता लगाया जा सके कि targeting वाले हिस्से को 2 कोटा यूनिट की लागत पर वापस लाया जा सकता है.

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

17 मई, 2016

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

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

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

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

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

28 अप्रैल, 2016

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

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

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

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

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

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

20 अप्रैल, 2016

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

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

  • शुरू करने के लिए गाइड के कोटा का इस्तेमाल सेक्शन को अपडेट किया गया है, ताकि इसे Google 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 प्रॉपर्टी, फ़्रांस के कमीशन डी क्लासिफ़िकेशन सिनेटोग्राफ़ के ज़रिए, वीडियो की रेटिंग के बारे में बताती है. यह प्रॉपर्टी, contentDetails.contentRating.fmocRating प्रॉपर्टी की जगह ले लेती है, जो अब काम नहीं करती.

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

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

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

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

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

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

28 अगस्त, 2015

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

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

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

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

7 अगस्त, 2015

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

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

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

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

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

18 जून, 2015

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

  • मौजूदा संसाधनों और तरीकों में बदलाव

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

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

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

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

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

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

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

27 अप्रैल, 2015

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

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

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

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

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

  • मौजूदा संसाधनों और तरीकों में बदलाव

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

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

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

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

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

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

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

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

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

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

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

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

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

16 अप्रैल, 2015

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

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

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

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

  • पुश नोटिफ़िकेशन की सदस्यता लेने से जुड़ी गाइड को अपडेट कर दिया गया है. इसमें यह जानकारी दी गई है कि सूचनाएं सिर्फ़ Google PubSubHubBub हब पर भेजी जाती हैं, न कि 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 – किसी टिप्पणी को मिटाएं.

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

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

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

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

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

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

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

2 अप्रैल, 2015

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

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

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

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

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

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

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

11 मार्च, 2015

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

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

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

  • YouTube Data API (v3) माइग्रेशन गाइड में यह जानकारी दी गई है कि v2 API की ये सुविधाएं, v3 API में काम नहीं करेंगी:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 मार्च, 2015

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

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

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

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

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

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

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

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

2 मार्च, 2015

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

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

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

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

14 जनवरी, 2015

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

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

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

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

11 नवंबर, 2014

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

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

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

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

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

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

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

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

8 अक्टूबर, 2014

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

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

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

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

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

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

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

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

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

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

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

12 सितंबर, 2014

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

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

13 अगस्त, 2014

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

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

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

12 अगस्त, 2014

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

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

8 जुलाई, 2014

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

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

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

18 जून, 2014

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

28 मई, 2014

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

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

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

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

13 मई, 2014

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

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

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

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

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

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

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

  • search.list कॉल के एपीआई रिस्पॉन्स में दिखने वाली pageInfo.totalResults प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि वैल्यू अनुमानित है और हो सकता है कि वह सटीक वैल्यू न दिखाए. इसके अलावा, ज़्यादा से ज़्यादा वैल्यू 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 अगर किसी चैनल के brandingSettings वाले हिस्से को अपडेट करने और brandingSettings.channel.title प्रॉपर्टी की वैल्यू बदलने की कोशिश की जाती है, तो channels.update तरीका गड़बड़ी का यह मैसेज दिखाता है. ध्यान दें कि अगर प्रॉपर्टी को छोड़ दिया जाता है, तो एपीआई गड़बड़ी नहीं दिखाता.
    badRequest (400) invalidRecentlyUploadedBy अगर invideoPromotion.items[].id.recentlyUploadedBy प्रॉपर्टी में अमान्य चैनल आईडी दिया गया है, तो channels.update तरीका यह गड़बड़ी दिखाता है.
    badRequest (400) invalidTimingOffset अगर invideoPromotion वाला हिस्सा किसी अमान्य टाइमिंग ऑफ़सेट को तय करता है, तो channels.update तरीका यह गड़बड़ी दिखाता है.
    badRequest (400) tooManyPromotedItems channels.update तरीका, यह गड़बड़ी तब दिखाता है, जब invideoPromotion सेक्शन में प्रमोशन के लिए तय किए गए आइटम की संख्या से ज़्यादा आइटम शामिल किए जाते हैं.
    forbidden (403) promotedVideoNotAllowed अगर invideoPromotion.items[].id.videoId प्रॉपर्टी किसी ऐसे वीडियो आईडी के बारे में बताती है जो या तो नहीं मिल रहा या उसे प्रमोट किए गए आइटम के तौर पर इस्तेमाल नहीं किया जा सकता, तो channels.update तरीका यह गड़बड़ी दिखाता है.
    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) – सिर्फ़ 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 की नई प्रॉपर्टी, उस वीडियो को मिली रेटिंग की पहचान करती है जो इटली के मिनिस्टरो dei Beni e delle Attivita Culturali e del Turismo से मिला है.

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

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

27 अगस्त, 2013

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

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

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

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

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

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

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

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

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

15 अगस्त, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

8 अगस्त, 2013

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

30 जुलाई, 2013

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

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

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

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

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

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

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

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

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

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

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

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

14 मई, 2013

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

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

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

10 मई, 2013

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

8 मई, 2013

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

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

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

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

2 मई, 2013

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

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

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

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

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

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

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

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

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

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

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

    • autoLevels – इस पैरामीटर की वैल्यू को 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
      ब्राज़ील Deparamento de Justiça, Classificação, Qualificação e Títules के साथ 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 अनुरोध का मेटाडेटा अमान्य है.
  • videos.update और videos.delete तरीकों के लिए इस्तेमाल किए जा सकने वाले पैरामीटर की सूची से, onBehalfOfContentOwner पैरामीटर को हटा दिया गया है.

12 मार्च, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

25 फ़रवरी, 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

30 जनवरी, 2013

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

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

16 जनवरी, 2013

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

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

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

  • ये search.list पैरामीटर अपडेट किए गए हैं:

    • q पैरामीटर अब फ़िल्टर के तौर पर सेट नहीं है, जिसका मतलब है ....
    • relatedToVideo पैरामीटर का नाम बदलकर relatedToVideoId कर दिया गया है.
    • published पैरामीटर को दो नए पैरामीटर, publishedAfter और publishedBefore से बदल दिया गया है. इनके बारे में नीचे बताया गया है.

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

    पैरामीटर का नाम मान ब्यौरा
    channelId string तय किए गए चैनल से बनाए गए संसाधन दिखाता है.
    publishedAfter datetime तय समय के बाद बनाए गए संसाधन दिखाएं.
    publishedBefore datetime तय समय से पहले बनाए गए संसाधनों को वापस लाएं.
    regionCode string चुने गए देश के लिए संसाधन दिखाएं.
    videoCategoryId string वीडियो के खोज नतीजों को फ़िल्टर करें, ताकि सिर्फ़ चुनी गई वीडियो कैटगरी से जुड़े वीडियो शामिल हों.
    videoEmbeddable string वीडियो के खोज नतीजों को फ़िल्टर करके, सिर्फ़ वेब पेज पर एम्बेड किए गए प्लेयर में चलाए जा सकने वाले वीडियो शामिल करें. सिर्फ़ एम्बेड किए जा सकने वाले वीडियो वापस पाने के लिए, पैरामीटर वैल्यू को true पर सेट करें.
    videoSyndicated string वीडियो के खोज नतीजों को फ़िल्टर करके, सिर्फ़ ऐसे वीडियो शामिल करें जिन्हें YouTube.com के अलावा किसी दूसरे प्लैटफ़ॉर्म पर चलाया जा सकता है. सिर्फ़ सिंडिकेट किए गए वीडियो पाने के लिए, पैरामीटर वैल्यू को true पर सेट करें.
  • कई एपीआई रिसॉर्स, नई प्रॉपर्टी के साथ काम करते हैं. नीचे दी गई टेबल में, संसाधनों और उनकी नई प्रॉपर्टी की जानकारी दी गई है:

    संसाधन प्रॉपर्टी का नाम मान ब्यौरा
    activity contentDetails.playlistItem.playlistItemId string प्लेलिस्ट में मौजूद आइटम का आईडी, जिसे YouTube ने प्लेलिस्ट में मौजूद किसी आइटम की खास तरह से पहचान करने के लिए असाइन किया है.
    activity contentDetails.channelItem object ऐसा ऑब्जेक्ट जिसमें किसी चैनल में जोड़े गए संसाधन के बारे में जानकारी होती है. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब snippet.type की वैल्यू channelItem हो.
    activity contentDetails.channelItem.resourceId object एक ऑब्जेक्ट जो चैनल में जोड़े गए संसाधन की पहचान करता है. अन्य resourceId प्रॉपर्टी की तरह ही, इसमें एक kind प्रॉपर्टी होती है, जो संसाधन के टाइप के बारे में बताती है. जैसे, वीडियो या प्लेलिस्ट. इसमें कई प्रॉपर्टी – videoId, playlistId वगैरह – में से कोई एक प्रॉपर्टी भी होती है. यह प्रॉपर्टी, उस संसाधन की खास तौर पर पहचान करने वाले आईडी की जानकारी देती है.
    channel status object इस ऑब्जेक्ट में, चैनल की निजता की स्थिति के बारे में जानकारी शामिल होती है.
    channel status.privacyStatus string चैनल की निजता की स्थिति. मान्य वैल्यू private और public हैं.
    playlist contentDetails object इस ऑब्जेक्ट में, प्लेलिस्ट के कॉन्टेंट का मेटाडेटा होता है.
    playlist contentDetails.itemCount unsigned integer प्लेलिस्ट में मौजूद वीडियो की संख्या.
    playlist player object इस ऑब्जेक्ट में ऐसी जानकारी है जिसका इस्तेमाल आपको एम्बेड किए गए प्लेयर में प्लेलिस्ट चलाने के लिए करना होगा.
    playlist player.embedHtml string ऐसा <iframe> टैग जो प्लेलिस्ट चलाने वाले वीडियो प्लेयर को एम्बेड करता है.
    video recordingDetails object इस ऑब्जेक्ट में, वीडियो रिकॉर्ड करने की जगह और समय की जानकारी होती है.
    video recordingDetails.location object इस ऑब्जेक्ट में, वीडियो से जुड़ी जगह की जानकारी होती है.
    video recordingDetails.location.latitude double अक्षांश, डिग्री में.
    video recordingDetails.location.longitude double डिग्री में देशांतर.
    video recordingDetails.location.elevation double धरती से ऊंचाई, मीटर में.
    video recordingDetails.locationDescription string उस जगह के बारे में जानकारी जहां वीडियो रिकॉर्ड किया गया था.
    video recordingDetails.recordingDate datetime वीडियो रिकॉर्ड करने की तारीख और समय. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में बताया गया है.
  • एपीआई के कई तरीकों के दस्तावेज़ में, अब उन प्रॉपर्टी की पहचान की गई है जिन्हें अनुरोध के मुख्य हिस्से में बताना ज़रूरी है या जो अनुरोध के मुख्य हिस्से में दी गई वैल्यू के आधार पर अपडेट होती हैं. नीचे दी गई टेबल में उन तरीकों की सूची दी गई है. साथ ही, उनमें ज़रूरी या बदलाव की जा सकने वाली प्रॉपर्टी भी बताई गई हैं.

    ध्यान दें: अन्य तरीकों के दस्तावेज़ में, ज़रूरी और बदलाव की जा सकने वाली प्रॉपर्टी की सूची पहले से मौजूद हो सकती है.

    तरीका प्रॉपर्टी
    activities.insert ज़रूरी प्रॉपर्टी:
    • snippet.description
    बदली जा सकने वाली प्रॉपर्टी:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update ज़रूरी प्रॉपर्टी:
    • id
    playlistItems.update ज़रूरी प्रॉपर्टी:
    • id
    videos.update ज़रूरी प्रॉपर्टी:
    • id
  • अगर किसी ऐसी प्लेलिस्ट को बनाने या अपडेट करने की कोशिश की जाती है जिसका टाइटल, उसी चैनल में पहले से मौजूद प्लेलिस्ट के टाइटल से मेल खाता है, तो एपीआई अब playlistAlreadyExists गड़बड़ी की रिपोर्ट नहीं करता.

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

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