इस पेज पर, 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 वेब सर्वर ऐप्लिकेशन के लिए पूरे कोड सैंपल उपलब्ध कराता है. ये ऐप्लिकेशन, अनुमति देने के लिए थोड़े अलग फ़्लो का इस्तेमाल करते हैं. पूरे सैंपल (और यह बदलाव) देखने के लिए:
- इंटरैक्टिव कोड स्निपेट टूल या एपीआई वाले किसी भी तरीके के दस्तावेज़ पर जाएं, जैसे कि
channels.list
तरीका. - कोड सैंपल के ऊपर मौजूद
Python
टैब पर क्लिक करें. - टैब के ऊपर मौजूद टॉगल पर क्लिक करके, स्निपेट से पूरे सैंपल पर स्विच करें.
- टैब में अब एक पूरा कोड सैंपल दिखना चाहिए. इस सैंपल में,
InstalledAppFlow
के ऑथराइज़ेशन फ़्लो का इस्तेमाल किया जाता है. नमूने के ऊपर दिए गए विवरण में यह बताया गया है और यह वेब सर्वर ऐप्लिकेशन के नमूने के लिंक भी है. - वेब सर्वर के उदाहरण पर स्विच करने के लिए, लिंक पर क्लिक करें. वह सैंपल, फ़्लास्क वेब ऐप्लिकेशन फ़्रेमवर्क और अनुमति देने के एक अलग फ़्लो का इस्तेमाल करता है.
ये सभी सैंपल, डाउनलोड करने और स्थानीय तौर पर चलाने के लिए डिज़ाइन किए गए हैं. अगर आपको सैंपल चलाने हैं, तो कोड स्निपेट टूल के निर्देशों में, पूरे कोड सैंपल को स्थानीय तौर पर चलाने के लिए दिए गए निर्देश देखें.
- इंटरैक्टिव कोड स्निपेट टूल या एपीआई वाले किसी भी तरीके के दस्तावेज़ पर जाएं, जैसे कि
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[]
प्रॉपर्टी.video
संसाधन कीtopicDetails.relevantTopicIds[]
प्रॉपर्टी.search.list
तरीके काtopicId
पैरामीटर.
-
ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.
ये प्रॉपर्टी अब काम नहीं करतीं:
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
संसाधनों को टारगेट करने की सुविधा देता है. चैनल सेक्शन को टारगेट करने से, किसी खास शर्त को पूरा करने वाले उपयोगकर्ताओं को कॉन्टेंट का सेक्शन सिर्फ़ दिखाया जा सकता है.यह एपीआई, टारगेटिंग के तीन विकल्प दिखाता है. चैनल के किसी सेक्शन को दिखाने के लिए, उपयोगकर्ता को टारगेटिंग की सभी सेटिंग पूरी करनी होंगी.
-
targeting.languages[]
: YouTube में ऐप्लिकेशन की भाषाओं की सूची. जिन उपयोगकर्ताओं ने इनमें से कोई एक भाषा चुनी है वे उससे जुड़े चैनल का सेक्शन देख सकते हैं. -
targeting.regions[]
: YouTube के लिए सुझाए गए कॉन्टेंट वाले देशों/इलाकों की सूची. चैनल सेक्शन, इनमें से किसी इलाके को चुनने वाले उपयोगकर्ताओं को दिखता है. साथ ही, यह उन लोगों को भी दिखता है जिनके लिए इस इलाके को अपने-आप चुना जाता है. -
targeting.countries[]
: उन देशों की सूची जहां चैनल सेक्शन दिखता है. सूची में मौजूद हर वैल्यू, ISO 3166-1 alpha-2 देश कोड है.
-
-
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
इस अपडेट में ये बदलाव किए गए हैं:
-
एपीआई के हर तरीके की जानकारी अपडेट कर दी गई है. ऐसा इसलिए किया गया है, ताकि उस तरीके को कॉल करने पर लगने वाला कोटा शामिल किया जा सके. इसी तरह,
part
पैरामीटर की परिभाषाओं को अपडेट किया गया है, ताकि एपीआई कॉल में हर उस हिस्से के कोटे की लागत बताई जा सके जिसे वापस पाया जा सकता है. उदाहरण के लिए,subscriptions.insert
तरीके को कॉल करने पर, कोटा की लागत करीब 50 यूनिट होती है.subscription
संसाधन में तीन हिस्से (snippet
,contentDetails
, औरsubscriberSnippet
) भी होते हैं और हर एक की कीमत दो यूनिट होती है.कृपया ध्यान रखें कि कोटा की कीमतें बिना किसी सूचना के बदल सकती हैं.
-
video
संसाधन अब कॉन्टेंट रेटिंग के 43 नए सिस्टम के साथ काम करता है. इन सिस्टम से, वीडियो को अलग-अलग राष्ट्रीय रेटिंग एजेंसियों से मिली रेटिंग की पहचान की जाती है. इन रेटिंग सिस्टम के नए रेटिंग सिस्टम, अर्जेंटीना, ऑस्ट्रेलिया, ऑस्ट्र, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेल टेलीविज़न, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेलीविज़न, (टेलीविज़न), चिली (फ़िल्म</11}), चेक गणराज्य, कोलंबिया, कोलंबिया, डेनमार्क, द के अब आप इन रेटिंग सिस्टम से, अब आप इन रेटिंग सिस्टम के मौजूदा रेटिंग सिस्टम: अर्जेंटीना, ऑस्ट्रेलिया, ऑ ऑस्ट्रिया, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेल टेलीविज़न, बेल्जियम, और बुल्गारिया, चिली (टेल टेलीविज़न, जैसे (टेलीविज़न), चिली (फ़िल्म</11}), चेक गणराज्य,
28 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
तरीका, अबlocation
औरlocationRadius
पैरामीटर के साथ काम करता है. इनकी मदद से, किसी जगह से जुड़े वीडियो खोजे जा सकते हैं. जगह के हिसाब से नतीजे पाने के लिए, अनुरोध में दोनों पैरामीटर की वैल्यू देनी होगी. अगर अनुरोध में दोनों पैरामीटर में से सिर्फ़ एक पैरामीटर शामिल है, तो एपीआई गड़बड़ी का मैसेज दिखाएगा.-
location
पैरामीटर, गोल आकार वाले भौगोलिक क्षेत्र के बीच में अक्षांश/देशांतर निर्देशांक बताता है. -
locationRadius
पैरामीटर से यह तय होता है कि किसी वीडियो से जुड़ी जगह, खोज के नतीजों में शामिल होने के लिए, एरिया के सेंटर से कितनी दूर हो सकती है.
-
13 मई, 2014
इस अपडेट में ये बदलाव किए गए हैं:
-
channel
संसाधन कीinvideoPromotion.items[]
प्रॉपर्टी को अपडेट कर दिया गया है. इससे यह पता चलता है कि आम तौर पर, अपने चैनल के लिए सिर्फ़ एक प्रमोशन वाला आइटम सेट किया जा सकता है. प्रमोशन वाले बहुत ज़्यादा आइटम डालने पर, एपीआई आपकोtooManyPromotedItems
गड़बड़ी का मैसेज दिखाएगा. इसमें एचटीटीपी400
स्टेटस कोड होगा. -
channelSection
संसाधन में, अब चुनिंदा कॉन्टेंट के कुछ नए टाइप के बारे में जानकारी शामिल की जा सकती है.channelSection
रिसॉर्स कीsnippet.type
प्रॉपर्टी में अब ये वैल्यू इस्तेमाल की जा सकती हैं:postedPlaylists
- ऐसी प्लेलिस्ट जिन्हें चैनल के मालिक ने चैनल के गतिविधि फ़ीड में पोस्ट किया हैpostedVideos
- ऐसे वीडियो जिन्हें चैनल के मालिक ने चैनल के गतिविधि फ़ीड में पोस्ट किया हैsubscriptions
- वे चैनल जिनकी सदस्यता चैनल के मालिक ने ली है
-
video
संसाधन की नईcontentDetails.contentRating.ifcoRating
प्रॉपर्टी, उस रेटिंग की पहचान करती है जो किसी वीडियो को आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस से मिली है. -
watermark
रिसॉर्स कीposition.cornerPosition
प्रॉपर्टी की परिभाषा को अपडेट किया गया है, ताकि यह ध्यान रखा जा सके कि वॉटरमार्क हमेशा प्लेयर के सबसे ऊपर दाएं कोने में दिखे. -
search.list
तरीके के लिएq
पैरामीटर की परिभाषा को अपडेट कर दिया गया है. इससे यह पता चला है कि खोज के लिए इस्तेमाल किए गए किसी शब्द से जुड़े वीडियो को हटाने के लिए, क्वेरी शब्द में बूलियन NOT (-
) ऑपरेटर का इस्तेमाल किया जा सकता है. यह वैल्यू, खोज के लिए इस्तेमाल हुए कई शब्दों में से किसी एक से जुड़े वीडियो ढूंढने के लिए, बूलियन OR (|
) ऑपरेटर का इस्तेमाल भी कर सकती है. -
search.list
कॉल के एपीआई रिस्पॉन्स में दिखने वालीpageInfo.totalResults
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि वैल्यू अनुमानित है और हो सकता है कि वह सटीक वैल्यू न दिखाए. इसके अलावा, ज़्यादा से ज़्यादा वैल्यू 1,000,000 हो सकती है. पेजों को क्रम में लगाने वाले लिंक बनाने के लिए आपको इस वैल्यू का इस्तेमाल नहीं करना चाहिए. इसके बजाय, पेजेशन लिंक दिखाने हैं या नहीं, यह तय करने के लिएnextPageToken
औरprevPageToken
प्रॉपर्टी वैल्यू का इस्तेमाल करें. -
watermarks.set
औरwatermarks.unset
तरीकों को अपडेट किया गया है, ताकि यह बताया जा सके कि एपीआई उन तरीकों के लिए किए गए अनुरोधों के जवाब में, एचटीटीपी204
रिस्पॉन्स कोड दिखाता है.
2 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
नया
i18nLanguage
संसाधन एक ऐसी ऐप्लिकेशन भाषा की पहचान करता है, जो YouTube वेबसाइट पर काम करती है. ऐप्लिकेशन की भाषा को यूज़र इंटरफ़ेस (यूआई) की भाषा के रूप में भी देखा जा सकता है. YouTube की वेबसाइट के लिए, Google खाते की सेटिंग, ब्राउज़र की भाषा या आईपी लोकेशन के आधार पर, ऐप्लिकेशन की भाषा अपने-आप चुनी जा सकती है. साथ ही, उपयोगकर्ता YouTube की साइट के फ़ुटर से, यूज़र इंटरफ़ेस (यूआई) की अपनी पसंदीदा भाषा को मैन्युअल तरीके से भी चुन सकता है.एपीआई, ऐप्लिकेशन पर इस्तेमाल की जा सकने वाली भाषाओं की सूची बनाने का एक तरीका उपलब्ध कराता है.
videoCategories.list
औरguideCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय, उन भाषाओं का इस्तेमाल किया जा सकता है जिनमेंhl
पैरामीटर की वैल्यू हो. -
नया
i18nRegion
रिसॉर्स, किसी भौगोलिक इलाके की पहचान करता है. YouTube का कोई उपयोगकर्ता, कॉन्टेंट के लिए पसंदीदा इलाके के तौर पर इस इलाके को चुन सकता है. कॉन्टेंट के क्षेत्र को कॉन्टेंट लोकेल भी कहा जा सकता है. YouTube वेबसाइट के लिए, YouTube डोमेन या उपयोगकर्ता के आईपी पते जैसे अनुभव के आधार पर कॉन्टेंट का इलाका अपने-आप चुना जा सकता है. साथ ही, उपयोगकर्ता YouTube साइट के फ़ुटर से, मैन्युअल तरीके से भी अपनी पसंद का कॉन्टेंट चुन सकता है.एपीआई, कॉन्टेंट के लिए उपलब्ध देशों/इलाकों की सूची बनाने का एक तरीका उपलब्ध कराता है.
search.list
,videos.list
,activities.list
, औरvideoCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय, इस्तेमाल किए जा सकने वाले रीजन कोड का इस्तेमाल,regionCode
पैरामीटर की वैल्यू के तौर पर किया जा सकता है.
7 अप्रैल, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
नए
channelSection
संसाधन में, उन वीडियो के सेट की जानकारी होती है जिन्हें चैनल ने हाइलाइट करने के लिए चुना है. उदाहरण के लिए, किसी सेक्शन में चैनल के हाल ही में अपलोड किए गए वीडियो, सबसे लोकप्रिय वीडियो या एक या एक से ज़्यादा प्लेलिस्ट के वीडियो दिखाए जा सकते हैं.एपीआई की मदद से, चैनल के सेक्शन सूची में जोड़े जा सकते हैं, शामिल किए जा सकते हैं, अपडेट किए जा सकते हैं या मिटाए जा सकते हैं. किसी खास चैनल आईडी की जानकारी देकर या यूनीक चैनल सेक्शन आईडी की सूची बताकर, पुष्टि किए गए उपयोगकर्ता के चैनल के चैनल सेक्शन की सूची फिर से हासिल की जा सकती है.
गड़बड़ी के उन मैसेज की जानकारी देने के लिए गड़बड़ी से जुड़े दस्तावेज़ को भी अपडेट कर दिया गया है जो एपीआई, इन नए तरीकों के लिए खास तौर पर काम करता है.
-
video
संसाधन केfileDetails
ऑब्जेक्ट की परिभाषा को अपडेट कर दिया गया है. इससे यह पता चलेगा कि वीडियो कीprocessingDetails.fileDetailsAvailability
प्रॉपर्टी की वैल्यूavailable
होने पर ही, ऑब्जेक्ट को दिखाया जाएगा.इसी तरह,
video
रिसॉर्स केsuggestions
ऑब्जेक्ट की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि वह ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब वीडियो कीprocessingDetails.tagSuggestionsAvailability
प्रॉपर्टी या उसकीprocessingDetails.editorSuggestionsAvailability
प्रॉपर्टी की वैल्यूavailable
हो. -
videos.insert
औरvideos.update
के तरीकों के दस्तावेज़ अपडेट कर दिए गए हैं. इससे यह जानकारी मिलेगी कि इन तरीकों को कॉल करते समय,status.publishAt
प्रॉपर्टी को सेट किया जा सकता है. -
channel
रिसॉर्स केinvideoPromotion
ऑब्जेक्ट की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है कि ऑब्जेक्ट को सिर्फ़ चैनल का मालिक ही वापस ला सकता है. -
videos.rate
तरीके की पैरामीटर सूची को अपडेट कर दिया गया है. इससे यह जानकारी मिलेगी कि यह तरीका असल मेंonBehalfOfContentOwner
पैरामीटर के साथ काम नहीं करता. यह दस्तावेज़ से जुड़ी गड़बड़ी थी, क्योंकि इस पैरामीटर को सेट करने वालेvideos.rate
अनुरोधों से500
गड़बड़ी का मैसेज मिलता है.
31 मार्च, 2014
इस अपडेट में ये बदलाव किए गए हैं:
-
video
संसाधन की नईstatus.publishAt
प्रॉपर्टी की मदद से, किसी निजी वीडियो को पब्लिश करने की तारीख और समय तय किया जा सकता है. इस प्रॉपर्टी को सिर्फ़ तब सेट किया जा सकता है, जब वीडियो की निजता स्थितिprivate
हो और वीडियो कभी पब्लिश न हुआ हो. इस नई प्रॉपर्टी पर इस्तेमाल बंद करने से जुड़ी नीति लागू नहीं होती.
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
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API, वर्शन 3 अब YouTube API की सेवा की शर्तों में बताई गई, बंद किए जाने की नीति के दायरे में आता है. ध्यान दें कि ऐसे एपीआई जिन पर बंद किए जाने की नीति लागू होती है की सूची वाले पेज पर, v3 API की कुछ सुविधाओं को इस नीति के दायरे से बाहर रखा गया है.
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
प्रॉपर्टी से पता चलता है कि अपडेट किए गए वीडियो या अपलोड किए गए नए वीडियो, उस वीडियो की कैटगरी में जोड़े जा सकते हैं या नहीं. -
यहां दिए गए तरीकों के लिए, कोड के सैंपल जोड़े गए हैं:
activities.insert
(जाएं)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(जाएं)search.list
(जाएं)thumbnails.set
(जावा)videos.insert
(Go)
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
हो गई है. -
यहां दिए गए तरीकों के लिए, कोड के सैंपल जोड़े गए हैं:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(फ़िलिपीन पेसो)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
ध्यान दें कि
playlistItems.insert
तरीके के लिए Python का उदाहरण भी हटा दिया गया है, क्योंकि इसमें दिखाई गई सुविधा अबvideos.rate
तरीके से मैनेज की जाती है. -
error documentation
में अनुरोध के कॉन्टेक्स्ट से जुड़ी यहां दी गई नई गड़बड़ी के बारे में बताया गया है. यह गड़बड़ी,mine
अनुरोध पैरामीटर के साथ काम करने वाले किसी भी एपीआई तरीके से हो सकती है:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
invalidMine
mine
पैरामीटर का इस्तेमाल उन अनुरोधों में नहीं किया जा सकता जिनमें पुष्टि किए गए उपयोगकर्ता, YouTube पार्टनर हैं. आपको या तोmine
पैरामीटर को हटा देना चाहिए,onBehalfOfContentOwner
पैरामीटर को हटाकर, YouTube उपयोगकर्ता के तौर पर पुष्टि करनी चाहिए. इसके अलावा, अगर कॉल किए गए तरीके के लिए उपलब्ध हो, तोonBehalfOfContentOwnerChannel
पैरामीटर देकर, पार्टनर के एक चैनल के तौर पर काम करना चाहिए.
8 अगस्त, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API का इस्तेमाल शुरू करना गाइड के कोटा का इस्तेमाल सेक्शन अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि वीडियो अपलोड करने की कोटा लागत को करीब 16,000 यूनिट से बदलकर करीब 1600 यूनिट कर दिया गया हो.
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
इस अपडेट में ये बदलाव किए गए हैं:
-
YouTube अब एक्सपेरिमेंट के तौर पर उपलब्ध एपीआई की सुविधाओं और सेवाओं की पहचान नहीं करता. इसके बजाय, अब हम YouTube के उन एपीआई की सूची उपलब्ध कराते हैं जिन पर बंद किए जाने की नीति लागू होती है.
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
– प्रॉपर्टी, उस चैनल का नाम बताती है जिसकी सदस्यता ली गई है.
-
इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
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
में जोड़ा गया है: -
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
इस अपडेट में ये बदलाव शामिल हैं:
-
अब नीचे दी गई सूची में दिखाई गई विधियों और भाषाओं के लिए कोड सैंपल उपलब्ध हैं:
activities.insert
– जावाplaylistItems.insert
– PythonplaylistItems.list
– Java, JavaScript, PHP, Python, Rubyplaylists.insert
– Java, JavaScript, Pythonsearch.list
– Java, JavaScript, Python, Rubyvideos.insert
– जावा
-
अब
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 तरीके का इस्तेमाल करें.