इस पेज पर, YouTube Data API (v3) में हुए बदलाव और दस्तावेज़ से जुड़े अपडेट दिए गए हैं. इस बदलाव लॉग की सदस्यता लें.
30 अप्रैल, 2024
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
इस अपडेट में ये बदलाव शामिल हैं:
एपीआई अब चैनल की चर्चा को शामिल करने या उसे वापस पाने की सुविधा नहीं देता. यह बदलाव YouTube की वेबसाइट की सुविधाओं के हिसाब से है. इस सुविधा से चैनलों पर टिप्पणी नहीं की जा सकती.
13 मार्च, 2024
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
इस अपडेट में ये बदलाव शामिल हैं:
captions.insert
और captions.update
तरीकों के लिए, sync
पैरामीटर को हटा दिया गया है. YouTube, 12 अप्रैल, 2024 से पैरामीटर के साथ काम करना बंद कर देगा.
इस बदलाव के तहत, डेवलपर को कैप्शन ट्रैक जोड़ते या अपडेट करते समय समय से जुड़ी जानकारी शामिल करनी होगी. ऐसा न करने पर, कैप्शन अपलोड नहीं हो पाएंगे.
12 मार्च, 2024
इस अपडेट में ये बदलाव शामिल हैं:
captions
संसाधन के लिए दस्तावेज़ों को अपडेट किया गया है. ऐसा इसलिए किया गया है, क्योंकि snippet.name
फ़ील्ड में ज़्यादा से ज़्यादा 150 वर्ण इस्तेमाल किए जा सकते हैं. अगर ट्रैक का नाम, इससे ज़्यादा लंबा है, तो एपीआई nameTooLong
गड़बड़ी दिखाता है.
7 मार्च, 2024
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
channel
रिसॉर्स प्रॉपर्टी
brandingSettings.channel.moderateComments
अब काम नहीं करती. YouTube, 7 मार्च, 2024 से इस पैरामीटर का इस्तेमाल नहीं करेगा.
31 जनवरी, 2024
इस अपडेट में ये बदलाव शामिल हैं:
channels.list
तरीके के नए forHandle
पैरामीटर की मदद से, किसी चैनल के YouTube हैंडल की जानकारी देकर उसके बारे में जानकारी पाई जा सकती है.
9 नवंबर, 2023
Comments
में मौजूद videoId
संसाधन के सभी रेफ़रंस हटा दिए गए हैं, क्योंकि एपीआई कॉल का इस्तेमाल करके videoId
संसाधन नहीं दिया जा रहा है.
12 सितंबर, 2023
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
comments.markAsSpam
तरीका
कई सालों से काम नहीं कर रहा है. यह तरीका YouTube पर पहले से काम नहीं करता है और
अब एपीआई के ज़रिए काम नहीं करता है.
comments.markAsSpam
तरीके का इस्तेमाल करने वाले सभी दस्तावेज़ों में, एपीआई बंद होने की सूचना जोड़ी गई है.
22 अगस्त, 2023
search.list
वाला तरीका अब
videoPaidProductPlacement
पैरामीटर के साथ काम करता है. इस पैरामीटर की मदद से, खोज के नतीजों को फ़िल्टर किया जा सकता है. ऐसा करके, खोज के नतीजों में सिर्फ़ ऐसे वीडियो शामिल किए जा सकते हैं जिन्हें क्रिएटर ने पैसे लेकर किए गए प्रमोशन के तौर पर दिखाया है.
18 अगस्त, 2023
video
के रिसॉर्स के liveStreamingDetails.concurrentViewers
की परिभाषा में यह बदलाव किया गया है कि एक ही समय पर देखने वाले दर्शक की यह गिनती होती है कि YouTube Data API,
YouTube Analytics में एक साथ दिखाए जाने वाले, प्रोसेस किए गए और बिना स्पैम वाले दर्शकों की संख्या से अलग हो सकता है. लाइव स्ट्रीमिंग की मेट्रिक के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.
7 अगस्त, 2023
जैसा कि 12 जून, 2023 को बताया गया था, search.list
तरीके के
relatedToVideoId
पैरामीटर को बंद कर दिया गया है. वह पैरामीटर अब काम नहीं करता.
साथ ही, एपीआई दस्तावेज़ों से पैरामीटर के रेफ़रंस हटा दिए गए हैं.
28 जून, 2023
thumbnails.set वाला तरीका अब uploadRateLimitExceeded
गड़बड़ी के साथ काम करता है. इससे पता चलता है कि चैनल पर पिछले 24 घंटों में कई थंबनेल अपलोड किए गए हैं. कुछ देर बाद कोशिश करें.
12 जून, 2023
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
search.list तरीके के
relatedToVideoId
पैरामीटर को हटा दिया गया है. YouTube, 7 अगस्त, 2023 से इस पैरामीटर के साथ काम करना बंद कर देगा.
फ़िलहाल, search.list
तरीके के दस्तावेज़ में इस्तेमाल पर रोक लगाने की सूचना जोड़ी गई है. यह पैरामीटर 7 अगस्त, 2023 को या उसके बाद, search.list
दस्तावेज़ से पूरी तरह से हटा दिया जाएगा.
साथ ही, मिलते-जुलते वीडियो वापस पाने का तरीका बताने वाले उदाहरण को एपीआई लागू करने की गाइड से हटा दिया गया है.
22 अगस्त, 2022
बिना साइन किए हुए लॉन्ग स्ट्रिंग की वैल्यू में, video.statistics के लिए दिए गए फ़ील्ड के लिए, सही तरह के एनोटेशन दिए गए थे.
5 अगस्त, 2022
YouTube ने कैप्शन आईडी जनरेट करने का तरीका बदल दिया है और इस बदलाव के तहत, YouTube सभी कैप्शन ट्रैक के लिए नए कैप्शन आईडी असाइन कर रहा है. यह बदलाव उन ऐप्लिकेशन के लिए, पुराने सिस्टम के साथ काम न करने वाला बदलाव हो सकता है जो
caption_id
वैल्यू स्टोर करते हैं. हालांकि,
इससे उन ऐप्लिकेशन पर कोई असर नहीं पड़ेगा जो
caption_id
वैल्यू को सेव नहीं करते.
अभी से 1 दिसंबर, 2022 के बीच,
captions.list
,
captions.update
,
captions.download
, और captions.delete
तरीके
पुराने और नए, दोनों कैप्शन ट्रैक आईडी के साथ काम करेंगे. हालांकि, 1 दिसंबर, 2022 या इसके बाद YouTube, पुराने कैप्शन ट्रैक आईडी का इस्तेमाल नहीं करेगा. उस समय, इनमें से किसी भी एपीआई तरीके को
पुराने कैप्शन ट्रैक आईडी के साथ कॉल करने पर,
captionNotFound
गड़बड़ी हो सकती है.
इस बदलाव के लिए तैयार रहने के लिए, आपको अभी से 1 दिसंबर, 2022 के बीच, सेव किए गए कैप्शन ट्रैक के सभी डेटा को पूरी तरह से बदलना होगा. इसका मतलब है कि जिस वीडियो के लिए कैप्शन ट्रैक का डेटा सेव किया जाता है उसके लिए आपको सेव किया गया मौजूदा डेटा मिटाना होगा. इसके बाद, captions.list
वाले तरीके का इस्तेमाल करके वीडियो के लिए कैप्शन ट्रैक का मौजूदा सेट वापस पाया जा सकता है. साथ ही, डेटा को एपीआई रिस्पॉन्स में सेव किया जा सकता है, जैसा कि आम तौर पर किया जाता है.
12 जुलाई, 2022
YouTube API सेवाओं की सेवा की शर्तें अपडेट कर दी गई हैं. ज़्यादा जानकारी के लिए, कृपया YouTube API सेवाओं की सेवा की शर्तें - बदलावों का इतिहास देखें.
27 अप्रैल, 2022
videos.insert
तरीके की जानकारी को अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि अपलोड किए जा रहे वीडियो की फ़ाइल का ज़्यादा से ज़्यादा साइज़ 128 जीबी से बढ़ाकर 256 जीबी कर दिया जाए.
8 अप्रैल, 2022
subscriptions.list
तरीके की
myRecentSubscribers
और mySubscribers
पैरामीटर परिभाषाएं
दोनों को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि यह ध्यान रखा जा सके कि एपीआई की मदद से, ज़्यादा से ज़्यादा सदस्यों की संख्या सीमित हो सकती है.
यह बदलाव दस्तावेज़ में सुधार करता है, न कि एपीआई के काम करने के तरीके में कोई बदलाव.
15 दिसंबर, 2021
जैसा कि 18 नवंबर, 2021 को बताया गया था,
YouTube के सभी प्लैटफ़ॉर्म पर, वीडियो नापसंद करने की संख्या निजी बनाने में बदलाव के साथ, video
रिसॉर्स की
statistics.dislikeCount
प्रॉपर्टी अब निजी हो गई है.
इस बदलाव के बारे में ज़्यादा जानने के लिए, YouTube के आधिकारिक ब्लॉग पर जाएं.
18 नवंबर, 2021
YouTube के पूरे प्लैटफ़ॉर्म पर, वीडियो नापसंद किए जाने की संख्या को निजी बनाने में बदलाव के साथ-साथ, video
संसाधन की statistics.dislikeCount
प्रॉपर्टी को 13 दिसंबर, 2021 से निजी के तौर पर सेट कर दिया जाएगा. इसका मतलब है कि प्रॉपर्टी को videos.list
एंडपॉइंट से एपीआई रिस्पॉन्स में सिर्फ़ तब शामिल किया जाएगा, जब एपीआई के अनुरोध की
वीडियो के मालिक ने पुष्टि की हो.
इस बदलाव से videos.rate
एंडपॉइंट पर
कोई असर नहीं पड़ेगा.
ऐसे डेवलपर जो वीडियो नापसंद किए जाने की संख्या को सार्वजनिक तौर पर नहीं दिखाते हैं और फिर भी उन्हें अपने एपीआई क्लाइंट के लिए वीडियो नापसंद किए जाने की संख्या की ज़रूरत होती है वे छूट पाने के लिए आवेदन कर सकते हैं. छूट का आवेदन करने के लिए, आपको यह आवेदन फ़ॉर्म भरना होगा.
इस बदलाव के बारे में ज़्यादा जानने के लिए, YouTube के आधिकारिक ब्लॉग पर जाएं.
2 जुलाई, 2021
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
commentThreads.update
एंडपॉइंट के इस्तेमाल पर रोक लगा दी गई है और अब यह काम नहीं करता.
इस एंडपॉइंट ने डुप्लीकेट फ़ंक्शन बनाया है और यह अन्य एपीआई एंडपॉइंट के ज़रिए उपलब्ध है. इसके बजाय, comments.update
पर कॉल करें
commentThreads
रिसॉर्स की ज़रूरत है, तो
commentThreads.list
तरीके को दूसरा कॉल करें.
1 जुलाई, 2021
YouTube की एपीआई सेवाओं का इस्तेमाल करने वाले सभी डेवलपर को एपीआई की नीतियों के पालन की जांच पूरी करनी होगी. ऐसा करने पर, उन्हें 10,000 से ज़्यादा यूनिट चुनने के लिए, डिफ़ॉल्ट तौर पर तय कोटा से ज़्यादा की अनुमति मिलेगी. अब तक, डेवलपर ने अनुपालन ऑडिट प्रोसेस और अतिरिक्त कोटा यूनिट तय करने के अनुरोध, दोनों ही YouTube API सेवाएं - ऑडिट और कोटा एक्सटेंशन फ़ॉर्म भरकर सबमिट किए हैं.
इन प्रोसेस के बारे में साफ़ तौर पर बताने और हमारी एपीआई सेवाओं का इस्तेमाल करने वाले डेवलपर की ज़रूरतों को बेहतर ढंग से पूरा करने के लिए, हम तीन नए फ़ॉर्म जोड़ रहे हैं. साथ ही, इन फ़ॉर्म को भरने के लिए एक गाइड जोड़ रहे हैं:
- ऑडिट किए गए डेवलपर के अनुरोध फ़ॉर्म: जिन डेवलपर ने पहले ही एपीआई के अनुपालन के ऑडिट को पास कर लिया है वे असाइन किए गए कोटा एक्सटेंशन का अनुरोध करने के लिए, इस छोटे फ़ॉर्म को भरकर सबमिट कर सकते हैं.
- अपील फ़ॉर्म: जिन डेवलपर के एपीआई प्रोजेक्ट, नीतियों के पालन से जुड़े ऑडिट में फ़ेल हो गए हैं या जिन्हें कोटा यूनिट बढ़ाने से मना कर दिया गया है वे यह फ़ॉर्म भरकर सबमिट कर सकते हैं.
- कंट्रोल में बदलाव के लिए फ़ॉर्म: एपीआई प्रोजेक्ट से जुड़े डेवलपर या एपीआई क्लाइंट को चलाने वाला कोई भी पक्ष, जिसे एपीआई प्रोजेक्ट से जुड़े कंट्रोल में बदलाव (उदाहरण के लिए, स्टॉक की खरीदारी या बिक्री, किसी मर्जर या किसी अन्य तरह के कॉर्पोरेट लेन-देन के ज़रिए) का अनुभव करना हो, उसे यह फ़ॉर्म भरकर सबमिट करना होगा. इससे YouTube की एपीआई टीम हमारे रिकॉर्ड को अपडेट करती है, एपीआई प्रोजेक्ट के इस्तेमाल के उदाहरण की शर्तों के अनुपालन की जांच करती है, और डेवलपर की मौजूदा तय सीमा की पुष्टि करती है.
हर नए फ़ॉर्म से हमें यह जानकारी मिलेगी कि आप YouTube API का इस्तेमाल किस तरह करते हैं. साथ ही, इससे हम बेहतर ढंग से आपकी मदद कर पाएंगे.
ज़्यादा जानकारी के लिए, हमारी नई एपीआई कंप्लायंस ऑडिट गाइड देखें.
12 मई, 2021
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
इस अपडेट में, एपीआई से जुड़े ये बदलाव शामिल हैं:
-
channel
संसाधन कीcontentDetails.relatedPlaylists.favorites
प्रॉपर्टी अब काम नहीं करती. जैसा कि 28 अप्रैल, 2016 में, बदलावों के इतिहास की एंट्री में बताया गया है, पसंदीदा वीडियो की सुविधा कई सालों से बंद है.अगर एपीआई क्लाइंट ने किसी ऐसी पसंदीदा प्लेलिस्ट में वीडियो जोड़ने की कोशिश की जो मौजूद नहीं थी, तो एपीआई इस अपडेट से पहले एक नई प्लेलिस्ट बनाएगा. आगे से, इस मामले में प्लेलिस्ट नहीं बनाई जाएगी और एपीआई आपको गड़बड़ी दिखाएगा. आइटम को जोड़कर, उनमें बदलाव करके या उन्हें मिटाकर, पसंदीदा प्लेलिस्ट में बदलाव करने की कोशिशों पर भी रोक लगा दी गई है. ऐसा करने पर, किसी भी समय गड़बड़ी का मैसेज दिख सकता है.
-
यहां दी गई
channel
रिसॉर्स प्रॉपर्टी अब काम नहीं करतीं. ये प्रॉपर्टी, YouTube Studio के यूज़र इंटरफ़ेस और YouTube पर पहले से ही काम करती हैं. इस वजह से, अब ये एपीआई के ज़रिए भी काम नहीं करते.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
सभी प्रॉपर्टी को
channel
रिसॉर्स दिखाने से हटा दिया गया है. साथ ही, उनकी परिभाषाओं को संसाधन की प्रॉपर्टी की सूची से हटा दिया गया है. इसके अलावा, इन प्रॉपर्टी से जुड़ी गड़बड़ियों को किसी खास तरीके से जुड़े दस्तावेज़ से हटा दिया गया है. -
यहां दी गई
channelSection
रिसॉर्स प्रॉपर्टी अब काम नहीं करतीं. ये प्रॉपर्टी, YouTube Studio के यूज़र इंटरफ़ेस और YouTube पर पहले से ही काम करती हैं. इस वजह से, अब ये एपीआई के ज़रिए भी काम नहीं करते.snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
इस बदलाव के साथ ही,
channelSection.list
तरीके केhl
पैरामीटर को भी बंद कर दिया गया है, क्योंकि इसके साथ काम करने वाली सुविधाएं काम नहीं करतीं.सभी प्रॉपर्टी को
channelSection
रिसॉर्स दिखाने से हटा दिया गया है. साथ ही, उनकी परिभाषाओं को संसाधन की प्रॉपर्टी की सूची से हटा दिया गया है. इसके अलावा, इन प्रॉपर्टी से जुड़ी गड़बड़ियों को किसी खास तरीके से जुड़े दस्तावेज़ से हटा दिया गया है. -
channelSection
संसाधन कीsnippet.type
प्रॉपर्टी के लिए, नीचे दी गई वैल्यू हटा दी गई हैं. ये वैल्यू पहले से ही YouTube चैनल के पेजों पर काम नहीं करती हैं. इस वजह से, ये अब एपीआई के ज़रिए भी काम नहीं करतीं.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
playlist
संसाधन कीsnippet.tags[]
प्रॉपर्टी अब काम नहीं करती. यह प्रॉपर्टी पहले से ही YouTube पर काम नहीं करती है. इस वजह से, यह अब एपीआई के ज़रिए काम नहीं करती.
9 फ़रवरी, 2021
playlistItem
संसाधन दो नई प्रॉपर्टी के साथ काम करता है:
snippet.videoOwnerChannelId
प्रॉपर्टी, प्लेलिस्ट का वीडियो अपलोड करने वाले चैनल के आईडी की पहचान करती है.snippet.videoOwnerChannelTitle
प्रॉपर्टी, प्लेलिस्ट का वीडियो अपलोड करने वाले चैनल के नाम की पहचान करती है.
28 जनवरी, 2021
इस अपडेट में ये बदलाव शामिल हैं:
-
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
, औरplaylists.update
तरीकों में,playlistOperationUnsupported
की नई गड़बड़ी काम करती है. गड़बड़ी तब होती है, जब कोई अनुरोध ऐसी कार्रवाई करने की कोशिश करता है जिसकी किसी खास प्लेलिस्ट के लिए अनुमति नहीं है. उदाहरण के लिए, उपयोगकर्ता न तो किसी वीडियो को अपलोड की गई वीडियो की प्लेलिस्ट से मिटा सकता है और न ही उसे मिटा सकता है.सभी मामलों में यह गड़बड़ी,
400
एचटीटीपी रिस्पॉन्स कोड (गलत अनुरोध) दिखाती है. -
playlistItems.list
तरीके कीwatchHistoryNotAccessible
औरwatchLaterNotAccessible
गड़बड़ियों को दस्तावेज़ से हटा दिया गया है. हालांकि, लोगों के 'देखने का इतिहास' और 'बाद में देखें' की सूचियों को एपीआई की मदद से ऐक्सेस नहीं किया जा सकता. हालांकि, एपीआई इस तरह की गड़बड़ियों को नहीं दिखाता है.
15 अक्टूबर, 2020
डेवलपर के लिए नीतियों में दो नए सेक्शन जोड़े गए हैं:
- नए सेक्शन III.E.4.i में, YouTube के एम्बेड किए गए प्लेयर से इकट्ठा किए गए और भेजे गए डेटा के बारे में ज़्यादा जानकारी दी गई है. YouTube पर एम्बेड किए गए किसी भी प्लेयर से, उपयोगकर्ता का कोई डेटा तब भेजा जाएगा, जब वह वीडियो चलाने के इंटेंट के बारे में जानकारी देगा. हालांकि, इससे पहले कि उपयोगकर्ता का डेटा, YouTube पर एम्बेड किए गए प्लेयर से इंटरैक्ट करता है. 'वीडियो अपने-आप चलने की सुविधा' को 'गलत है' पर सेट करके, यह तय किया जा सकता है कि कोई उपयोगकर्ता, प्लेयर से इंटरैक्ट करे और YouTube के साथ किस तरह का डेटा शेयर किया जाए.
- नया सेक्शन III.E.4.j, अपनी साइटों और ऐप्लिकेशन पर एम्बेड करने से पहले 'बच्चों के लिए बना' (एमएफ़के) की स्थिति की जांच करने से जुड़ा है. यह जानना आपकी ज़िम्मेदारी है कि एपीआई क्लाइंट पर एम्बेड किए गए वीडियो, बच्चों के लिए कब बनाए जाते हैं. साथ ही, एम्बेड किए गए प्लेयर से इकट्ठा किए गए डेटा का इस्तेमाल कब किया जाता है. इसलिए, YouTube पर एम्बेड किए गए किसी भी प्लेयर की मदद से, अपने एपीआई क्लाइंट पर कॉन्टेंट को एम्बेड करने से पहले, आपको YouTube Data API सेवा का इस्तेमाल करके कॉन्टेंट की स्थिति देखनी होगी.
वीडियो पर बच्चों के लिए बने वीडियो की स्थिति ढूंढना वाली नई गाइड में, YouTube Data API सेवा का इस्तेमाल करके, किसी वीडियो के लिए बच्चों के लिए बने वीडियो की स्थिति देखने का तरीका बताया गया है.
इन बदलावों के साथ ही, एम्बेड किए गए प्लेयर के पैरामीटर के दस्तावेज़ में एक रिमाइंडर जोड़ा गया है. इसमें यह बताया गया है कि अगर अपने-आप चलने की सुविधा चालू की जाती है, तो प्लेयर के साथ उपयोगकर्ता के किसी भी इंटरैक्शन के बिना वीडियो चलाया जाएगा. इसलिए, पेज लोड होने पर ही वीडियो चलाने का डेटा इकट्ठा और शेयर किया जाएगा.
8 अक्टूबर, 2020
इस अपडेट में,
channel
संसाधन से जुड़े तीन छोटे बदलावों को शामिल किया गया है:
snippet.thumbnails
ऑब्जेक्ट, चैनल के थंबनेल इमेज की पहचान करता है. ऐसा हो सकता है कि बनाए गए नए चैनलों के लिए, यह खाली न हो और इसे दिखने में एक दिन तक का समय लग सकता है.statistics.videoCount
प्रॉपर्टी से पता चलता है कि चैनल पर कितने सार्वजनिक वीडियो मौजूद हैं. यहां तक कि उसके मालिक भी कितने वीडियो देख सकते हैं. ऐसा YouTube की वेबसाइट पर दिखने वाली संख्या के मुताबिक ही होता है.brandingSettings.channel.keywords
प्रॉपर्टी में पहचाने गए चैनल कीवर्ड में काट-छांट की जा सकती है, अगर वे 500 वर्णों की तय सीमा को पार कर गए हों या उनमें ऐसे कोटेशन मार्क ("
) हों जिन्हें एस्केप न किया गया हो. ध्यान दें कि 500 वर्ण की सीमा, हर कीवर्ड के लिए नहीं, बल्कि सभी कीवर्ड की कुल लंबाई के लिए तय की गई है. ऐसा YouTube की वेबसाइट पर मौजूद ऐसा ही है.
9 सितंबर, 2020
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
इस अपडेट में, एपीआई से जुड़े ये बदलाव शामिल हैं. सभी बदलाव, 9 सितंबर, 2020 को या इसके बाद लागू होंगे. इसे ध्यान में रखते हुए, डेवलपर को अब यहां दी गई एपीआई की किसी भी सुविधा पर भरोसा नहीं करना चाहिए.
-
नीचे दिए गए एपीआई के संसाधन, तरीके, पैरामीटर, और संसाधन प्रॉपर्टी तुरंत बंद कर दी जाती हैं.
साथ ही, यह सूचना मिलने की तारीख पर या उसके बाद ये काम करना बंद कर देंगी:
- ये
channel
रिसॉर्स प्रॉपर्टी:statistics.commentCount
प्रॉपर्टीbrandingSettings.image
ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टीbrandingSettings.hints
सूची और उसकी सभी चाइल्ड प्रॉपर्टी
channels.list
तरीके काcategoryId
फ़िल्टर पैरामीटरguideCategories
रिसॉर्स औरguideCategories.list
तरीका
- ये
-
अगर एपीआई अनुरोध,
managedByMe
पैरामीटर कोtrue
पर सेट करता है, तोchannels.list
तरीके के लिए एपीआई के रिस्पॉन्स में अबprevPageToken
प्रॉपर्टी शामिल नहीं होगी. इस बदलाव का असर,channels.list
के अन्य अनुरोधों के लिएprevPageToken
प्रॉपर्टी पर नहीं पड़ेगा. साथ ही, किसी भी अनुरोध के लिए,nextPageToken
प्रॉपर्टी पर कोई असर नहीं पड़ेगा. -
channel
संसाधन कीcontentDetails.relatedPlaylists.watchLater
औरcontentDetails.relatedPlaylists.watchHistory
प्रॉपर्टी, दोनों का एलान 11 अगस्त, 2016 को बंद कर दिया गया था. इन प्लेलिस्ट के लिए,playlistItems.insert
वाले तरीके औरplaylistItems.delete
तरीके के साथ काम करने की सुविधा भी अब पूरी तरह से बंद कर दी गई है. साथ ही, इन दोनों प्रॉपर्टी को दस्तावेज़ से हटा दिया गया है. -
channels.list
तरीके केmySubscribers
पैरामीटर को दस्तावेज़ से हटा दिया गया है. यह पैरामीटर 30 जुलाई, 2013 को बंद कर दिया गया था. पुष्टि किए गए उपयोगकर्ता के चैनल पर सदस्यों की सूची फिर से पाने के लिए,subscriptions.list
तरीके और उसकेmySubscribers
पैरामीटर का इस्तेमाल करें. -
channel
रिसॉर्स केinvideoPromotion
ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी को दस्तावेज़ से हटा दिया गया है. इन चाइल्ड प्रॉपर्टी का एलान, 27 नवंबर, 2017 को बंद कर दिया गया था.
29 जुलाई, 2020
हमने part
पैरामीटर से जुड़े अतिरिक्त शुल्क को हटाकर, एपीआई अनुरोधों के लिए कोटा चार्ज करने की अपनी प्रोसेस को आसान बना दिया है. बदलाव तुरंत लागू होने के बाद, हम जिस तरीके का इस्तेमाल करते हैं उसके लिए
सिर्फ़ मूल शुल्क लेंगे. आसान कोटे के बारे में ज़्यादा जानकारी
यहां मिल सकती है.
इस बदलाव से ज़्यादातर एपीआई कॉल का कोटा थोड़ा कम होगा. हालांकि, कुछ एपीआई कॉल की लागत अब भी एक जैसी होगी. इस बदलाव से किसी भी एपीआई कॉल की लागत नहीं बढ़ती. कुल मिलाकर, इसका असर यह होगा कि आपको जो कोटा मिलेगा उसे Google Cloud Console में देखा जा सकता है.
हमारा सुझाव है कि सभी डेवलपर अपने प्रोजेक्ट का अनुपालन ऑडिट करें, ताकि YouTube API सेवाओं का ऐक्सेस बना रहे.
बदलावों के इतिहास की यह एंट्री मूल रूप से 20 जुलाई, 2020 को पब्लिश की गई थी.
28 जुलाई, 2020
videos.insert
एंडपॉइंट से
28 जुलाई, 2020 के बाद बनाए गए ऐसे एपीआई प्रोजेक्ट से अपलोड किए गए सभी वीडियो निजी तौर पर देखे जा सकेंगे जिनकी पुष्टि नहीं हुई है. इस पाबंदी को हटाने के लिए, हर प्रोजेक्ट का ऑडिट करना ज़रूरी है, ताकि यह पुष्टि की जा सके कि वह सेवा की शर्तों का पालन करता है या नहीं.
जिन क्रिएटर्स ने वीडियो अपलोड करने के लिए, बिना पुष्टि वाले एपीआई क्लाइंट का इस्तेमाल किया है उन्हें एक ईमेल मिलेगा. इसमें बताया जाएगा कि उनका वीडियो 'निजी' के तौर पर सेट है. साथ ही, उन्हें आधिकारिक या ऑडिट किए गए क्लाइंट का इस्तेमाल करके, पाबंदी से बचा जा सकता है.
फ़िलहाल, 28 जुलाई, 2020 से पहले बनाए गए एपीआई प्रोजेक्ट पर इस बदलाव का कोई असर नहीं पड़ेगा. हालांकि, हमारा सुझाव है कि सभी डेवलपर अपने प्रोजेक्ट के लिए अनुपालन ऑडिट पूरा करें, ताकि YouTube API की सेवाओं का ऐक्सेस बना रहे.
21 जुलाई, 2020
[28 जुलाई, 2020 को अपडेट किया गया.] बदलावों के इतिहास की इस एंट्री में रेफ़र किए गए दस्तावेज़ के अपडेट को 28 जुलाई, 2020 को फिर से पब्लिश किया गया था.
कल हमने कोटा चार्ज करने की अपनी प्रक्रिया के बारे में एक दस्तावेज़ अपडेट पब्लिश किया था. हालांकि, अचानक होने वाली वजहों से, कोटा में बदलाव अभी लागू नहीं किया गया है. इस वजह से, दस्तावेज़ सही तरीके से हटाए गए हैं, इसे ध्यान में रखते हुए उन्हें पहले जैसा कर दिया गया है. किसी भी तरह की ग़लतफ़हमी से बचने के लिए, बदलाव के बारे में बताने वाली पुरानी जानकारी को हटा दिया गया है और आने वाले समय में इसे फिर से पब्लिश किया जाएगा.
7 जुलाई, 2020
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
videos.insert
वाले तरीके के autoLevels
और stabilize
पैरामीटर अब काम नहीं करते. साथ ही, दोनों पैरामीटर को दस्तावेज़ से हटा दिया गया है. उनकी वैल्यू को नज़रअंदाज़ कर दिया जाता है और उनका अपलोड
किए गए नए वीडियो प्रोसेस करने के तरीके पर कोई असर नहीं पड़ता.
15 जून, 2020
डेवलपर के लिए बनाई गई YouTube की नीतियों का पालन करना गाइड में, दिशा-निर्देश और उदाहरण दिए गए हैं. इनसे आपको यह पक्का करने में मदद मिलती है कि आपके एपीआई क्लाइंट, YouTube API सेवाओं की शर्तों और नीतियों (एपीआई की सेवा की शर्तों) के खास हिस्सों का पालन करें.
इस दिशा-निर्देश में इस बारे में अहम जानकारी दी गई है कि YouTube, एपीआई की सेवा की शर्तों के कुछ पहलुओं को कैसे लागू करता है. हालांकि, यह किसी मौजूदा दस्तावेज़ की जगह नहीं लेता. गाइड में कुछ ऐसे सामान्य सवालों के जवाब दिए गए हैं जो डेवलपर, एपीआई के अनुपालन से जुड़े ऑडिट के दौरान पूछते हैं. हमें उम्मीद है कि इससे आपको सुविधाओं को बेहतर बनाने में मदद मिलेगी. साथ ही, आपको यह समझने में मदद मिलेगी कि हम अपनी नीतियों को किस तरह समझते हैं और उन्हें लागू करते हैं.
4 जून, 2020
ध्यान दें: यह सुविधा, इस सुविधा को बंद करने से जुड़ी पिछली सूचना से जुड़ा अपडेट है.
चैनल बुलेटिन की सुविधा अब पूरी तरह से बंद कर दी गई है. शुरुआत में इस बदलाव का एलान 17 अप्रैल, 2020 को किया गया था. अब यह लागू हो गया है. इस वजह से, activities.insert
तरीका अब
काम नहीं करता. साथ ही, activities.list
तरीका अब चैनल बुलेटिन नहीं दिखाता. ज़्यादा जानकारी के लिए, कृपया
YouTube सहायता केंद्र पर जाएं.
17 अप्रैल, 2020
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
YouTube, चैनल बुलेटिन की सुविधा बंद कर रहा है. इस वजह से, activities.insert
तरीका काम नहीं करेगा और activities.list
वाला तरीका चैनल बुलेटिन दिखाना बंद कर देगा. एपीआई में, ये बदलाव 18 मई, 2020 से या उसके बाद लागू होंगे. ज़्यादा जानकारी के लिए, कृपया
YouTube सहायता केंद्र पर जाएं.
31 मार्च, 2020
इस अपडेट में ये बदलाव शामिल हैं:
-
नए संसाधन और तरीके
-
member
के नए संसाधन से, किसी YouTube चैनल के सदस्य के बारे में पता चलता है. कोई सदस्य, किसी क्रिएटर को बार-बार पैसे देकर उसकी मदद करता है. साथ ही, उसे खास फ़ायदे मिलते हैं. उदाहरण के लिए, सदस्य तब चैट कर सकते हैं, जब क्रिएटर ने चैट के लिए, सिर्फ़ सदस्यों वाला मोड चालू किया हो.यह संसाधन
sponsor
संसाधन की जगह लेगा, जिसे YouTube Live Streaming API के हिस्से के तौर पर दर्ज किया गया है.sponsor
रिसॉर्स को अब बंद कर दिया गया है. एपीआई क्लाइंट को इसके बजाय,members.list
तरीके का इस्तेमाल करने के लिए,sponsors.list
वाले तरीके पर कॉल को अपडेट करना चाहिए. -
नया
membershipsLevel
रिसॉर्स, कीमत के उस लेवल की पहचान करता है जिसे एपीआई अनुरोध की अनुमति देने वाला क्रिएटर मैनेज करता है.membershipsLevels.list
तरीके में, क्रिएटर की सदस्यता के सभी लेवल की सूची हासिल की जाती है.
-
10 जनवरी, 2020
एपीआई की मदद से, अब बच्चों के लिए बनाए गए ऐसे कॉन्टेंट की पहचान की जा सकती है जिसे YouTube "बच्चों के लिए बना" कहता है. YouTube के सहायता केंद्र पर जाकर, "बच्चों के लिए बने" वीडियो के बारे में ज़्यादा जानें.
channel
और video
के संसाधनों में दो नई प्रॉपर्टी के साथ काम किया गया है. इनकी मदद से, कॉन्टेंट क्रिएटर्स और दर्शक बच्चों के लिए बने वीडियो की पहचान कर सकते हैं:
-
selfDeclaredMadeForKids
प्रॉपर्टी की मदद से, कॉन्टेंट क्रिएटर्स यह बता सकते हैं कि चैनल या वीडियो बच्चों के लिए बना है या नहीं.
चैनलों के लिए, इस प्रॉपर्टी कोchannels.update
तरीके को कॉल करते समय सेट किया जा सकता है. वीडियो के लिए, इस प्रॉपर्टी कोvideos.insert
याvideos.update
तरीकों में से किसी एक को कॉल करते समय सेट किया जा सकता है.
ध्यान दें कि इस प्रॉपर्टी को एपीआई से मिले रिस्पॉन्स में सिर्फ़ तब शामिल किया जाता है, जब चैनल के मालिक ने एपीआई के अनुरोध की अनुमति दी हो. ऐसे में, इसमेंchannel
याvideo
रिसॉर्स शामिल होते हैं. -
madeForKids
प्रॉपर्टी की मदद से, कोई भी उपयोगकर्ता किसी चैनल या वीडियो का "बच्चों के लिए बना" स्टेटस हासिल कर सकता है. उदाहरण के लिए,selfDeclaredMadeForKids
प्रॉपर्टी की वैल्यू के आधार पर, स्टेटस तय किया जा सकता है. अपने चैनल, वीडियो या ब्रॉडकास्ट के लिए दर्शक तय करने के बारे में ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं.
हमने YouTube API सेवाओं की सेवा की शर्तों और डेवलपर के लिए नीतियों को भी अपडेट किया है. ज़्यादा जानकारी के लिए, कृपया YouTube API सेवाओं की सेवा की शर्तें - बदलावों का इतिहास देखें. YouTube API सेवाओं की सेवा की शर्तों और डेवलपर के लिए नीतियों में किए गए बदलाव, पैसिफ़िक टाइम के मुताबिक 10 जनवरी, 2020 से लागू होंगे.
10 सितंबर, 2019
एपीआई के रेफ़रंस दस्तावेज़ को अपडेट किया गया है. इसमें YouTube पर सदस्यों की संख्या रिपोर्ट करने के तरीके में बदलाव किया गया है. इसकी वजह से, एपीआई से मिले रिस्पॉन्स में, सदस्यों की संख्या को रिपोर्ट करने का तरीका बदला गया है. इस बदलाव की वजह से, YouTube Data API सेवा से वापस आने वाले सदस्यों की संख्या को घटकर तीन अहम आंकड़ों में बदल दिया गया है. ऐसे सदस्यों की संख्या 1,000 से ज़्यादा होने वाली है. इस बदलाव का असर,
channel
के रिसॉर्स की
statistics.subscriberCount
प्रॉपर्टी पर होता है.
ध्यान दें: यह बदलाव प्रॉपर्टी की इस वैल्यू पर असर डालता है. भले ही, उपयोगकर्ता अपने चैनल के डेटा के लिए अनुमति वाला अनुरोध भेजता हो. चैनल के मालिक, अब भी YouTube Studio में सदस्यों की सटीक संख्या देख सकते हैं.
उदाहरण के लिए, अगर किसी चैनल के 1,23,456 सदस्य हैं, तो
statistics.subscriberCount
प्रॉपर्टी में 123000
वैल्यू शामिल होगी.
नीचे दी गई टेबल में उदाहरण दिए गए हैं कि एपीआई से मिले रिस्पॉन्स में सदस्यों की संख्या को पूर्णांक कैसे बनाया जाता है. साथ ही, सार्वजनिक तौर पर दिखने वाले YouTube के अन्य यूज़र इंटरफ़ेस में इन्हें छोटे रूप में दिखाया जाता है:
सदस्यों की संख्या का उदाहरण | YouTube डेटा एपीआई | सार्वजनिक तौर पर दिखने वाले YouTube यूज़र इंटरफ़ेस (यूआई) |
---|---|---|
1,234 | 1230 | 1.23 हज़ार |
12,345 | 12300 | 12.3 हज़ार |
1,23,456 | 123000 | 1.23 लाख |
12,34,567 | 1230000 | 12.3 लाख |
1,23,45,678 | 12300000 | 1.23 करोड़ |
12,34,56,789 | 123000000 | 12.3 करोड़ |
4 अप्रैल, 2019
इस अपडेट में ये बदलाव शामिल हैं:
-
हर तरीके के सामान्य इस्तेमाल के उदाहरणों को बेहतर तरीके से समझाने और एपीआई एक्सप्लोरर विजेट की मदद से डाइनैमिक और अच्छी क्वालिटी के कोड सैंपल देने के लिए, एपीआई रेफ़रंस दस्तावेज़ को अपडेट किया गया है. उदाहरण के लिए,
channels.list
तरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में बताने वाले पेजों पर अब दो नए एलिमेंट हैं:-
एपीआई एक्सप्लोरर विजेट की मदद से, अनुमति देने के दायरे चुने जा सकते हैं. साथ ही, सैंपल पैरामीटर और प्रॉपर्टी की वैल्यू डाली जा सकती हैं. इसके बाद, एपीआई अनुरोधों को भेजा जा सकता है और एपीआई के असली रिस्पॉन्स देखे जा सकते हैं. विजेट, फ़ुलस्क्रीन व्यू की सुविधा भी देता है जिसमें पूरे कोड के सैंपल दिखाए जाते हैं. ये सैंपल, आपके डाले गए स्कोप और वैल्यू का इस्तेमाल करने के लिए डाइनैमिक तौर पर अपडेट होते हैं.
-
इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताए गए तरीके के इस्तेमाल के एक या एक से ज़्यादा सामान्य उदाहरणों के बारे में बताया गया है. उदाहरण के लिए, किसी खास चैनल का डेटा पाने या मौजूदा उपयोगकर्ता के चैनल का डेटा पाने के लिए,
channels.list
तरीके को कॉल किया जा सकता है.उस सेक्शन में मौजूद लिंक का इस्तेमाल करके, एपीआई एक्सप्लोरर को अपने इस्तेमाल के उदाहरण के लिए सैंपल वैल्यू के साथ भरा जा सकता है. इसके अलावा, फ़ुलस्क्रीन एपीआई एक्सप्लोरर को, पहले से भरी गई वैल्यू के साथ खोलने के लिए भी लिंक का इस्तेमाल किया जा सकता है. इन बदलावों का मकसद है कि आप आसानी से वे कोड सैंपल देख सकें जो उन इस्तेमाल के उदाहरण पर सीधे लागू होते हैं जिन्हें अपने ऐप्लिकेशन में लागू करने की कोशिश की जा रही है.
फ़िलहाल, कोड सैंपल Java, JavaScript, PHP, Python, और curl के लिए इस्तेमाल किए जा सकते हैं.
-
-
कोड सैंपल टूल को भी एक नए यूज़र इंटरफ़ेस (यूआई) के साथ अपडेट किया गया है. इसमें ऊपर बताई गई सभी सुविधाएं मौजूद हैं. इस टूल का इस्तेमाल करके, अलग-अलग तरीकों के लिए इस्तेमाल के उदाहरण एक्सप्लोर किए जा सकते हैं. साथ ही, एपीआई एक्सप्लोरर में वैल्यू लोड की जा सकती हैं. साथ ही, Java, JavaScript, PHP, और Python में कोड के सैंपल पाने के लिए, फ़ुलस्क्रीन एपीआई एक्सप्लोरर खोला जा सकता है.
इस बदलाव के साथ ही, उन पेजों को हटा दिया गया है जिन्होंने पहले Java, JavaScript, PHP, और Python के लिए उपलब्ध कोड सैंपल लिस्ट किए थे.
-
Java, JavaScript, PHP, और Python के लिए क्विकस्टार्ट गाइड अपडेट कर दी गई हैं. बदली गई गाइड में बताया गया है कि एपीआई एक्सप्लोरर के कोड सैंपल का इस्तेमाल करके, एक सैंपल को एपीआई पासकोड के साथ और दूसरा सैंपल OAuth 2.0 क्लाइंट आईडी के साथ कैसे चलाया जाता है.
ध्यान दें कि ऊपर बताए गए बदलाव, उस इंटरैक्टिव टूल की जगह ले लेंगे जिसे 2017 में एपीआई दस्तावेज़ में जोड़ा गया था.
9 जुलाई, 2018
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
के संसाधन कीsnippet.thumbnails
प्रॉपर्टी की परिभाषा को ध्यान में रखते हुए अपडेट किया गया है कि आपके ऐप्लिकेशन में थंबनेल दिखाते समय, आपके कोड में इमेज के यूआरएल ठीक उसी तरह इस्तेमाल किए जाने चाहिए जैसे वे एपीआई के जवाबों में दिखाए जाते हैं. उदाहरण के लिए, आपके ऐप्लिकेशन को एपीआई से रिस्पॉन्स के तौर पर मिले यूआरएल में,https
डोमेन के बजायhttp
डोमेन का इस्तेमाल नहीं करना चाहिए.जुलाई 2018 से, चैनल के थंबनेल के यूआरएल सिर्फ़
https
डोमेन में उपलब्ध होंगे. एपीआई से मिले रिस्पॉन्स में यूआरएल, इसी तरह से दिखते हैं. इसके बाद, अगर आपका ऐप्लिकेशनhttp
डोमेन से YouTube इमेज लोड करने की कोशिश करता है, तो आपको ऐप्लिकेशन में टूटी हुई इमेज दिख सकती हैं. -
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
video
संसाधन कीrecordingDetails.location.altitude
प्रॉपर्टी अब काम नहीं करती. इस बात की कोई गारंटी नहीं है कि वीडियो से इस प्रॉपर्टी को वैल्यू मिलेगी. इसी तरह, भले ही एपीआई अनुरोध उस प्रॉपर्टी के लिए वैल्यू सेट करने की कोशिश करते हों, लेकिन ऐसा हो सकता है कि इनकमिंग डेटा सेव न हो.
22 जून, 2018
लागू करने की गाइड को पहले लागू करने और माइग्रेशन गाइड के नाम से जाना जाता था. अब इसे अपडेट किया गया है. इसमें, v2 API से v3 API पर माइग्रेट करने से जुड़े निर्देश हटाए जा रहे हैं. इसके अलावा, उन सुविधाओं के लिए भी निर्देश हटा दिए गए हैं जिन्हें v3 API में बंद कर दिया गया था. जैसे, पसंदीदा वीडियो.
27 नवंबर, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
YouTube चुनिंदा वीडियो और चुनिंदा वेबसाइट की उन सुविधाओं के लिए सहायता हटा रहा है जो एपीआई में
channel
संसाधन केinvideoPromotion
ऑब्जेक्ट के ज़रिए काम करती हैं. इस वजह से, वह ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी अब काम नहीं करतीं.हालांकि, 14 दिसंबर, 2017 तक
invideoPromotion
का डेटा वापस पाया जा सकता है और उसे सेट किया जा सकता है. YouTube TV की सदस्यता रद्द करने की तारीख के बाद:channels.list
को कॉल करने पर,invideoPromotion
वाला हिस्सा पाने की कोशिश करने पर, खालीinvideoPromotion
मिलेगा याinvideoPromotion
का कोई डेटा नहीं दिखेगा.channels.update
को कॉल करने के दौरानinvideoPromotion
का डेटा अपडेट करने की कोशिश कम से कम 27 मई, 2018 तक सफल जवाब देगी, लेकिन इन्हें 'कोई कार्रवाई नहीं' माना जाएगा. इसका मतलब है कि वे असल में अपडेट नहीं करेंगे.
27 मई, 2018 के बाद, ऐसा हो सकता है कि ये अनुरोध गड़बड़ी के मैसेज दिखाएं. जैसे,
invalidPromotion
अमान्य हिस्सा है.
16 नवंबर, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
इंटरैक्टिव कोड स्निपेट टूल अब Node.js कोड सैंपल के साथ काम करता है. सैंपल, एपीआई के करीब-करीब सभी तरीकों के लिए, दस्तावेज़ में भी दिखते हैं. जैसे,
channels.list
तरीका.पसंद के मुताबिक बनाए जा सकने वाले सैंपल, इस तरह से डिज़ाइन किए गए हैं कि आपको Node.js ऐप्लिकेशन को इस्तेमाल के हिसाब से शुरू करने की जगह मिल सके. यह सुविधा Node.js क्विकस्टार्ट गाइड में मौजूद कोड की तरह ही है. हालांकि, सैंपल में कुछ ऐसे यूटिलिटी फ़ंक्शन होते हैं जो क्विकस्टार्ट में नहीं दिखते:
removeEmptyParameters
फ़ंक्शन, एपीआई अनुरोध पैरामीटर के हिसाब से की-वैल्यू पेयर की सूची लेता है और उन पैरामीटर को हटा देता है जिनमें कोई वैल्यू नहीं होती.createResource
फ़ंक्शन, एपीआई रिसॉर्स में मौजूद प्रॉपर्टी से जुड़े की-वैल्यू पेयर की सूची लेता है. इसके बाद, यह प्रॉपर्टी को JSON ऑब्जेक्ट में बदल देता है, जिसका इस्तेमालinsert
औरupdate
की कार्रवाइयों में किया जा सकता है. नीचे दिए गए उदाहरण में, प्रॉपर्टी के नाम और वैल्यू का एक सेट दिखाया गया है. साथ ही, वह JSON ऑब्जेक्ट भी दिखाया गया है जो कोड उनके लिए बनाएगा:# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
ये सभी सैंपल, डिवाइस पर डाउनलोड करने और चलाने के लिए डिज़ाइन किए गए हैं. ज़्यादा जानकारी के लिए, कोड स्निपेट टूल के निर्देशों में स्थानीय तौर पर पूरे कोड के सैंपल चलाने की ज़रूरी शर्तें देखें.
25 अक्टूबर, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
इंटरैक्टिव कोड स्निपेट टूल में मौजूद Python कोड सैंपल को अपडेट कर दिया गया है, ताकि वे
oauth2client
लाइब्रेरी के बजायgoogle-auth
औरgoogle-auth-oauthlib
लाइब्रेरी का इस्तेमाल कर सकें. हालांकि, अब इसका इस्तेमाल नहीं किया जाता है.उस बदलाव के अलावा, यह टूल अब इंस्टॉल किए गए Python ऐप्लिकेशन और Python वेब सर्वर ऐप्लिकेशन के लिए पूरे कोड सैंपल उपलब्ध कराता है, जो थोड़े अलग ऑथराइज़ेशन फ़्लो का इस्तेमाल करते हैं. पूरे सैंपल (और यह बदलाव) देखने के लिए:
- इंटरैक्टिव कोड स्निपेट टूल या एपीआई के किसी भी तरीके के दस्तावेज़, जैसे कि
channels.list
तरीके पर जाएं. - कोड सैंपल के ऊपर मौजूद
Python
टैब पर क्लिक करें. - स्निपेट देखने से पूरे सैंपल पर स्विच करने के लिए, टैब के ऊपर दिए गए टॉगल पर क्लिक करें.
- अब टैब में एक पूरा कोड सैंपल दिखना चाहिए, जो
InstalledAppFlow
के ऑथराइज़ेशन फ़्लो का इस्तेमाल करता है. नमूने के ऊपर दिया गया विवरण इसकी व्याख्या करता है और वेब सर्वर ऐप्लिकेशन के नमूने को भी लिंक करता है. - वेब सर्वर के उदाहरण पर स्विच करने के लिए, लिंक पर क्लिक करें. वह सैंपल, Flask वेब ऐप्लिकेशन फ़्रेमवर्क और अनुमति देने के अलग फ़्लो का इस्तेमाल करता है.
ये सभी सैंपल, डिवाइस पर डाउनलोड करने और चलाने के लिए डिज़ाइन किए गए हैं. अगर आपको सैंपल चलाने हैं, तो कोड स्निपेट टूल के निर्देशों में स्थानीय तौर पर पूरे कोड के सैंपल चलाने के लिए दिए गए निर्देश देखें.
- इंटरैक्टिव कोड स्निपेट टूल या एपीआई के किसी भी तरीके के दस्तावेज़, जैसे कि
29 अगस्त, 2017
इस अपडेट में ये बदलाव शामिल हैं:
search.list
तरीके केforContentOwner
पैरामीटर की परिभाषा को अपडेट किया गया है. ध्यान दें कि अगर इस पैरामीटर कोtrue
पर सेट किया जाता है, तोtype
पैरामीटर कोvideo
पर सेट होना चाहिए.search.list
तरीके केregionCode
पैरामीटर की परिभाषा को अपडेट किया गया है. ऐसा यह बताने के लिए किया गया है कि पैरामीटर, खोज के नतीजों को सिर्फ़ उन वीडियो तक सीमित करता है जिन्हें इस इलाके में देखा जा सकता है.- YouTube ने अपने ब्रैंडिंग लोगो और आइकॉन में बदलाव किए हैं. "YouTube की मदद से बनाए गए" नए लोगो, ब्रैंडिंग के दिशा-निर्देश पेज से डाउनलोड किए जा सकते हैं. उस पेज पर YouTube के दूसरे नए लोगो और आइकॉन भी दिखाए जाते हैं और इन्हें YouTube ब्रैंड साइट से डाउनलोड किया जा सकता है.
24 जुलाई, 2017
इस अपडेट में ये बदलाव शामिल हैं:
- iOS के लिए, YouTube Data API की नई क्विकस्टार्ट गाइड उपलब्ध है. इस गाइड में बताया गया है कि सामान्य iOS ऐप्लिकेशन में, YouTube Data API इस्तेमाल कैसे किया जा सकता है. यह ऐप्लिकेशन Objective-C या Swift में लिखा गया होता है.
- YouTube Data API के लिए इंटरैक्टिव कोड स्निपेट टूल में अब टूल की कुछ सुविधाओं की जानकारी देने वाले दस्तावेज़ शामिल किए गए हैं:
- एपीआई अनुरोधों को एक्ज़ीक्यूट करना
- कोड स्निपेट और पूरे कोड सैंपल के बीच टॉगल करना
- बॉयलरप्लेट फ़ंक्शन का इस्तेमाल करना
- मौजूदा संसाधन लोड हो रहे हैं (अपडेट करने के तरीकों के लिए)
ध्यान दें: एपीआई के तरीकों के लिए, इस टूल को एपीआई रेफ़रंस दस्तावेज़ में भी एम्बेड किया गया है (उदाहरण).
1 जून, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
ध्यान दें: यह सुविधा बंद करने की घोषणा है.
यहां दी गई
video
रिसॉर्स प्रॉपर्टी अब काम नहीं करतीं. प्रॉपर्टी 1 दिसंबर, 2017 तक काम करेंगी, लेकिन इस बात की कोई गारंटी नहीं है कि उस समय तक वीडियो से ही प्रॉपर्टी की वैल्यू मिलती रहेंगी. इसी तरह,videos.insert
औरvideos.update
के अनुरोध करने पर, उस तारीख से पहले प्रॉपर्टी की वैल्यू सेट करने में कोई गड़बड़ी नहीं होगी. हालांकि, ऐसा हो सकता है कि आने वाला डेटा सेव न हो.
17 मई, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
कोड स्निपेट को ज़्यादा हर तरह के और इंटरैक्टिव बनाने के लिए, एपीआई रेफ़रंस दस्तावेज़ को अपडेट किया गया है.
channels.list
याvideos.rate
जैसे एपीआई तरीकों के बारे में जानकारी देने वाले पेजों में अब एक इंटरैक्टिव टूल की सुविधा है. इसकी मदद से, Java, JavaScript, PHP, Python, Ruby, Apps Script, और Go में कोड स्निपेट को देखा और कस्टमाइज़ किया जा सकता है.किसी दिए गए तरीके में यह टूल एक या उससे ज़्यादा इस्तेमाल के उदाहरणों के लिए कोड स्निपेट दिखाता है. इस्तेमाल के हर उदाहरण में, इस तरीके को कॉल करने का एक सामान्य तरीका बताया गया है. उदाहरण के लिए, किसी खास चैनल या मौजूदा उपयोगकर्ता के चैनल का डेटा पाने के लिए,
channels.list
वाले तरीके को कॉल किया जा सकता है.कोड सैंपल के साथ भी इंटरैक्ट किया जा सकता है:
-
पैरामीटर और प्रॉपर्टी की वैल्यू में बदलाव करें. साथ ही, आपकी दी गई वैल्यू दिखाने के लिए, कोड स्निपेट डाइनैमिक तौर पर अपडेट होते हैं.
-
कोड स्निपेट और पूरे सैंपल के बीच टॉगल करें. कोड स्निपेट, कोड का वह हिस्सा दिखाता है जिसमें एपीआई के तरीके को कॉल किया गया है. एक पूरे सैंपल में उस स्निपेट के साथ-साथ अनुरोध की अनुमति देने और भेजने के लिए बॉयलरप्लेट कोड शामिल होते हैं. पूरे सैंपल को कमांड लाइन या लोकल वेब सर्वर से कॉपी किया जा सकता है और चलाया जा सकता है.
-
बटन पर क्लिक करके अनुरोध लागू करें. (अनुरोधों को पूरा करने के लिए, आपको टूल को यह अनुमति देनी होगी कि वह आपकी ओर से एपीआई को कॉल कर सके.)
ध्यान दें कि इस टूल ने उन पेजों पर एपीआई एक्सप्लोरर को बदल दिया है जहां यह उपलब्ध है. (हर पेज एक लिंक दिखाता है, ताकि आपके पास उस अनुरोध को लोड करने का विकल्प भी हो जिस पर आप API एक्सप्लोरर में काम कर रहे हैं.)
-
-
डेटा एपीआई कोड स्निपेट टूल को भी एक नए यूज़र इंटरफ़ेस (यूआई) के साथ अपडेट किया गया है. इसमें ऊपर बताई गई सभी सुविधाएं मौजूद हैं. इस पेज पर उपलब्ध नई सुविधाएं ये हैं:
- डेटा लिखने वाले एपीआई अनुरोधों के लिए सहायता.
- Java सैंपल के लिए सहायता.
- उपयोगकर्ताओं को अनुमति देने और एपीआई अनुरोध बनाने के लिए, ज़्यादा सुविधाजनक और बेहतर बॉयलरप्लेट कोड.
27 अप्रैल, 2017
इस अपडेट में ये बदलाव शामिल हैं:
- नई क्विकस्टार्ट गाइड, YouTube Data API अनुरोध करने के लिए एक आसान ऐप्लिकेशन सेट अप करने का तरीका बताती हैं. फ़िलहाल, Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python, और Ruby के लिए गाइड उपलब्ध हैं.
30 मार्च, 2017
इस अपडेट में ये बदलाव शामिल हैं:
channel
के संसाधन की नईtopicDetails.topicCategories[]
प्रॉपर्टी में, Wikipedia के यूआरएल की सूची दी गई है. इस सूची में, चैनल के कॉन्टेंट के बारे में बताया गया है. यूआरएल, संसाधन कीtopicDetails.topicIds[]
प्रॉपर्टी में दिखाए गए विषय आईडी से जुड़े होते हैं.playlistItem
के संसाधन की नईcontentDetails.videoPublishedAt
प्रॉपर्टी से, YouTube पर वीडियो के पब्लिश होने के समय का पता चलता है. संसाधन में पहले से हीsnippet.publishedAt
प्रॉपर्टी शामिल है, जो आइटम को प्लेलिस्ट में जोड़े जाने के समय की पहचान करती है.channel
संसाधन की तरह,video
संसाधन अबtopicDetails.topicCategories[]
प्रॉपर्टी दिखाता है. इस प्रॉपर्टी में, Wikipedia के उन यूआरएल की सूची शामिल है जो वीडियो के कॉन्टेंट के बारे में जानकारी देते हैं.video
संसाधनों के लिए, यूआरएल, संसाधन कीtopicDetails.relevantTopicIds[]
प्रॉपर्टी में दिए गए विषय आईडी से मेल खाते हैं.video
के संसाधन की नईcontentDetails.contentRating.mpaatRating
प्रॉपर्टी से, यह पता चलता है कि मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका ने किसी फ़िल्म के ट्रेलर या झलक को कौनसी रेटिंग दी है.
27 फ़रवरी, 2017
जैसा कि मूल रूप से 11 अगस्त, 2016 को एलान किया गया था, YouTube ने विषय आईडी की काम करने वाली सूची को, चुनी गई सूची में बदल दिया है. इस्तेमाल किए जा सकने वाले विषय आईडी की पूरी सूची, channel
और video
के संसाधनों के साथ-साथ search.list
तरीके के topicId
पैरामीटर की topicDetails
प्रॉपर्टी में भी शामिल की जाती है.
ध्यान दें कि चुनी गई सूची में कई बदलाव हैं:
- इन विषयों को
Society
के उप-विषय के तौर पर जोड़ा गया है:नाम विषय आईडी कारोबार /m/09s1f
हेल्थ /m/0kt51
मिलिट्री /m/01h6rj
राजनीति पर /m/05qt0
धर्म /m/06bvp
Animated cartoon
विषय को हटा दिया गया है. यह विषय पहलेEntertainment
का था.Children's music
विषय को हटा दिया गया है. यह विषय पहलेMusic
का था.
इस बदलाव की वजह से, वीडियो से जुड़े विषय अब हमेशा video
संसाधन की topicDetails.relevantTopicIds[]
प्रॉपर्टी की वैल्यू के तौर पर दिखाए जाते हैं.
29 नवंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
विषय आईडी की सूची में 10 फ़रवरी, 2017 से लागू होने वाले तीन छोटे बदलाव हैं:
Professional wrestling
कैटगरी, पहलेSports
कैटगरी की चाइल्ड कैटगरी में शामिल थी. अब यहEntertainment
की चाइल्ड कैटगरी में शामिल है.TV shows
कैटगरी नई है. यहEntertainment
की चाइल्ड कैटगरी है.Health
कैटगरी को हटा दिया गया है. यह कैटगरी पहलेLifestyle
की थी.
यह भी ध्यान दें कि कुछ पैरंट कैटगरी (
Entertainment
,Gaming
,Lifestyle
,Music
, औरSports
) होती हैं. चाइल्ड कैटगरी से जुड़ा कोई भी वीडियो, जैसे किTennis
भी पैरंट कैटगरी (Sports
) से जुड़ा होगा.
10 नवंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
जैसा कि 11 अगस्त, 2016 को पहली बार एलान किया गया था, Freebase और Freebase API को बंद करने के लिए, विषय के आईडी में कई बदलाव किए जाने ज़रूरी हैं. विषय आईडी से,
channel
औरvideo
के संसाधनों से जुड़े विषयों की पहचान की जाती है. साथ ही, किसी खास विषय से जुड़े चैनल या वीडियो ढूंढने के लिए,topicId
खोज पैरामीटर का इस्तेमाल भी किया जा सकता है.10 फ़रवरी, 2017 से YouTube, अब तक मिले आईडी के ज़्यादा विस्तृत सेट के बजाय विषय आईडी का एक छोटा सेट दिखाना शुरू कर देगा. इसके अलावा, इस बात की कोई गारंटी नहीं है कि चैनल और वीडियो को किसी विषय से जोड़ा जाएगा. यह सेटिंग, एपीआई के मौजूदा तरीके के हिसाब से काम करती है.
नीचे दिए गए एपीआई पैरामीटर और प्रॉपर्टी की परिभाषाओं को अपडेट किया गया है, ताकि इन बदलावों के लिए अपने एपीआई क्लाइंट तैयार किए जा सकें. इसके बाद, इस्तेमाल किए जा सकने वाले विषय के आईडी की सूची अपडेट की गई है. ध्यान दें कि सभी प्रॉपर्टी के लिए कैटगरी की सूची एक जैसी होती है.
channel
संसाधन कीtopicDetails.topicIds[]
प्रॉपर्टी.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 Topics की मदद से खोजना गाइड को दस्तावेज़ से हटा दिया गया है. इस गाइड ने यह दिखाने के लिए कोड के नमूने दिए हैं कि कोई ऐप्लिकेशन, Freebase API के साथ कैसे काम करेगा.
साथ ही, विषय के आईडी से जुड़े कई कोड सैंपल,
search.list
तरीके के दस्तावेज़ से हटा दिए गए हैं.
2 नवंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
नई प्रॉपर्टी और पैरामीटर
-
video
संसाधन में कई नई प्रॉपर्टी शामिल हैं:-
player.embedHtml
प्रॉपर्टी में एक<iframe>
टैग होता है. इसका इस्तेमाल करके, वीडियो चलाने वाले प्लेयर को एम्बेड किया जा सकता है. नईplayer.embedHeight
औरplayer.embedWidth
प्रॉपर्टी, एम्बेड किए गए प्लेयर के डाइमेंशन की पहचान करती हैं. ये प्रॉपर्टी सिर्फ़ तब दिखती हैं, जब एपीआई अनुरोध में,maxHeight
याmaxWidth
पैरामीटर में से कम से कम किसी एक पैरामीटर के लिए वैल्यू तय की गई हो. इन दो नए पैरामीटर की व्याख्या इस संशोधन इतिहास प्रविष्टि में बाद में की गई है. -
नई
hasCustomThumbnail
प्रॉपर्टी से पता चलता है कि वीडियो अपलोड करने वाले ने वीडियो के लिए कस्टम थंबनेल इमेज दी है या नहीं. ध्यान दें कि यह प्रॉपर्टी सिर्फ़ वीडियो अपलोड करने वाले को दिखती है. -
नए
fpbRatingReasons[]
से, वीडियो को एफ़पीबी (दक्षिण अफ़्रीका) से मिली रेटिंग की वजहों का पता चलता है. -
नए
mcstRating
से, वीडियो को वियतनाम में मिली रेटिंग की पहचान होती है.
-
-
videos.list
वाला तरीका, दो नए पैरामीटरmaxHeight
औरmaxWidth
के साथ काम करता है.video
रिसॉर्स में,player
वाले हिस्से को वापस लाते समय, किसी एक पैरामीटर या दोनों पैरामीटर का इस्तेमाल किया जा सकता है.डिफ़ॉल्ट रूप से,
player.embedHtml
प्रॉपर्टी में दिखाए गए<iframe>
की ऊंचाई 360 पिक्सल होती है. वीडियो के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) के हिसाब से चौड़ाई अडजस्ट होती है. इससे यह पक्का होता है कि एम्बेड किए गए प्लेयर पर वीडियो फ़्रेम करने के लिए काली पट्टियां नहीं दिख रही हैं. उदाहरण के लिए, अगर किसी वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 है, तो प्लेयर की चौड़ाई 640 पिक्सल होगी.नए पैरामीटर की मदद से, यह तय किया जा सकता है कि एम्बेड कोड को डिफ़ॉल्ट डाइमेंशन के बजाय, आपके ऐप्लिकेशन लेआउट के हिसाब से सही ऊंचाई और/या चौड़ाई का इस्तेमाल करना चाहिए. एपीआई सर्वर, प्लेयर के डाइमेंशन को ज़रूरत के हिसाब से स्केल करता है. इससे यह पक्का किया जाता है कि एम्बेड किए गए प्लेयर में वीडियो के फ़्रेम में काले रंग की पट्टियां न हों. ध्यान दें कि दोनों पैरामीटर एम्बेड किए गए प्लेयर के ज़्यादा से ज़्यादा डाइमेंशन तय करते हैं. इसलिए, अगर दोनों पैरामीटर तय किए गए हैं, तो हो सकता है कि कोई एक डाइमेंशन, उस डाइमेंशन के लिए तय की गई ज़्यादा से ज़्यादा रकम से छोटा हो.
उदाहरण के लिए, मान लें कि किसी वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 है. इसलिए, अगर
maxHeight
याmaxWidth
पैरामीटर सेट नहीं है, तोplayer.embedHtml
टैग में 640x360 प्लेयर होगा.- अगर
maxHeight
पैरामीटर को720
पर सेट किया जाता है औरmaxWidth
पैरामीटर सेट नहीं है, तो एपीआई 1280x720 प्लेयर दिखाएगा. - अगर
maxWidth
पैरामीटर960
पर सेट है औरmaxHeight
पैरामीटर सेट नहीं है, तो एपीआई 960x540 प्लेयर दिखाएगा. - अगर
maxWidth
पैरामीटर960
पर सेट है औरmaxHeight
पैरामीटर450
पर सेट है, तो एपीआई 800x450 प्लेयर दिखाएगा.
नई
player.embedHeight
औरplayer.embedWidth
प्रॉपर्टी, जिनके बारे में ऊपर बताया गया है, प्लेयर के डाइमेंशन की पहचान करती हैं. - अगर
-
-
मौजूदा तरीकों, प्रॉपर्टी, और पैरामीटर में किए गए अपडेट
-
channelSection
संसाधन की जानकारी को अपडेट किया गया है. इससे यह पता चलता है कि कोई चैनल टारगेटिंग डेटा सेट किए बिना, ज़्यादा से ज़्यादा 10 शेल्फ़ बना सकता है. साथ ही, टारगेटिंग डेटा के साथ ज़्यादा से ज़्यादा 100 शेल्फ़ बना सकता है.इसके अलावा,
channelSection
रिसॉर्स कीtargeting
प्रॉपर्टी को अपडेट कर दिया गया है, ताकि यह बताया जा सके कि टारगेटिंग के विकल्प सिर्फ़ एपीआई का इस्तेमाल करके सेट किए जा सकते हैं. अगर चैनल सेक्शन में YouTube की वेबसाइट के यूज़र इंटरफ़ेस का इस्तेमाल करके बदलाव किया गया है, तो टारगेटिंग के विकल्प मिटा दिए जाते हैं. -
i18nLanguage
संसाधन कीsnippet.name
प्रॉपर्टी की परिभाषा को सही कर दिया गया है, ताकि यह दिखाया जा सके कि वैल्यू, भाषा के नाम को उसी तरह दिखाती है जैसाi18nLanguage.list
तरीके केhl
पैरामीटर में बताई गई भाषा में है. -
playlistItem
संसाधन कीcontentDetails.note
प्रॉपर्टी को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि प्रॉपर्टी की वैल्यू में 280 से ज़्यादा वर्ण इस्तेमाल न किए जा सकें. -
playlistItem
संसाधन कीcontentDetails.startAt
औरcontentDetails.endAt
प्रॉपर्टी अब काम नहीं करतीं. अगर इन फ़ील्ड कोplaylistItems.insert
याplaylistItems.update
अनुरोधों में सेट किया गया है, तो उन्हें अनदेखा कर दिया जाता है. -
playlistItems.delete
औरplaylistItems.update
वाले तरीके अबonBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. इस तरीके का इस्तेमाल करने वाले अनुरोधों को भी ऐसे टोकन से अनुमति देनी होगी जोhttps://www.googleapis.com/auth/youtubepartner
स्कोप का ऐक्सेस देता हो. -
search.list
तरीके केpublishedBefore
औरpublishedAfter
पैरामीटर को यह बताने के लिए अपडेट किया गया है कि पैरामीटर की वैल्यू बिना किसी रुकावट के शामिल हैं. इसलिए, उदाहरण के लिए, अगरpublishedBefore
पैरामीटर सेट है, तो एपीआई, बताए गए समय या से पहले बनाए गए संसाधन दिखाता है. -
video
के संसाधन कीcontentDetails.contentRating.grfilmRating
प्रॉपर्टी में तीन अतिरिक्त वैल्यू इस्तेमाल की जा सकती हैं:grfilmK12
,grfilmK15
, औरgrfilmK18
. -
videos.insert
तरीके की जानकारी को अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि अपलोड किए जा रहे वीडियो की फ़ाइल का साइज़ ज़्यादा से ज़्यादा 64 जीबी से बढ़ाकर 128 जीबी कर दिया जाए.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई में नीचे दी गई नई गड़बड़ियां काम करती हैं:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा forbidden (403)
homeParameterDeprecated
activities.list
वाला तरीका यह बताने के लिए गड़बड़ी का मैसेज दिखाता है कि उपयोगकर्ता के होम पेज पर की गई गतिविधि का डेटा, इस एपीआई का इस्तेमाल करके उपलब्ध नहीं है. यह गड़बड़ी तब हो सकती है, जब बिना अनुमति के किए गए किसी अनुरोध मेंhome
पैरामीटर कोtrue
पर सेट किया गया हो.invalidValue (400)
invalidContentDetails
playlistItems.insert
वाला तरीका यह बताने के लिए गड़बड़ी का मैसेज दिखाता है कि अनुरोध में मौजूदcontentDetails
ऑब्जेक्ट अमान्य है. इस गड़बड़ी की एक वजह यह है किcontentDetails.note
फ़ील्ड में 280 से ज़्यादा वर्ण हैं.forbidden (403)
watchHistoryNotAccessible
playlistItems.list
तरीके से यह गड़बड़ी दिखती है कि अनुरोध ने "देखने का इतिहास" प्लेलिस्ट के आइटम वापस पाने की कोशिश की थी, लेकिन एपीआई का इस्तेमाल करके उन्हें वापस नहीं लाया जा सकता.forbidden (403)
watchLaterNotAccessible
playlistItems.list
तरीके से यह गड़बड़ी दिखती है कि अनुरोध ने "बाद में देखें" प्लेलिस्ट के आइटम को वापस पाने की कोशिश की थी, लेकिन एपीआई का इस्तेमाल करके उन्हें वापस नहीं लाया जा सकता.badRequest (400)
uploadLimitExceeded
videos.insert
वाला तरीका इस गड़बड़ी से पता चलता है कि चैनल पर अपलोड किए जा सकने वाले वीडियो की संख्या तय सीमा से ज़्यादा है.forbidden (403)
forbiddenEmbedSetting
videos.update
वाला तरीका यह बताने के लिए गड़बड़ी का मैसेज दिखाता है कि एपीआई अनुरोध, वीडियो के लिए गलत एम्बेड सेटिंग सेट करने की कोशिश करता है. ध्यान दें, हो सकता है कि कुछ चैनलों को लाइव स्ट्रीम के लिए एम्बेड किए गए प्लेयर देने की अनुमति न मिले. ज़्यादा जानकारी के लिए, YouTube के सहायता केंद्र पर जाएं. -
अगर किसी प्लेलिस्ट में डुप्लीकेट वीडियो डाला जाता है, तो
playlistItems.insert
तरीके से गड़बड़ी का मैसेज नहीं मिलता. यह गड़बड़ी पहले कुछ प्लेलिस्ट में हुई थी, जैसे कि पसंदीदा वीडियो, जो डुप्लीकेट वीडियो चलाने की अनुमति नहीं देती थीं, लेकिन अब काम नहीं करतीं. आम तौर पर, प्लेलिस्ट में डुप्लीकेट वीडियो मौजूद होते हैं.
-
-
अन्य अपडेट
-
15 सितंबर, 2016 की बदलाव के इतिहास की एंट्री को अपडेट कर दिया गया है. ऐसा यह बताने के लिए किया गया है कि जब भी जवाब में
channel
संसाधन कीcontentDetails.relatedPlaylists.watchHistory
औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी शामिल की जाती हैं, तो उनमें हमेशाHL
औरWL
वैल्यू शामिल होती हैं. इसके अलावा, उन प्रॉपर्टी को सिर्फ़ तब शामिल किया जाता है, जब कोई उपयोगकर्ता, अपने चैनल का डेटा हासिल कर रहा हो.
-
15 सितंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
11 अगस्त, 2016 में, बदलाव के इतिहास के अपडेट में विषय आईडी से जुड़े कई बदलावों पर चर्चा की गई थी. इसमें यह तथ्य भी शामिल था कि काम करने वाले विषय आईडी के सेट में 10 फ़रवरी, 2017 से बदलाव होने जा रहे हैं. समर्थित विषयों की सूची 10 नवंबर, 2016 तक प्रकाशित कर दी जाएगी.
-
ये बदलाव अब लागू हो गए हैं. इन बदलावों की सूचना 11 अगस्त, 2016 को बदलावों के इतिहास के अपडेट में दी गई थी:
-
अगर
home
पैरामीटर कोtrue
पर सेट करकेactivities.list
तरीके को कॉल किया जाता है, तो एपीआई रिस्पॉन्स में अब वे आइटम शामिल होते हैं जो लॉग आउट कर चुके YouTube उपयोगकर्ता को होम पेज पर दिखते हैं.यह एक मामूली बदलाव है, जिसका मकसद 11 अगस्त, 2016 को बदलावों के इतिहास के अपडेट में बताए गए व्यवहार से बेहतर उपयोगकर्ता अनुभव देना है. इस अपडेट में बताया गया था कि
home
पैरामीटर का इस्तेमाल करने के अनुरोध से खाली सूची दिखेगी. -
channel
संसाधन कीcontentDetails.relatedPlaylists.watchHistory
औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी में अब सभी चैनलों के लिए,HL
औरWL
की वैल्यू मौजूद हैं.साफ़ तौर पर बता दें कि ये प्रॉपर्टी सिर्फ़ उस उपयोगकर्ता को दिखती हैं जिसके पास खुद के चैनल का डेटा पाने की अनुमति है. प्रॉपर्टी में हमेशा
HL
औरWL
वैल्यू शामिल होती हैं. ऐसा तब भी होता है, जब उपयोगकर्ता को अपने चैनल का डेटा पाने की अनुमति होती है. इसलिए, एपीआई का इस्तेमाल करके, वीडियो देखने के इतिहास और 'बाद में देखें' प्लेलिस्ट के आईडी नहीं पाए जा सकते.इसके अलावा, किसी चैनल के 'देखने के इतिहास' या 'बाद में देखें' प्लेलिस्ट के लिए प्लेलिस्ट की जानकारी (
playlists.list
) या प्लेलिस्ट आइटम (playlistItems.list
) पाने के अनुरोध अब खाली सूची में दिखेंगे. यह व्यवहार नई वैल्यू,HL
औरWL
के लिए लागू होता है. इसके अलावा, यह 'देखने का इतिहास' या 'बाद में देखें' की उन प्लेलिस्ट के आईडी पर भी लागू होता है जिन्हें आपके एपीआई क्लाइंट ने पहले से सेव किया होगा.
-
-
video
संसाधन काfileDetails.recordingLocation
ऑब्जेक्ट और उसकी चाइल्ड प्रॉपर्टी अब उपलब्ध नहीं हैं. पहले, इस डेटा (जैसे, पैरंटfileDetails
ऑब्जेक्ट) को सिर्फ़ वीडियो का मालिक ही वापस ला सकता था.
11 अगस्त, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube API सेवाओं की नई प्रकाशित की गई सेवा की शर्तें ("अपडेट की गई शर्तें"), जिनके बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर विस्तार से बताया गया है, में सेवा की मौजूदा शर्तों में कई तरह के अपडेट दिए गए हैं. 10 फ़रवरी, 2017 से लागू होने वाली अपडेट की गई शर्तों के अलावा, इस अपडेट में कई सहायक दस्तावेज़ शामिल हैं. इनसे उन नीतियों की जानकारी देने में मदद मिलती है जिनका डेवलपर को पालन करना ज़रूरी है.
नए दस्तावेज़ों के पूरे सेट के बारे में, अपडेट की गई शर्तों का बदलाव का इतिहास में बताया गया है. इसके अलावा, अपडेट की गई शर्तों या सहायक दस्तावेज़ों में आने वाले समय में होने वाले बदलावों के बारे में, बदलावों के इतिहास में भी बताया जाएगा. उस दस्तावेज़ में मौजूद लिंक से, उस बदलाव के इतिहास में आरएसएस फ़ीड की लिस्टिंग में हुए बदलावों की सदस्यता ली जा सकती है.
-
Freebase और Freebase API के बंद होने की वजह से, विषय के आईडी में कई बदलाव हो रहे हैं. विषय आईडी का इस्तेमाल, एपीआई के इन संसाधनों और तरीकों में किया जाता है:
channel
के संसाधन केtopicDetails
वाले हिस्से की मदद से, चैनल से जुड़े विषयों की पहचान की जाती है.video
के संसाधन केtopicDetails
वाले हिस्से की मदद से, वीडियो से जुड़े विषयों की पहचान की जाती है.search.list
तरीके केtopicId
पैरामीटर की मदद से, किसी खास विषय से जुड़े वीडियो या चैनल खोजे जा सकते हैं.
इन सुविधाओं में ये बदलाव किए गए हैं:
-
10 फ़रवरी, 2017 से YouTube, अब तक मिले आईडी के ज़्यादा विस्तृत सेट के बजाय विषय के आईडी का एक छोटा सेट दिखाना शुरू कर देगा. इस्तेमाल किए जा सकने वाले विषयों के लिए, बड़े लेवल पर कैटगरी तय की जाएंगी, जैसे कि खेल-कूद या बास्केटबॉल. हालांकि, वे चुनिंदा टीमों या खिलाड़ियों की पहचान नहीं कर पाएंगे. हम आपके लिए उपलब्ध विषयों के सेट की घोषणा करेंगे, ताकि आपके पास इस बदलाव के लिए अपने आवेदन की तैयारी करने का समय हो.
-
आपने जिन Freebase विषय आईडी को पहले ही वापस पाया है, उनका इस्तेमाल 10 फ़रवरी, 2017 तक कॉन्टेंट खोजने के लिए किया जा सकता है. हालांकि, इसके बाद विषय के हिसाब से खोज के नतीजे पाने के लिए, पिछले आइटम में बताए गए विषयों के सिर्फ़ छोटे सेट का इस्तेमाल किया जा सकेगा.
-
10 फ़रवरी, 2017 के बाद, अगर किसी ऐसे विषय आईडी का इस्तेमाल करके खोज करने की कोशिश की जाती है जो इस्तेमाल किए जा सकने वाले विषय के आईडी के छोटे सेट में नहीं होता, तो एपीआई कोई खाली नतीजा दिखाएगा.
-
कई API फ़ील्ड और पैरामीटर 12 सितंबर, 2016 से बहिष्कृत किए जा रहे हैं:
-
activities.list
तरीके केhome
पैरामीटर की मदद से, उपयोगकर्ता को गतिविधि फ़ीड वापस पाने की अनुमति मिली. यह फ़ीड उस उपयोगकर्ता के YouTube होम पेज पर दिखेगा. 12 सितंबर, 2016 के बाद, इस पैरामीटर का इस्तेमाल करने वाले अनुरोध के लिए कोई खाली सूची दिखेगी. -
channel
संसाधन कीcontentDetails.relatedPlaylists.watchHistory
औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी सिर्फ़ उस उपयोगकर्ता को दिखती हैं जिसके पास, अपने चैनल का डेटा हासिल करने की अनुमति है. 12 सितंबर, 2016 के बाद,contentDetails.relatedPlaylists.watchHistory
की वैल्यूHL
होगी औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी, सभी चैनलों के लिएWL
वैल्यू दिखाएगी.किसी चैनल के वीडियो देखने के इतिहास या बाद में देखें प्लेलिस्ट के लिए प्लेलिस्ट की जानकारी (
playlists.list
) पाने के अनुरोधों में 12 सितंबर, 2016 के बाद, कोई खाली सूची नहीं दिखेगी. इनमें से किसी भी प्लेलिस्ट में मौजूद प्लेलिस्ट के आइटम (playlistItems.list
) वापस पाने के अनुरोध भी, खाली सूची में दिखेंगे. यह बातHL
औरWL
की नई वैल्यू पर लागू होती है. साथ ही, ऐसे वीडियो देखे जाने का इतिहास या 'बाद में देखें' प्लेलिस्ट आईडी पर भी लागू होती है जिन्हें आपके एपीआई क्लाइंट ने पहले से सेव किया हो. -
video
संसाधन काfileDetails.recordingLocation
ऑब्जेक्ट या उसकी कोई भी चाइल्ड प्रॉपर्टी, 12 सितंबर, 2016 के बाद उपलब्ध नहीं होगी. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है, क्योंकि पैरंटfileDetails
ऑब्जेक्ट को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है.
-
13 जून, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन कीcontentDetails.googlePlusUserId
प्रॉपर्टी अब काम नहीं करती. पहले, प्रॉपर्टी सिर्फ़ तब मौजूद होती थी, जब चैनल किसी Google+ प्रोफ़ाइल से जुड़ा होता था. बंद होने के बाद, प्रॉपर्टी को किसी भीchannel
संसाधन में शामिल नहीं किया जाएगा. -
comment
संसाधन कीsnippet.authorGoogleplusProfileUrl
प्रॉपर्टी अब काम नहीं करती. पहले, प्रॉपर्टी सिर्फ़ तब मौजूद होती थी, जब चैनल किसी Google+ प्रोफ़ाइल से जुड़ा होता था. बंद होने के बाद, प्रॉपर्टी को किसी भीcomment
संसाधन में शामिल नहीं किया जाएगा.
बंद होने के बाद, इनमें से कोई भी प्रॉपर्टी नहीं दिखेगी. इसलिए, दोनों प्रॉपर्टी को संबंधित संसाधन दस्तावेज़ से हटा दिया गया है.
31 मई, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
subscriptions.list
तरीके का नयाmyRecentSubscribers
पैरामीटर, पुष्टि किए गए उपयोगकर्ता के चैनल के सदस्यों की सूची को, तारीख के हिसाब से उस समय के उलटे क्रम में दिखाता है जब उन्होंने चैनल की सदस्यता ली थी.ध्यान दें कि नया पैरामीटर, पुष्टि किए गए उपयोगकर्ता के चैनल से सिर्फ़ हाल ही के 1,000 सदस्यों की जानकारी वापस पाने में मदद करता है. सदस्यों की पूरी सूची पाने के लिए,
mySubscribers
पैरामीटर का इस्तेमाल करें. यह पैरामीटर, जो किसी खास क्रम में सदस्यों की जानकारी नहीं दिखाता है, वापस पाने के लिए सदस्यों की संख्या को सीमित नहीं करता. -
गतिविधि, playlistItem, प्लेलिस्ट, खोज के नतीजे, थंबनेल, और वीडियो संसाधनों के लिए
snippet.thumbnails.(key)
प्रॉपर्टी की परिभाषा अपडेट कर दी गई है. इससे पता चलता है कि कुछ वीडियो के लिए, थंबनेल इमेज के अलग-अलग साइज़ उपलब्ध हैं.standard
इमेज 640 पिक्सल चौड़ी और 480 पिक्सल लंबी है.maxres
इमेज 1280 पिक्सल चौड़ी और 720 पिक्सल लंबी है.
-
channelSection.list
तरीके केpart
पैरामीटर की परिभाषा को अपडेट किया गया है. इससे यह पता चलेगा किtargeting
वाले हिस्से को पाने के लिए,2
कोटा यूनिट का शुल्क देना होगा. -
जब कोई गलत अनुमति वाला अनुरोध,
video
संसाधन केfileDetails
,processingDetails
याsuggestions
हिस्सों को पाने की कोशिश करता है, तोvideos.list
वाला तरीका अब पाबंदी (403
) वाली गड़बड़ी दिखाता है. ये हिस्से सिर्फ़ वीडियो का मालिक देख सकता है.
17 मई, 2016
नया Data API कोड स्निपेट टूल, YouTube Data API इस्तेमाल करने के सामान्य उदाहरणों के लिए छोटे कोड स्निपेट उपलब्ध कराता है. फ़िलहाल, कोड स्निपेट सिर्फ़ Apps Script, Go, JavaScript, PHP, Python, और Ruby में सभी रीड-ओनली एपीआई तरीकों के लिए उपलब्ध हैं.
हर तरीके में यह टूल, एक या उससे ज़्यादा इस्तेमाल के उदाहरणों के लिए कोड सैंपल दिखाता है. उदाहरण के लिए, यह search.list
तरीके के लिए पांच कोड स्निपेट देता है:
- कीवर्ड के हिसाब से वीडियो की सूची बनाएं
- जगह के हिसाब से वीडियो की सूची बनाएं
- लाइव इवेंट की सूची बनाना
- उन उपयोगकर्ता के वीडियो खोजें जिनकी पुष्टि हो चुकी है
- मिलते-जुलते वीडियो की सूची बनाएं
इस्तेमाल के हर उदाहरण के लिए, यह टूल एपीआई अनुरोध में इस्तेमाल किए गए पैरामीटर दिखाता है. पैरामीटर की वैल्यू में बदलाव किया जा सकता है. इस स्थिति में, टूल आपकी दी गई पैरामीटर वैल्यू दिखाने के लिए कोड स्निपेट को अपडेट करता है.
आखिर में, यह टूल हर अनुरोध के लिए एपीआई से मिला रिस्पॉन्स दिखाता है. अगर आपने अनुरोध के पैरामीटर में बदलाव किए हैं, तो एपीआई से मिला रिस्पॉन्स, पैरामीटर की दी गई वैल्यू पर आधारित होता है. ध्यान दें कि आपको एपीआई की जांच के नतीजों को दिखाने के लिए, टूल को अपनी ओर से अनुरोध सबमिट करने की अनुमति देनी होगी.
28 अप्रैल, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
video
के रिसॉर्स की नईcontentDetails.projection
प्रॉपर्टी, वीडियो के प्रोजेक्शन फ़ॉर्मैट के बारे में बताती है. प्रॉपर्टी की मान्य वैल्यू360
औरrectangular
हैं. -
दोनों प्रॉपर्टी के बीच अंतर बताने के लिए,
video
संसाधन कीrecordingDetails.location
औरfileDetails.recordingLocation
प्रॉपर्टी अपडेट की गई हैं:recordingDetails.location
प्रॉपर्टी उस जगह की पहचान करती है जिसे वीडियो का मालिक अपने वीडियो से जोड़ना चाहता है. इस जगह की जानकारी में बदलाव किया जा सकता है और इसे सार्वजनिक वीडियो पर खोजा जा सकता है. साथ ही, सार्वजनिक वीडियो के लिए इसे लोगों को दिखाया जा सकता है.fileDetails.recordingLocation
प्रॉपर्टी की वैल्यू में बदलाव नहीं किया जा सकता. यह मूल वीडियो फ़ाइल से जुड़ी जगह की जानकारी देती है. यह वैल्यू सिर्फ़ वीडियो के मालिक को दिखती है.
-
channel
के संसाधन कीcontentDetails.relatedPlaylists.favorites
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि प्रॉपर्टी की वैल्यू में ऐसा प्लेलिस्ट आईडी मौजूद हो जो किसी खाली प्लेलिस्ट से जुड़ा हो और जिसे फ़ेच नहीं किया जा सके. ऐसा इसलिए है, क्योंकि 'पसंदीदा वीडियो' सुविधा पहले ही बंद कर दी गई है. ध्यान दें कि इस प्रॉपर्टी पर एपीआई को रोकने की नीति लागू नहीं होती. -
ineligibleAccount
गड़बड़ी की परिभाषा, जिसेcomments.insert
,comments.update
,commentThreads.insert
याcommentThreads.update
तरीके से लौटाया जा सकता है, अपडेट कर दी गई है. इससे पता चलता है कि जब एपीआई अनुरोध को मंज़ूरी देने के लिए इस्तेमाल किया गया YouTube खाता, उपयोगकर्ता के Google खाते के साथ मर्ज नहीं किया गया हो.
20 अप्रैल, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
channels.update
तरीके केpart
पैरामीटर की परिभाषा को अपडेट किया गया है. इससे पता चलता है किlocalizations
उस पैरामीटर के लिए भी एक मान्य वैल्यू है. -
शुरुआती निर्देश के कोटा उपयोग सेक्शन को Google Developer के Console से लिंक करने के लिए अपडेट कर दिया गया है, जहां आप अपना वास्तविक कोटा और कोटा उपयोग देख सकते हैं.
16 मार्च, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों के अपडेट
-
channelBanner
संसाधन दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि चैनल के लिए अपलोड की गई बैनर इमेज का सुझाया गया साइज़ 2560 पिक्सल x 1440 पिक्सल है. कम से कम साइज़ (2048 पिक्सल x 1152 पिक्सल) में कोई बदलाव नहीं हुआ है. -
channel
के रिसॉर्स की नईsnippet.customUrl
प्रॉपर्टी, चैनल से जुड़े कस्टम यूआरएल की पहचान करती है. (सभी चैनलों के कस्टम यूआरएल नहीं होते हैं.) YouTube सहायता केंद्र पर कस्टम यूआरएल पाने की ज़रूरी शर्तों के बारे में बताया गया है. साथ ही, यूआरएल सेट अप करने का तरीका भी बताया गया है. -
channel
संसाधन काbrandingSettings.watch
ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी अब काम नहीं करतीं. -
search.list
अनुरोध के एपीआई से मिले रिस्पॉन्स में, अबregionCode
प्रॉपर्टी शामिल है. प्रॉपर्टी, खोज क्वेरी के लिए इस्तेमाल किए गए इलाके के कोड की पहचान करती है. इलाके का कोड, एपीआई को किसी देश के लिए खोज के नतीजे दिखाने का निर्देश देता है.प्रॉपर्टी की वैल्यू, आईएसओ के हिसाब से दो अक्षरों वाला देश कोड है, जिससे इलाके की पहचान होती है.
i18nRegions.list
वाला तरीका, उन इलाकों की सूची दिखाता है जहां यह सुविधा काम करती है. डिफ़ॉल्ट वैल्यूUS
है. अगर किसी ऐसे क्षेत्र के बारे में बताया गया है जहां यह सुविधा काम नहीं करती, तो YouTube क्वेरी को हैंडल करने के लिए, डिफ़ॉल्ट वैल्यू के बजाय किसी दूसरे क्षेत्र को चुन सकता है. -
videoAbuseReportReason
के रिसॉर्स कीsnippet.label
औरsnippet.secondaryReasons[].label
प्रॉपर्टी की परिभाषाओं को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि गलत इस्तेमाल की शिकायत करने के लिए, प्रॉपर्टी में स्थानीय भाषा में लेबल टेक्स्ट शामिल हो.इसके अलावा,
videoAbuseReportReasons.list
वाला तरीका अबhl
पैरामीटर के साथ काम करता है. इससे उस भाषा के बारे में पता चलता है जिसका इस्तेमाल एपीआई के रिस्पॉन्स में लेबल टेक्स्ट के लिए किया जाना चाहिए. पैरामीटर की डिफ़ॉल्ट वैल्यूen_US
है. -
video
के रिसॉर्स की नईcontentDetails.contentRating.ecbmctRating
प्रॉपर्टी से, वीडियो को मिली रेटिंग की पहचान होती है. यह रेटिंग, संस्कृति और पर्यटन मंत्रालय के टर्की के इवैलुएशन ऐंड क्लासिफ़िकेशन बोर्ड से मिली है.इसके अलावा, अन्य रेटिंग सिस्टम के लिए एपीआई प्रॉपर्टी, प्रॉपर्टी की इन नई वैल्यू के साथ काम करती हैं:
contentDetails.contentRating.fpbRating
(दक्षिण अफ़्रीका)
रेटिंग: 10; प्रॉपर्टी की वैल्यू:fpb10
contentDetails.contentRating.moctwRating
(ताइवान)
रेटिंग: R-12; प्रॉपर्टी की वैल्यू:moctwR12
contentDetails.contentRating.moctwRating
(ताइवान)
रेटिंग: R-15; प्रॉपर्टी की वैल्यू:moctwR15
-
video
के संसाधन कीliveStreamingDetails.activeLiveChatId
प्रॉपर्टी में, वीडियो से जुड़ी चालू लाइव चैट का आईडी शामिल होता है. प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब वीडियो मौजूदा लाइव ब्रॉडकास्ट हो और उसमें लाइव चैट की सुविधा चालू हो. ब्रॉडकास्ट खत्म होने और लाइव चैट खत्म होने के बाद, वीडियो को प्रॉपर्टी से वापस नहीं देखा जा सकता. -
video
के संसाधन कीstatus.rejectionReason
प्रॉपर्टी, प्रॉपर्टी की नई वैल्यूlegal
के साथ काम करती है.
-
-
एपीआई में नीचे दी गई नई गड़बड़ियां काम करती हैं:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest (400)
notEditable
channelSections.insert
,channelSections.update
, औरchannelSections.delete
के तरीकों से इस गड़बड़ी का पता चलता है. इससे पता चलता है कि चैनल का खास सेक्शन बनाया, अपडेट या मिटाया नहीं जा सकता.badRequest (400)
styleRequired
channelSections.insert
औरchannelSections.update
के तरीके से यह पता चलता है कि एपीआई अनुरोध में सबमिट किए गएchannelSection
संसाधन के लिए,snippet.style
प्रॉपर्टी के लिए एक वैल्यू तय करना ज़रूरी है.badRequest (400)
typeRequired
channelSections.insert
औरchannelSections.update
के तरीके से यह पता चलता है कि एपीआई अनुरोध में सबमिट किए गएchannelSection
संसाधन के लिए,snippet.type
प्रॉपर्टी के लिए एक वैल्यू तय करना ज़रूरी है.badRequest (400)
processingFailure
commentThreads.list
वाला तरीका यह बताने के लिए गड़बड़ी दिखाता है कि एपीआई सर्वर अनुरोध को प्रोसेस नहीं कर सका. यह कोई अस्थायी गड़बड़ी हो सकती है, लेकिन आम तौर पर इससे पता चलता है कि अनुरोध का इनपुट अमान्य है. अनुरोध के मुख्य हिस्से मेंcommentThread
संसाधन के स्ट्रक्चर की जांच करके पक्का करें कि यह मान्य है.forbidden (403)
commentsDisabled
commentThreads.list
वाले तरीके से यह गड़बड़ी दिखती है किvideoId
पैरामीटर ने जिस वीडियो की पहचान की है उसने टिप्पणियों की सुविधा बंद कर दी है.badRequest (400)
commentTextTooLong
commentThreads.insert
तरीके से यह गड़बड़ी दिखती है. इससे पता चलता है कि शामिल किए जा रहेcomment
संसाधन मेंsnippet.topLevelComment.snippet.textOriginal
प्रॉपर्टी में बहुत ज़्यादा वर्ण हैं.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
playlistItems.insert
वाला तरीका इस गड़बड़ी को दिखाता है. इससे पता चलता है कि जिस वीडियो को प्लेलिस्ट में जोड़ा जा रहा है वह पहले से ही किसी दूसरी सीरीज़ प्लेलिस्ट में मौजूद है. सीरीज़ की प्लेलिस्ट के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.badRequest (400)
subscriptionForbidden
subscriptions.insert
तरीके से यह गड़बड़ी दिखती है कि आपने तय की गई ज़्यादा से ज़्यादा सदस्यताएं ले ली हैं या आपने हाल ही में कई सदस्यताएं बनाई हैं. बाद वाले मामले में, कुछ घंटे बाद फिर से अनुरोध करें.badRequest (400)
invalidCategoryId
videos.update
तरीके से यह गड़बड़ी दिखती है कि अपलोड किए गएvideo
संसाधन मेंsnippet.categoryId
प्रॉपर्टी ने गलत कैटगरी आईडी दिया है. इस्तेमाल की जा सकने वाली कैटगरी को फिर से पाने के लिए,videoCategories.list
तरीके का इस्तेमाल करें.badRequest (400)
invalidDescription
videos.update
तरीके से यह गड़बड़ी दिखती है कि अपलोड किए गएvideo
संसाधन मेंsnippet.description
प्रॉपर्टी में अमान्य वैल्यू दी गई है.badRequest (400)
invalidPublishAt
videos.update
तरीके से यह गड़बड़ी दिखती है कि अपलोड किए गएvideo
संसाधन में मौजूदstatus.publishAt
प्रॉपर्टी में, शेड्यूल किए गए समय पर पब्लिश करने का समय अमान्य है.badRequest (400)
invalidRecordingDetails
videos.update
वाला तरीका यह बताने के लिए गड़बड़ी का मैसेज दिखाता है कि अपलोड किए गएvideo
संसाधन में मौजूदrecordingDetails
ऑब्जेक्ट में, रिकॉर्डिंग से जुड़ी अमान्य जानकारी दी गई है.badRequest (400)
invalidTags
videos.update
तरीके से यह गड़बड़ी दिखती है कि अपलोड किए गएvideo
संसाधन मेंsnippet.tags
प्रॉपर्टी में अमान्य वैल्यू दी गई है.badRequest (400)
invalidTitle
videos.update
तरीके से यह गड़बड़ी दिखती है कि अपलोड किए गएvideo
संसाधन में मौजूदsnippet.title
प्रॉपर्टी में वीडियो के टाइटल के लिए अमान्य या खाली वैल्यू दी गई है.badRequest (400)
invalidVideoMetadata
videos.update
वाला तरीका यह बताने के लिए गड़बड़ी का मैसेज दिखाता है कि अनुरोध का मेटाडेटा अमान्य है. यह गड़बड़ी तब होती है, जब अनुरोध,video
संसाधन केsnippet
वाले हिस्से को अपडेट करता है, लेकिनsnippet.title
औरsnippet.categoryId
, दोनों प्रॉपर्टी के लिए वैल्यू सेट नहीं करता.
18 दिसंबर, 2015
यूरोपीय संघ (ईयू) के कानूनों के तहत, यह ज़रूरी है कि ईयू में रहने वाले असली उपयोगकर्ताओं को कुछ जानकारी ज़ाहिर की जाए और उनकी सहमति ली जाए. इसलिए, यूरोपीय संघ के असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने YouTube API की सेवा की शर्तों में, इस ज़रूरी शर्त के बारे में एक सूचना जोड़ी है.
19 नवंबर, 2015
अब एपीआई के ज़रिए playlist
और video
संसाधनों की snippet.title
और snippet.description
प्रॉपर्टी, channelSection
संसाधन की snippet.title
प्रॉपर्टी, और channel
संसाधन की snippet.description
प्रॉपर्टी के लिए, स्थानीय जगह के अनुसार टेक्स्ट सेट करने और उसे वापस पाने की सुविधा दी जा सकती है.
-
स्थानीय भाषा में टाइटल और ब्यौरे सेट करना
किसी संसाधन के लिए
insert
याupdate
तरीके को कॉल करते समय, उस संसाधन के लिए स्थानीय जगह के अनुसार वैल्यू सेट की जा सकती हैं. किसी संसाधन के लिए स्थानीय जगह के अनुसार वैल्यू सेट करने के लिए, ये दोनों काम करें:-
पक्का करें कि संसाधन की
snippet.defaultLanguage
प्रॉपर्टी के लिए वैल्यू सेट की गई हो. यह प्रॉपर्टी, संसाधन कीsnippet.title
औरsnippet.description
प्रॉपर्टी की भाषा की पहचान करती है. इसका मान कोई भी ऐप्लिकेशन के लिए इस्तेमाल की जाने वाली भाषा या ज़्यादातर ISO 639-1:2002 भाषा कोड हो सकता है. उदाहरण के लिए, अगर आपने कोई ऐसा वीडियो अपलोड किया है जिसका टाइटल और ब्यौरा अंग्रेज़ी में है, तो आपकोsnippet.defaultLanguage
प्रॉपर्टी कोen
पर सेट करना होगा.channel
संसाधनों को अपडेट करने के लिए ज़रूरी जानकारी:channel
संसाधन के लिएsnippet.defaultLanguage
प्रॉपर्टी सेट करने के लिए, आपकोbrandingSettings.channel.defaultLanguage
प्रॉपर्टी को अपडेट करना होगा. -
जिस संसाधन को अपडेट किया जा रहा है उसमें
localizations
ऑब्जेक्ट जोड़ें. हर ऑब्जेक्ट कुंजी एक ऐसी स्ट्रिंग है जो किसी ऐप्लिकेशन भाषा या ISO 639-1:2002 भाषा कोड की पहचान करती है और हर कुंजी उस ऑब्जेक्ट से मैप करती है जिसमें संसाधन के लिए स्थानीय जगह के अनुसार शीर्षक (और ब्यौरा) होता है.नीचे दिया गया सैंपल स्निपेट, संसाधन की डिफ़ॉल्ट भाषा को अंग्रेज़ी पर सेट करता है. इसमें किसी वीडियो में, स्थानीय भाषा में जर्मन और स्पैनिश भाषा के टाइटल और ब्यौरे भी जोड़े गए हैं:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
अहम जानकारी: याद रखें कि जब किसी संसाधन के लिए स्थानीय भाषा में उपलब्ध डेटा को अपडेट किया जाता है, तो आपके एपीआई अनुरोध में, स्थानीय भाषा के हिसाब से उपलब्ध सभी मौजूदा वर्शन शामिल होने चाहिए. उदाहरण के लिए, अगर आपने ऊपर दिए गए उदाहरण में वीडियो में पॉर्चुगीज़ डेटा जोड़ने के लिए बाद में कोई अनुरोध भेजा है, तो अनुरोध में जर्मन, स्पैनिश, और पॉर्चगीज़ के लिए स्थानीय भाषा का डेटा शामिल करना होगा.
-
-
जगह के हिसाब से वैल्यू पाना
किसी संसाधन की स्थानीय भाषा में वैल्यू वापस पाने के लिए, एपीआई दो तरह से काम करता है:
-
अपने
channels.list
,channelSections.list
,playlists.list
याvideos.list
अनुरोध मेंhl
पैरामीटर जोड़ें. इससे YouTube वेबसाइट पर काम करने वाली किसी खास भाषा के लिए, स्थानीय भाषा में डेटा वापस पाया जा सकता है. अगर स्थानीय भाषा में संसाधन की जानकारी उपलब्ध है, तो संसाधन केsnippet.localized
ऑब्जेक्ट में, स्थानीय भाषा के हिसाब से दी गई वैल्यू शामिल होंगी. हालांकि, अगर स्थानीय भाषा के हिसाब से जानकारी उपलब्ध नहीं है, तोsnippet.localized
ऑब्जेक्ट में संसाधन की डिफ़ॉल्ट भाषा में संसाधन की जानकारी होगी.उदाहरण के लिए, मान लें कि
videos.list
अनुरोध ने ऊपर बताए गए वीडियो का डेटा, स्थानीय भाषा के हिसाब से जर्मन और स्पैनिश डेटा के साथ वापस लाया है. अगरhl
पैरामीटर कोde
पर सेट किया जाता है, तो संसाधन में यह डेटा शामिल होगा:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
हालांकि, अगर
hl
पैरामीटर कोfr
पर सेट किया जाता है, तोsnippet.localized
ऑब्जेक्ट में अंग्रेज़ी का टाइटल और ब्यौरा होगा. इसकी वजह यह है कि रिसॉर्स की डिफ़ॉल्ट भाषा अंग्रेज़ी है और स्थानीय भाषा में लिखी गई फ़्रेंच जानकारी उपलब्ध नहीं है.अहम जानकारी:hl
पैरामीटर सिर्फ़ उन वैल्यू के साथ काम करता है जो YouTube वेबसाइट पर काम करने वाली ऐप्लिकेशन भाषाओं की पहचान करती हैं. यह तय करने के लिए कि स्थानीय भाषा में लिखा गया टेक्स्ट दूसरी भाषाओं में उपलब्ध है या नहीं, आपको संसाधन के लिएlocalizations
वाला हिस्सा फिर से हासिल करना होगा. साथ ही, आपको स्थानीय भाषा के हिसाब से टेक्स्ट मौजूद होने का पता लगाने के लिए फ़िल्टर लगाना होगा.
उदाहरण के लिए, आपको स्थानीय भाषा के अनुसार अनुवाद की पूरी सूची देखनी होगी.
-
किसी संसाधन को वापस पाने के दौरान,
part
पैरामीटर वैल्यू मेंlocalizations
शामिल करें. इससे उस संसाधन की, स्थानीय भाषा में लिखी गई सभी जानकारी वापस मिलेगी. अगर आपको किसी ऐसी भाषा के लिए स्थानीय जगह के अनुसार डेटा वापस लाना है जो YouTube ऐप्लिकेशन की मौजूदा भाषा नहीं है, तो आपको इस तरीके का इस्तेमाल करके सभी स्थानीय भाषा के अनुसार डेटा को वापस लाना होगा. इसके बाद, फ़िल्टर लगाकर यह तय करना होगा कि मनचाहा स्थानीय डेटा मौजूद है या नहीं.
-
-
स्थानीय भाषा में लिखी गई टेक्स्ट वैल्यू से जुड़ी गड़बड़ियां
यह एपीआई, स्थानीय भाषा के हिसाब से टेक्स्ट वैल्यू के लिए नीचे दी गई नई गड़बड़ियों के साथ भी काम करता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest (400)
defaultLanguageNotSetError
इस गड़बड़ी से पता चलता है कि किसी संसाधन के लिए localizations
ऑब्जेक्ट को शामिल करने या अपडेट करने की कोशिश करने वाला अनुरोध, पूरे नहीं हो पाता. ऐसा इसलिए है, क्योंकिsnippet.defaultLanguage
प्रॉपर्टी को उस संसाधन के लिए सेट नहीं किया गया है.channels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
, औरvideos.update
तरीके इस गड़बड़ी के साथ काम करते हैं.badRequest (400)
localizationValidationError
इस गड़बड़ी से पता चलता है कि संसाधन के localizations
ऑब्जेक्ट में से किसी एक वैल्यू की पुष्टि नहीं हो सकी. उदाहरण के लिए, यह गड़बड़ी तब हो सकती है, जब ऑब्जेक्ट में अमान्य भाषा कोड हो. इस गड़बड़ी कोchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
, औरplaylists.update
तरीके से इस्तेमाल किया जा सकता है.
4 नवंबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों के अपडेट
-
search.list
तरीके केorder
पैरामीटर को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि लाइव ब्रॉडकास्ट कोviewCount
के हिसाब से क्रम में लगाने पर, एपीआई के नतीजों को, ब्रॉडकास्ट जारी रहने के दौरान, एक साथ चलने वाले दर्शकों की संख्या के हिसाब से क्रम में लगाया जाता है. -
search.list
तरीके केrelatedToVideoId
पैरामीटर को अपडेट कर दिया गया है. इससे यह पता चलता है कि अगर पैरामीटर सेट है, तोpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(जिसेvideo
पर सेट किया जाना चाहिए) औरfields
पैरामीटर इस्तेमाल किए जा सकते हैं. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता. -
video
के संसाधन कीsnippet.publishedAt
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. ऐसा इसलिए है, क्योंकि प्रॉपर्टी की वैल्यू में वीडियो के पब्लिश होने की तारीख और समय अलग-अलग हो सकता है. यह वैल्यू, वीडियो अपलोड होने के समय से अलग हो सकती है. उदाहरण के लिए, अगर किसी वीडियो को निजी वीडियो के तौर पर अपलोड करके बाद में सार्वजनिक किया जाता है, तो प्रॉपर्टी की वैल्यू से वीडियो को सार्वजनिक करने के समय की जानकारी मिलती है. अपडेट की गई परिभाषा से यह भी पता चलता है कि निजी और 'सबके लिए मौजूद नहीं' के तौर पर सेट किए गए वीडियो के लिए, वैल्यू कैसे अपने-आप भरी जाती है.इस बदलाव से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता.
-
video
के संसाधन कीstatus.publishAt
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इससे यह पता चलता है:- अगर
videos.update
तरीके का इस्तेमाल करते समय इस प्रॉपर्टी की वैल्यू सेट की जाती है, तो आपकोstatus.privacyStatus
प्रॉपर्टी की वैल्यू को भीprivate
पर सेट करना होगा. भले ही, वीडियो पहले से निजी हो. - अगर अनुरोध की वजह से, वीडियो को पब्लिश करने के लिए तय किया गया है, तो उसे तुरंत पब्लिश कर दिया जाएगा. इसलिए,
status.publishAt
प्रॉपर्टी को पिछली तारीख और समय पर सेट करने से, वीडियो कीprivacyStatus
कोprivate
सेpublic
में बदलने जैसा ही होता है.
- अगर
-
video
के संसाधन कीcontentDetails.contentRating.cncRating
प्रॉपर्टी से, वीडियो की रेटिंग के बारे में पता चलता है. यह रेटिंग, फ़्रांस के कमीशन डी क्लासिफ़िकेशन सिनमैटोग्राफ़ी टूल से मिलती है. यह प्रॉपर्टी,contentDetails.contentRating.fmocRating
प्रॉपर्टी की जगह ले रही है, जो अब काम नहीं करती. -
channel
के संसाधन की brandingSettings.channel.keywords की परिभाषा को अपडेट कर दिया गया है. इससे सही तरीके से यह पता चलता है कि प्रॉपर्टी की वैल्यू में, स्ट्रिंग के स्पेस से अलग की गई सूची है, न कि कॉमा से अलग की गई सूची, जैसा कि पहले बताया गया है. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता. -
thumbnails.set
तरीके को अपडेट करने के दस्तावेज़ को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि यह बिलकुल सही तरीके से दिखाया जा सके कि अनुरोध में उसी थंबनेल इमेज को शामिल किया गया है जिसे आपने अपलोड किया है और किसी वीडियो से जोड़ा है. अनुरोध के मुख्य हिस्से मेंthumbnail
संसाधन नहीं है. इससे पहले, दस्तावेज़ में कहा गया था कि इस तरीके को कॉल करते समय आपको अनुरोध का मुख्य हिस्सा नहीं देना चाहिए. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं होता. -
activity
संसाधन की जानकारी को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि यह बताया जा सके किactivities.list
वाले तरीके में, फ़िलहाल नए वीडियो की टिप्पणियों से जुड़े संसाधन शामिल नहीं हैं. संसाधन कीsnippet.type
औरcontentDetails.comment
को भी अपडेट किया गया है.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी की जानकारी activities.insert
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह invalidMetadata
ब्यौरा kind
प्रॉपर्टी, दिए गए आईडी के टाइप से मेल नहीं खाती.commentThreads.update
comments.insert
comments.update
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह commentTextTooLong
ब्यौरा जोड़े या अपडेट किए जा रहे comment
संसाधन मेंsnippet.topLevelComment.snippet.textOriginal
प्रॉपर्टी में बहुत ज़्यादा वर्ण हैं.playlistItems.insert
playlistItems.update
एचटीटीपी रिस्पॉन्स कोड forbidden (403)
वजह playlistItemsNotAccessible
ब्यौरा अनुरोध में, बताए गए प्लेलिस्ट आइटम को शामिल करने, अपडेट करने या मिटाने की अनुमति नहीं है. playlists.delete
playlists.insert
playlists.update
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह playlistForbidden
ब्यौरा यह कार्रवाई प्रतिबंधित है या अनुरोध को ठीक से अनुमति नहीं दी गई है. search.list
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह invalidLocation
ब्यौरा location
और/याlocationRadius
पैरामीटर वैल्यू को गलत तरीके से फ़ॉर्मैट किया गया था.search.list
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह invalidRelevanceLanguage
ब्यौरा relevanceLanguage
पैरामीटर की वैल्यू गलत तरीके से फ़ॉर्मैट की गई थी.subscriptions.insert
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह subscriptionForbidden
ब्यौरा यह गड़बड़ी तब होती है, जब इनमें से कोई भी बात सही हो: - आपको जो सदस्यता बनानी है वह पहले से मौजूद है
- आपने पहले ही सदस्यता लेने की तय सीमा पूरी कर ली है
- आप अपने खुद के चैनल की सदस्यता लेने की कोशिश कर रहे हैं, जो समर्थित नहीं है.
- आपने हाल ही में बहुत सारी सदस्यताएं ली हैं. फिर से अनुरोध करने की कोशिश करने से पहले, आपको कुछ घंटे इंतज़ार करना होगा.
videos.update
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह invalidDefaultBroadcastPrivacySetting
ब्यौरा अनुरोध, डिफ़ॉल्ट ब्रॉडकास्ट के लिए अमान्य निजता सेटिंग सेट करने की कोशिश करता है.
-
28 अगस्त, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों के अपडेट
-
video
संसाधन कीstatistics.favoriteCount
प्रॉपर्टी अब काम नहीं करती.इस्तेमाल रोकने की हमारी नीति के मुताबिक, इस एलान के बाद यह प्रॉपर्टी कम से कम एक साल तक
video
के संसाधनों में शामिल रहेगी. हालांकि, प्रॉपर्टी की वैल्यू अब हमेशा0
पर सेट है.
-
7 अगस्त, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों के अपडेट
-
एपीआई सर्वर, प्रॉपर्टी की वैल्यू की लंबाई का हिसाब कैसे लगाता है, इस बारे में ज़्यादा जानकारी देने के लिए,
video
के संसाधन कीsnippet.tags[]
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. ध्यान दें कि इस अपडेट से एपीआई के काम करने के तरीके में कोई बदलाव नहीं आता.खास तौर पर, अब परिभाषा में यह बताया गया है कि अगर किसी टैग में स्पेस है, तो एपीआई सर्वर, टैग वैल्यू को इस तरह हैंडल करता है जैसे वह कोटेशन मार्क में रैप की गई हो. साथ ही, कोटेशन मार्क को वर्ण सीमा में गिना जाता है. इसलिए, वर्ण सीमाओं के मकसद से, टैग Foo-Baz टैग में सात वर्ण हैं, लेकिन Foo Baz टैग में नौ वर्ण हैं.
-
commentThreads.insert
वाला तरीका अबshareOnGooglePlus
पैरामीटर के साथ काम नहीं करता. इससे पहले यह जानकारी मिलती थी कि टिप्पणी और उस टिप्पणी पर दिए गए जवाबों को लेखक की Google+ प्रोफ़ाइल पर भी पोस्ट किया जाना चाहिए या नहीं. अगर कोई अनुरोध पैरामीटर सबमिट करता है, तो एपीआई सर्वर पैरामीटर को अनदेखा कर देता है, लेकिन दूसरे तरीके से अनुरोध को हैंडल करता है.
-
18 जून, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों के अपडेट
-
commentThreads.list
तरीके का नयाorder
पैरामीटर उस क्रम के बारे में बताता है जिसमें एपीआई के रिस्पॉन्स में टिप्पणी की थ्रेड को सूची में शामिल किया जाना चाहिए. थ्रेड को समय या ज़रूरत के हिसाब से क्रम में लगाया जा सकता है. डिफ़ॉल्ट तरीका उन्हें समय के अनुसार क्रम में लगाना है. -
video
के संसाधन की नईsnippet.defaultAudioLanguage
प्रॉपर्टी, वीडियो के डिफ़ॉल्ट ऑडियो ट्रैक में बोली गई भाषा के बारे में बताती है. -
video
के संसाधन कीcontentDetails.licensedContent
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. इसका मकसद साफ़ तौर पर यह बताना है कि यह कॉन्टेंट मूल रूप से YouTube कॉन्टेंट पार्टनर से जुड़े चैनल पर अपलोड हुआ होना चाहिए और इसके बाद उस पार्टनर ने उस पर दावा किया होना चाहिए. इससे, एपीआई के असल काम करने के तरीके में कोई बदलाव नहीं होता. -
captions.delete
,captions.download
,captions.insert
,captions.list
, औरcaptions.update
तरीके अबonBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. इस तरीके का इस्तेमाल करने वाले अनुरोधों को भी ऐसे टोकन से अनुमति देनी होगी जोhttps://www.googleapis.com/auth/youtubepartner
स्कोप का ऐक्सेस देता हो.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी की जानकारी videos.rate
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह emailNotVerified
ब्यौरा वीडियो को रेटिंग देने से पहले, उपयोगकर्ता को अपने ईमेल पते की पुष्टि करनी होगी. videos.rate
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
वजह videoPurchaseRequired
ब्यौरा किराये पर लिए गए वीडियो को सिर्फ़ वे उपयोगकर्ता रेटिंग दे सकते हैं जिन्होंने उन्हें किराये पर लिया है. -
subscriptions.delete
औरsubscriptions.insert
तरीके अबaccountClosed
औरaccountSuspended
गड़बड़ियों के साथ काम नहीं करते हैं.
-
27 अप्रैल, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
नए संसाधन और तरीके
-
नए
videoAbuseReportReason
संसाधन में यह जानकारी है कि किसी वीडियो में आपत्तिजनक कॉन्टेंट होने की वजह से उसे फ़्लैग किया जा सकता है.videoAbuseReportReasons.list
तरीके की मदद से, वीडियो को फ़्लैग किए जाने की सभी वजहों के बारे में जानकारी पाई जा सकती है. -
videos.reportAbuse
के नए तरीके से, आपत्तिजनक कॉन्टेंट वाले वीडियो को फ़्लैग किया जा सकता है. अनुरोध के मुख्य हिस्से में एक JSON ऑब्जेक्ट मौजूद है, जिसमें वीडियो को फ़्लैग किए जाने के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि वीडियो में आपत्तिजनक कॉन्टेंट शामिल होने की वजह क्या है. मान्य वजहों का पता लगाने के लिए, ऊपर बताए गएvideoAbuseReportReason.list
तरीके का इस्तेमाल किया जा सकता है.बुरे बर्ताव वाले वीडियो की शिकायत करने के उदाहरण के साथ, डेटा को दूसरी जगह भेजने से जुड़ी गाइड में भी अपडेट किया गया है. इस बदलाव के बाद, v3 API अब v2 API की वे सभी सुविधाएं इस्तेमाल करने के लिए तैयार है जिनके साथ इसे काम करने के लिए शेड्यूल किया गया है. इन सुविधाओं के बारे में माइग्रेशन गाइड में भी बताया गया है.
-
-
मौजूदा संसाधनों और तरीकों के अपडेट
-
search.list
तरीके के नएforDeveloper
फ़िल्टर पैरामीटर की मदद से, किसी खोज को सिर्फ़ डेवलपर के ऐप्लिकेशन या वेबसाइट से अपलोड किए गए वीडियो वापस लाया जा सकता है.forDeveloper
पैरामीटर को,q
पैरामीटर जैसे खोज के वैकल्पिक पैरामीटर के साथ इस्तेमाल किया जा सकता है.इस सुविधा के लिए, अपलोड किया गया हर वीडियो, Google Developers Console में डेवलपर के ऐप्लिकेशन से जुड़े प्रोजेक्ट नंबर के साथ अपने-आप टैग हो जाता है.
जब खोज अनुरोध बाद में
forDeveloper
पैरामीटर कोtrue
पर सेट कर देता है, तब एपीआई सर्वर डेवलपर की पहचान करने के लिए, अनुरोध की पुष्टि के लिए दिए गए क्रेडेंशियल का इस्तेमाल करता है. इसलिए, डेवलपर नतीजों को डेवलपर के ऐप्लिकेशन या वेबसाइट से अपलोड किए गए वीडियो तक सीमित कर सकता है, लेकिन अन्य ऐप्लिकेशन या साइटों से अपलोड किए गए वीडियो तक नहीं.इस नई सुविधा में अलग-अलग तरह की ऐसी सुविधाएं दी गई हैं जो v2 API के साथ काम करने वाले डेवलपर टैग फ़ंक्शन से मिलती-जुलती हैं. हालांकि, यह उनके जैसी नहीं है.
-
channel
के संसाधन की नईsnippet.country
प्रॉपर्टी की मदद से, चैनल के मालिक अपने चैनलों को किसी देश से जोड़ सकते हैं.ध्यान दें:
channel
संसाधन के लिएsnippet.country
प्रॉपर्टी सेट करने के लिए, आपकोbrandingSettings.channel.country
प्रॉपर्टी को अपडेट करना होगा. -
एपीआई अब
channelSection
संसाधनों को टारगेट करता है. चैनल सेक्शन को टारगेट करने की सुविधा की मदद से, खास शर्तों को पूरा करने वाले उपयोगकर्ताओं को कॉन्टेंट सेक्शन नहीं दिखाया जा सकता है.यह एपीआई, टारगेटिंग के तीन विकल्प दिखाता है. चैनल सेक्शन देखने के लिए, उपयोगकर्ता को टारगेटिंग की सभी सेटिंग पूरी करनी होंगी.
-
targeting.languages[]
: YouTube ऐप्लिकेशन की भाषाओं की सूची. जिन उपयोगकर्ताओं ने इनमें से किसी एक भाषा को चुना है वे इससे जुड़ा चैनल सेक्शन देख सकते हैं. -
targeting.regions[]
: YouTube के पसंदीदा कॉन्टेंट क्षेत्रों की सूची. चैनल सेक्शन, उन लोगों को दिखता है जिन्होंने इन देशों/इलाकों में से किसी एक को चुना है. साथ ही, यह उन लोगों को भी दिखता है जिनके लिए इन देशों/इलाकों को अपने-आप चुना जाता है. -
targeting.countries[]
: उन देशों की सूची जहां चैनल सेक्शन दिखता है. सूची में दी गई हर वैल्यू एक ISO 3166-1 ऐल्फ़ा-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 API की टिप्पणियों की सुविधा का इस्तेमाल करके, ऐप्लिकेशन को कैसे माइग्रेट किया जाता है.
इस गाइड में टिप्पणी करने की ऐसी कई सुविधाओं के बारे में भी बताया गया है जो v2 API के साथ काम नहीं करती हैं, लेकिन v3 API में काम करती हैं. इन देशों या इलाकों में शामिल हैं:
- चैनल के बारे में टिप्पणियां वापस पाना
- किसी चैनल से जुड़ी टिप्पणी की सभी थ्रेड वापस लाई जा रही हैं. इसका मतलब है कि एपीआई से मिले जवाब में, चैनल या उसके किसी भी वीडियो पर की गई टिप्पणियां शामिल हो सकती हैं.
- टिप्पणी का टेक्स्ट अपडेट करना
- किसी टिप्पणी को स्पैम के तौर पर मार्क करना
- किसी टिप्पणी को मॉडरेट करने की स्थिति सेट करना
-
पुश नोटिफ़िकेशन की सदस्यता लेने से जुड़ी गाइड को अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि यह बताया जा सके कि सूचनाएं सिर्फ़ Google PubSubHubBub हब पर भेजी जाती हैं, न कि सुपरफ़ीडर हब पर.
9 अप्रैल, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई के नए
commentThread
औरcomment
संसाधनों की मदद से, टिप्पणियां वापस पाई जा सकती हैं, उन्हें डाला जा सकता है, अपडेट किया जा सकता है, मिटाया जा सकता है, और उन्हें मॉडरेट किया जा सकता है.-
commentThread
के संसाधन में, YouTube पर की गई टिप्पणी की थ्रेड के बारे में जानकारी होती है. इसमें एक टॉप लेवल की टिप्पणी और उस टिप्पणी पर दिए गए जवाब (अगर कोई मौजूद हो) शामिल होते हैं.commentThread
संसाधन की मदद से, किसी वीडियो या चैनल पर की गई टिप्पणियां दिखाई जा सकती हैं.सबसे ऊपर वाली टिप्पणी और उस पर आने वाले जवाब, असल में
comment
रिसॉर्स होते हैं, जोcommentThread
संसाधन में नेस्ट किए गए होते हैं. ध्यान रखें कि यह ज़रूरी नहीं है किcommentThread
संसाधन में किसी टिप्पणी के सभी जवाब शामिल हों. अगर आपको किसी टिप्पणी के सभी जवाब वापस पाने हैं, तो आपकोcomments.list
वाला तरीका अपनाना होगा. इसके अलावा, कुछ टिप्पणियों का जवाब नहीं होता.commentThread
संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:commentThreads.list
– टिप्पणी की थ्रेड की सूची फिर से पाएं. किसी वीडियो या चैनल पर की गई टिप्पणियां वापस पाने के लिए, यह तरीका अपनाएं.commentThreads.insert
– कोई नई टॉप-लेवल टिप्पणी करें. (किसी मौजूदा टिप्पणी का जवाब देने के लिएcomments.insert
तरीके का इस्तेमाल करें.)commentThreads.update
– किसी टॉप लेवल टिप्पणी में बदलाव करें.
-
comment
संसाधन में, YouTube पर की गई एक टिप्पणी के बारे में जानकारी होती है.comment
संसाधन की मदद से, किसी वीडियो या चैनल पर की गई टिप्पणी की जानकारी दी जा सकती है. इसके अलावा, वह टिप्पणी किसी टॉप लेवल की टिप्पणी या किसी टॉप लेवल की टिप्पणी का जवाब हो सकती है.comment
संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:comments.list
– टिप्पणी की सूची वापस पाएं. किसी टिप्पणी के सभी जवाबों को वापस पाने के लिए, इस तरीके का इस्तेमाल करें.comments.insert
– मौजूदा टिप्पणी का जवाब दें.comments.update
– किसी टिप्पणी में बदलाव करें.comments.markAsSpam
– एक या उससे ज़्यादा टिप्पणियों को स्पैम के तौर पर फ़्लैग करें.comments.setModerationStatus
– एक या उससे ज़्यादा टिप्पणियों को मॉडरेट करने की स्थिति सेट करें. उदाहरण के लिए, किसी टिप्पणी को सार्वजनिक तौर पर दिखने के लिए हटाएं या उस टिप्पणी को दिखाने के लिए 'गलत है' के तौर पर अस्वीकार करें. एपीआई अनुरोध के लिए, टिप्पणियों से जुड़े चैनल या वीडियो के मालिक की अनुमति होनी चाहिए.comments.delete
– कोई टिप्पणी मिटाएं.
ध्यान दें कि 2 अप्रैल, 2015 के संशोधन इतिहास में बताए गए एपीआई के नए
https://www.googleapis.com/auth/youtube.force-ssl
दायरे के लिए,comments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
, औरcommentThreads.update
तरीकों को कॉल करना ज़रूरी है. -
-
पुश नोटिफ़िकेशन की सदस्यता लेने से जुड़ी नई गाइड में, PubSubHubBub की मदद से पुश नोटिफ़िकेशन के लिए, एपीआई के नए सपोर्ट के बारे में बताया गया है. यह वेब पर ऐक्सेस किए जा सकने वाले संसाधनों के लिए सर्वर-टू-सर्वर पब्लिश/सदस्यता लेने का प्रोटोकॉल है. जब कोई चैनल नीचे दी गई कोई भी गतिविधि करता है, तो आपके PubSubHubBub कॉलबैक सर्वर को ऐटम फ़ीड सूचनाएं मिल सकती हैं:
- वीडियो अपलोड करता है
- वीडियो का टाइटल अपडेट करता है
- वीडियो का ब्यौरा अपडेट करता है
-
डेटा को दूसरी जगह भेजने से जुड़ी गाइड को भी अपडेट कर दिया गया है. इसमें, पुश नोटिफ़िकेशन की नई सुविधा के बारे में जानकारी दी गई है. हालांकि, v2 API के साथ कई ऐसे दूसरे तरह के पुश नोटिफ़िकेशन भी काम करते हैं जो v3 API के साथ काम नहीं करते. इसलिए, PubSubHubBub सहायता की जानकारी अब भी उस गाइड के अब काम नहीं करती सेक्शन में मौजूद है.
-
एपीआई का नया
https://www.googleapis.com/auth/youtube.force-ssl
स्कोप, एपीआई के ऐसे किसी भी तरीके के लिए अब मान्य स्कोप है जो पहलेhttps://www.googleapis.com/auth/youtube
स्कोप के साथ काम करता था. -
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest (400)
invalidRating
अगर अनुरोध में rating
पैरामीटर के लिए गलत वैल्यू शामिल है, तोvideos.rate
तरीके से यह गड़बड़ी दिखती है. -
subscriptions.insert
वाला तरीका अबsubscriptionLimitExceeded
गड़बड़ी के साथ काम नहीं करता. इससे पहले पता चलता है कि अनुरोध करने वाले सदस्य ने, सदस्यता की तय सीमा पार कर ली है.
2 अप्रैल, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
नए
captions
संसाधन से, YouTube कैप्शन ट्रैक के बारे में पता चलता है. कैप्शन ट्रैक एक YouTube वीडियो से जुड़ा होता है.एपीआई, कैप्शन ट्रैक को सूची में डालने, शामिल करने, अपडेट करने, डाउनलोड करने, और मिटाने के तरीकों के साथ काम करता है.
-
माइग्रेशन गाइड को यह बताने के लिए भी अपडेट किया गया है कि अब भी v2 API में कैप्शन की सुविधा का इस्तेमाल करके, ऐप्लिकेशन को कैसे माइग्रेट किया जाए.
-
एपीआई के नए
https://www.googleapis.com/auth/youtube.force-ssl
दायरे के लिए, एसएसएल कनेक्शन पर एपीआई सर्वर से संपर्क करना ज़रूरी है.यह नया स्कोप, वही ऐक्सेस देता है जो
https://www.googleapis.com/auth/youtube
स्कोप को मिलता है. ये दोनों स्कोप एक जैसे हैं, क्योंकि YouTube API सर्वर सिर्फ़ एचटीटीपीएस एंडपॉइंट पर उपलब्ध है. इस वजह से, भले हीhttps://www.googleapis.com/auth/youtube
स्कोप के लिए एसएसएल कनेक्शन की ज़रूरत न हो, एपीआई अनुरोध करने का कोई और तरीका नहीं है.caption
संसाधन के सभी तरीकों को किए जाने वाले कॉल के लिए, नया स्कोप ज़रूरी है.
11 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API (v3) डेटा को दूसरी जगह भेजने से जुड़ी गाइड में एक नया टैब शामिल है. इसका नाम v3 API में नया है है. इसमें, ऐसी सुविधाओं की जानकारी दी गई है जो v3 API पर काम करती हैं और v2 API के साथ काम नहीं करतीं. जो सुविधाएं पहले ही मौजूद थीं और अब भी हैं, वे गाइड में मौजूद अन्य टैब में अब भी मौजूद हैं. उदाहरण के लिए, किसी चैनल के इन-वीडियो प्रमोशन कैंपेन का डेटा अपडेट करने का तरीका बताने वाली नई सुविधा, चैनल (प्रोफ़ाइल) टैब में भी मौजूद है.
-
YouTube Data API (v3) डेटा को दूसरी जगह भेजने से जुड़ी गाइड को अपडेट कर दिया गया है. इसमें बताया गया है कि v3 API, नीचे दी गई v2 API की सुविधा के साथ काम करेगा:
-
YouTube Data API (v3) डेटा को दूसरी जगह भेजने से जुड़ी गाइड को अपडेट कर दिया गया है. इसमें बताया गया है कि v2 API की ये सुविधाएं, v3 API में काम नहीं करेंगी:
-
वीडियो के सुझाव फिर से पाएं – v3 API ऐसी सूची वापस नहीं लेता जिसमें सिर्फ़ मौजूदा एपीआई उपयोगकर्ता के लिए सुझाए गए वीडियो शामिल होते हैं. हालांकि, सुझाए गए वीडियो ढूंढने के लिए v3 API का इस्तेमाल किया जा सकता है. इसके लिए,
activities.list
वाला तरीका इस्तेमाल करें औरhome
पैरामीटर की वैल्यू कोtrue
पर सेट करें.एपीआई के रिस्पॉन्स में, कोई रिसॉर्स सुझाए गए वीडियो से जुड़ा है. ऐसा तब होता है, जब
snippet.type
प्रॉपर्टी की वैल्यूrecommendation
हो. ऐसे में,contentDetails.recommendation.reason
औरcontentDetails.recommendation.seedResourceId
प्रॉपर्टी में यह जानकारी शामिल होगी कि वीडियो को क्यों सुझाया गया है. ध्यान दें, इस बात की कोई गारंटी नहीं है कि जवाब में सुझाए गए वीडियो की संख्या किसी खास संख्या में शामिल होगी. -
नई सदस्यता वाले वीडियो वापस पाना – v3 API ऐसी सूची नहीं हासिल करता जिसमें सिर्फ़ ऐसे वीडियो हों जो हाल ही में उन चैनलों पर अपलोड किए गए हों जिनकी सदस्यता एपीआई उपयोगकर्ता ने ली है. हालांकि, सदस्यता वाले नए वीडियो ढूंढने के लिए, v3 API का इस्तेमाल किया जा सकता है. इसके लिए,
activities.list
तरीके को कॉल करें औरhome
पैरामीटर की वैल्यू कोtrue
पर सेट करें.एपीआई के रिस्पॉन्स में, अगर
snippet.type
प्रॉपर्टी की वैल्यूupload
है, तो सदस्यता वाले नए वीडियो से जुड़ा संसाधन. ध्यान दें कि इस बात की कोई गारंटी नहीं है कि जवाब में किसी खास संख्या में नए सदस्यता वाले वीडियो शामिल होंगे. -
फ़ीड से जुड़े अपडेट के लिए पुश नोटिफ़िकेशन – YouTube के उपयोगकर्ताओं की उपयोगकर्ता गतिविधि के फ़ीड को मॉनिटर करने के लिए, v2 API के साथ काम करने वाले पुश नोटिफ़िकेशन, सिंपल अपडेट प्रोटोकॉल (एसयूपी) या PubSubHubbub का इस्तेमाल करते हैं. नई चैनल सदस्यताओं के लिए नोटिफ़िकेशन दिए गए थे. साथ ही, वीडियो को रेटिंग दिए जाने, शेयर किए जाने, पसंदीदा के रूप में मार्क किए जाने, उन पर टिप्पणी किए जाने या अपलोड किए जाने के बारे में सूचनाएं दी गई थीं.
v3 API, PubSubHubbub प्रोटोकॉल का इस्तेमाल करके पुश नोटिफ़िकेशन की सुविधा देगा. हालांकि, ये सूचनाएं सिर्फ़ वीडियो अपलोड किए जाने और वीडियो के टाइटल या वीडियो के ब्यौरे के अपडेट को कवर करेंगी.
-
चैनल की जगह की जानकारी – v2 API ने
<yt:location>
टैग का इस्तेमाल करके, उपयोगकर्ता की उस जगह की पहचान की है जो चैनल की YouTube सार्वजनिक प्रोफ़ाइल में दी गई है. कुछ डेवलपर ने इस फ़ील्ड का इस्तेमाल, किसी चैनल को किसी देश से जोड़ने के लिए किया था. हालांकि, इसके लिए फ़ील्ड के डेटा का हर बार इस्तेमाल नहीं किया जा सकता. -
डेवलपर टैग सेट करना या वापस पाना – v2 एपीआई की मदद से, वीडियो को अपलोड करते समय कीवर्ड या डेवलपर टैग को वीडियो से जोड़ा जा सकता था. डेवलपर टैग, YouTube इस्तेमाल करने वालों को नहीं दिखाए जाएंगे. हालांकि, वीडियो के मालिक किसी खास डेवलपर टैग से मेल खाने वाले वीडियो वापस ला सकते हैं.
v3 API से मिलती-जुलती सुविधा मिलेगी. हालांकि, इसमें वही सुविधा नहीं होगी. खास तौर पर, डेवलपर अपने ऐप्लिकेशन से अपलोड किए गए वीडियो खोज पाएगा. इस सुविधा के लिए, अपलोड किया गया हर वीडियो, Google Developers Console में डेवलपर के ऐप्लिकेशन से जुड़े प्रोजेक्ट नंबर के साथ अपने-आप टैग हो जाता है. इसके बाद, डेवलपर उसी प्रोजेक्ट नंबर का इस्तेमाल करके वीडियो खोजता है.
-
पब्लिश करने की तारीख, देखे जाने की संख्या या रेटिंग के हिसाब से वीडियो की सूची बनाना – v2 API में,
orderby
पैरामीटर की मदद से, वीडियो को रैंक, कुल समय, पब्लिकेशन की तारीख, टाइटल, और कई अन्य वैल्यू के हिसाब से प्लेलिस्ट में क्रम से लगाया जा सकता है. v3 एपीआई में, आम तौर पर प्लेलिस्ट में मौजूद आइटम को उनकी रैंक के हिसाब से बढ़ते क्रम में लगाया जाता है. साथ ही, इसमें क्रम से लगाने के दूसरे विकल्प मौजूद नहीं होते.इसके कुछ अपवाद हैं. इस तरह की प्लेलिस्ट के लिए, नया अपलोड किया गया वीडियो, पसंदीदा वीडियो, पसंद किया गया वीडियो या हाल ही में देखा गया वीडियो, पहले आइटम (
snippet.position
=0
) के तौर पर अपने-आप जुड़ जाता है. इसलिए, इनमें से हर सूची को असरदार तरीके से, सबसे नए से सबसे पुराने के क्रम में लगाया जाता है. यह क्रम, सूची में आइटम जोड़े जाने के समय के आधार पर तय किया जाता है.- उपयोगकर्ता के अपलोड
- पसंदीदा वीडियो
- पसंद किए गए वीडियो
- देखने का इतिहास
हालांकि, ध्यान दें कि "बाद में देखें" प्लेलिस्ट में जोड़ा गया एक नया आइटम, उस सूची के आखिरी आइटम के तौर पर जुड़ जाता है. इससे वह सूची असरदार तरीके से, पुराने से नए आइटम के क्रम में लग जाती है.
-
बैच प्रोसेसिंग – v3 API, बैच प्रोसेसिंग के ऐसे किसी एक उदाहरण के साथ काम करता है जो v2 API पर काम करता हो. v3 API के
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
, औरvideos.list
सभी तरीकेid
पैरामीटर के साथ काम करते हैं. इनका इस्तेमाल, आईडी की कॉमा-डीलिमिटेड सूची (वीडियो आईडी, चैनल आईडी वगैरह) के बारे में बताने के लिए किया जा सकता है. उन तरीकों का इस्तेमाल करके, एक ही अनुरोध के साथ कई संसाधनों की सूची को वापस पाया जा सकता है.
इन बदलावों के साथ गाइड अब उन सभी फ़ंक्शन की पहचान करती है जो पुराने (v2) एपीआई में काम करते थे और जो एपीआई के मौजूदा वर्शन (v3) में काम करना बंद कर देंगे.
-
4 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
channelSections.delete
औरchannelSections.update
वाले तरीके अबonBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. -
नीचे दी गई प्रॉपर्टी और उनकी चाइल्ड प्रॉपर्टी अब काम नहीं करतीं:
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
ध्यान दें: इनमें से किसी भी प्रॉपर्टी पर, एपीआई की सुविधा बंद करने की नीति लागू नहीं होती थी.
-
video
के रिसॉर्स की नईcontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
प्रॉपर्टी, उन वजहों की पहचान करती है जिनसे पता चलता है कि वीडियो को DJCQT (ब्राज़ील) की रेटिंग क्यों मिली है. -
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा notFound (404)
channelNotFound
अगर अनुरोध के id
पैरामीटर में कोई ऐसा चैनल चुना गया है जो नहीं मिला, तोchannels.update
वाला तरीका यह गड़बड़ी दिखाता है.badRequest (400)
manualSortRequiredinvalidValue
अगर प्लेलिस्ट में आइटम को क्रम से लगाने के अनुरोध की कोशिश की जाती है, लेकिन प्लेलिस्ट को मैन्युअल तरीके से क्रम में लगाने की कोशिश नहीं की जाती है, तो playlistItems.insert
औरplaylistItems.update
तरीकों से यह गड़बड़ी दिखती है. उदाहरण के लिए, प्लेलिस्ट में मौजूद आइटम को तारीख या लोकप्रियता के हिसाब से क्रम में लगाया जा सकता है. अनुरोध के लेख में भेजे गए संसाधन सेsnippet.position
एलिमेंट को हटाकर, इस गड़बड़ी को ठीक किया जा सकता है. अगर आपको प्लेलिस्ट में मौजूद आइटम को सूची में किसी खास जगह पर रखना है, तो प्लेलिस्ट के क्रम में लगाने की सेटिंग को मैन्युअल पर सेट करें. इस सेटिंग को YouTube वीडियो मैनेजर में जाकर बदला जा सकता है.forbidden (403)
channelClosed
अगर अनुरोध के channelId
पैरामीटर में किसी ऐसे चैनल के बारे में बताया गया है जो बंद हो चुका है, तोplaylists.list
तरीके से यह गड़बड़ी दिखती है.forbidden (403)
channelSuspended
अगर अनुरोध के channelId
पैरामीटर में किसी ऐसे चैनल के बारे में बताया गया है जो निलंबित किया गया है, तोplaylists.list
वाला तरीका यह गड़बड़ी वाला मैसेज दिखाता है.forbidden (403)
playlistForbidden
playlists.list
तरीके से यह गड़बड़ी तब दिखती है, जब अनुरोध काid
पैरामीटर, अनुरोध के साथ काम नहीं करता या अनुरोध को सही तरीके से अनुमति न मिली हो.notFound (404)
channelNotFound
अगर अनुरोध के channelId
पैरामीटर में कोई ऐसा चैनल चुना गया है जो नहीं मिला, तोplaylists.list
वाला तरीका यह गड़बड़ी दिखाता है.notFound (404)
playlistNotFound
अगर अनुरोध के id
पैरामीटर में कोई ऐसी प्लेलिस्ट बताई गई है जो नहीं मिल सकी, तोplaylists.list
वाला तरीका यह गड़बड़ी वाला मैसेज दिखाता है.notFound (404)
videoNotFound
अगर अनुरोध के id
पैरामीटर में कोई ऐसा वीडियो दिखता है जो नहीं मिला, तोvideos.list
वाला तरीका यह गड़बड़ी वाला मैसेज दिखाता है.badRequest (400)
invalidRating
अगर अनुरोध में rating
पैरामीटर के लिए गलत वैल्यू शामिल है, तोvideos.rate
तरीके से यह गड़बड़ी दिखती है.
2 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
वाला तरीका अबrelevanceLanguage
पैरामीटर के साथ काम करता है. इसकी मदद से, किसी भाषा के लिए सबसे ज़्यादा काम के नतीजों के लिए अनुरोध किया जा सकता है.इस नए पैरामीटर के इस्तेमाल का तरीका बताने के लिए, YouTube Data API (v3) को माइग्रेट करने से जुड़ी गाइड को भी अपडेट कर दिया गया है. यह पैरामीटर, एपीआई के मौजूदा वर्शन (v3) और पिछले वर्शन (v2) के बीच वाली सुविधा के गैप को ठीक करता है. हालांकि, इसे पहले ही हटा दिया गया है.
-
खास फ़ीड और मेटाडेटा फ़ील्ड के बंद होने की जानकारी देने के लिए, YouTube Data API (v3) की माइग्रेशन गाइड को भी अपडेट किया गया है. यह एपीआई, फ़िल्मों, ट्रेलर, टेलिविज़न शो, टेलीविज़न सीज़न, और टेलीविज़न एपिसोड के बारे में जानकारी देने के लिए, v2 API उपलब्ध कराता है.
14 जनवरी, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API (v3) डेटा को दूसरी जगह भेजने से जुड़ी गाइड को अपडेट कर दिया गया है. इस गाइड में बताया गया है कि JavaScript का इस्तेमाल करके वीडियो अपलोड करने के लिए, v3 API का इस्तेमाल कैसे करें. (ज़्यादा जानकारी के लिए वीडियो अपलोड करें सेक्शन देखें.) यह सुविधा, ब्राउज़र की मदद से अपलोड करने की सुविधा के साथ काम करती है. यह सुविधा v2 API के साथ काम करती है. ध्यान दें कि माइग्रेशन गाइड में किया गया यह बदलाव, एपीआई में हुआ असल बदलाव नहीं दिखाता. इसके बजाय, क्लाइंट-साइड JavaScript वाले वीडियो अपलोड करने के लिए नए सैंपल कोड की उपलब्धता दिखती है.
JavaScript क्लाइंट लाइब्रेरी और सीओआरएस की मदद से वीडियो अपलोड करने की सुविधा को देखते हुए, माइग्रेशन गाइड में अब ब्राउज़र के आधार पर अपलोड करने की सुविधा को ऐसी सुविधा के तौर पर शामिल नहीं किया गया है जो शायद v3 API में बंद कर दी गई हो.
-
ऊपर बताए गए नए JavaScript कोड के नमूने को शामिल करने के लिए,
videos.insert
तरीके के दस्तावेज़ को अपडेट किया गया है. YouTube Data API (v3) के लिए, JavaScript कोड सैंपल की सूची भी अपडेट कर दी गई है.
11 नवंबर, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
वाले तरीके से किए जाने वाले कॉल के लिए, तय किया गया कोटा, 100 यूनिट में बदल गया है.अहम जानकारी: कई मामलों में, एपीआई के दूसरे तरीकों का इस्तेमाल करके, कम कोटा पर जानकारी हासिल की जा सकती है. उदाहरण के लिए, GoogleDevelopers चैनल पर अपलोड किए गए वीडियो ढूंढने के इन दो तरीकों पर ध्यान दें.
-
कोटा की कीमत: 100 यूनिट
search.list
तरीके को कॉल करें औरGoogleDevelopers
खोजें. -
कोटा की लागत: छह यूनिट
सही चैनल आईडी ढूंढने के लिए,
channels.list
तरीके को कॉल करें.forUsername
पैरामीटर कोGoogleDevelopers
पर औरpart
पैरामीटर कोcontentDetails
पर सेट करें. एपीआई के रिस्पॉन्स में,contentDetails.relatedPlaylists.uploads
प्रॉपर्टी चैनल पर अपलोड किए गए वीडियो के लिए प्लेलिस्ट आईडी के बारे में बताती है.इसके बाद,
playlistItems.list
तरीके को कॉल करें औरplaylistId
पैरामीटर को कैप्चर किए गए आईडी पर औरpart
पैरामीटर कोsnippet
पर सेट करें.
-
8 अक्टूबर, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन में दो नई प्रॉपर्टी शामिल हैं:-
status.longUploadsStatus
प्रॉपर्टी से पता चलता है कि चैनल पर 15 मिनट से ज़्यादा लंबे वीडियो अपलोड किए जा सकते हैं या नहीं. यह प्रॉपर्टी सिर्फ़ तब दिखेगी, जब चैनल के मालिक ने एपीआई के लिए अनुरोध करने की अनुमति दी हो. प्रॉपर्टी की मान्य वैल्यू ये हैं:allowed
– चैनल पर 15 मिनट से ज़्यादा के वीडियो अपलोड किए जा सकते हैं.eligible
– चैनल, 15 मिनट से ज़्यादा अवधि के वीडियो अपलोड कर सकता है, लेकिन पहले यह सुविधा चालू करनी होगी.disallowed
– चैनल, 15 मिनट से ज़्यादा अवधि के वीडियो अपलोड करने या अपलोड करने की ज़रूरी शर्तें पूरी नहीं करता.
इन वैल्यू के बारे में ज़्यादा जानकारी के लिए, प्रॉपर्टी की परिभाषा देखें. YouTube सहायता केंद्र पर, इस सुविधा के बारे में ज़्यादा जानकारी भी मिलती है.
-
invideoPromotion.useSmartTiming
प्रॉपर्टी से पता चलता है कि चैनल का प्रमोशन कैंपेन, "स्मार्ट टाइमिंग" का इस्तेमाल करता है या नहीं. इस सुविधा की मदद से, वीडियो में प्रमोशन को ऐसे समय पर दिखाया जाता है जब उन्हें क्लिक किए जाने की संभावना ज़्यादा होती है और दर्शकों को वीडियो देखने में कोई परेशानी नहीं होती है. इस सुविधा की मदद से, हर वीडियो पर एक ही प्रमोशन दिखाया जाता है.
-
-
एपीआई किस तरीके से
videos.update
तरीके को कॉल मैनेज करता है, यह बताने के लिएvideo
संसाधन कीsnippet.title
औरsnippet.categoryId
प्रॉपर्टी की परिभाषाएं अपडेट की गई हैं. अगरvideo
संसाधन केsnippet
वाले हिस्से को अपडेट करने के लिए उस तरीके को कॉल किया जाता है, तो आपको उन दोनों प्रॉपर्टी के लिए वैल्यू सेट करनी होगी.अगर
video
संसाधन केsnippet
को अपडेट करने की कोशिश की जाती है और दोनों प्रॉपर्टी के लिए वैल्यू सेट नहीं की जाती, तो एपीआईinvalidRequest
गड़बड़ी दिखाता है. उस गड़बड़ी का ब्यौरा भी अपडेट कर दिया गया है. -
video
के संसाधन कीcontentDetails.contentRating.oflcRating
प्रॉपर्टी से, न्यूज़ीलैंड के ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन की मदद से वीडियो की रेटिंग की पहचान की जाती है. यह प्रॉपर्टी अब दो नई रेटिंग के साथ काम करती है:oflcRp13
औरoflcRp16
. ये रेटिंग,RP13
औरRP16
रेटिंग के हिसाब से हैं. -
channelBanners.insert
वाले तरीके में अब यह गड़बड़ी दिखती है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest
bannerAlbumFull
चैनल के मालिक के YouTube चैनल आर्ट एल्बम में बहुत ज़्यादा इमेज हैं. चैनल के मालिक को http://photos.google.com पर जाना होगा. इसके बाद, एल्बम पेज पर जाना होगा और एल्बम की कुछ इमेज को हटाना होगा.
12 सितंबर, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
तरीके से किए जाने वाले कॉल की कोटा कीमत, एक यूनिट से बदलकर दो यूनिट हो गई है. इसके लिए, तय किए गए संसाधनों की कीमत अलग से लागू की गई है.
13 अगस्त, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
subscriptions.insert
वाले तरीके में अब यह गड़बड़ी दिखती है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest
subscriptionLimitExceeded
जिस सदस्य ने अनुरोध किया था उसने सदस्यता लेने के लिए तय की गई सीमा पार कर ली है. कुछ घंटों के बाद, और सदस्यताएं आज़माई जा सकती हैं.
12 अगस्त, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
एक नई गाइड का टाइटल है, YouTube Data API (v3) पर अपना ऐप्लिकेशन माइग्रेट करना. इसमें यह बताया गया है कि YouTube Data API (v2) में उपलब्ध फ़ंक्शन का इस्तेमाल करने के लिए, YouTube Data API (v3) का इस्तेमाल कैसे किया जाए. पुराने एपीआई को 4 मार्च, 2014 को आधिकारिक तौर पर बंद कर दिया गया था. इस गाइड का मकसद, ऐसे ऐप्लिकेशन को माइग्रेट करने में आपकी मदद करना है जो अब भी v2 API का इस्तेमाल करके, एपीआई के सबसे नए वर्शन पर माइग्रेट कर रहे हैं.
8 जुलाई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
playlists.insert
वाले तरीके में अब यह गड़बड़ी दिखती है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest
maxPlaylistExceeded
गड़बड़ी का यह मैसेज तब दिखता है, जब प्लेलिस्ट नहीं बनाई जा सकती. ऐसा तब होता है, जब चैनल में प्लेलिस्ट की तय संख्या पहले से ही मौजूद हो.
18 जून, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
हर एपीआई के तरीके की जानकारी को अपडेट किया गया है, ताकि उस तरीके को किए गए कॉल की कोटा लागत को शामिल किया जा सके. इसी तरह,
part
पैरामीटर की परिभाषाएं अपडेट की गई हैं, ताकि हर उस हिस्से की कोटा लागत तय की जा सके जिसे एपीआई कॉल में वापस लाया जा सकता है. उदाहरण के लिए,subscriptions.insert
तरीके पर किए जाने वाले कॉल की कोटा लागत करीब 50 यूनिट होती है.subscription
संसाधन में तीन हिस्से (snippet
,contentDetails
, औरsubscriberSnippet
) भी होते हैं और हर एक की लागत दो यूनिट होती है.कृपया याद रखें कि कोटा शुल्क बिना किसी चेतावनी के बदल सकता है.
-
video
के संसाधन में अब 43 नए कॉन्टेंट रेटिंग सिस्टम काम करते हैं. सिस्टम, वीडियो को मिलने वाली अलग-अलग राष्ट्रीय रेटिंग एजेंसियों से मिलने वाली रेटिंग की पहचान करते हैं.
28 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
वाला तरीका अबlocation
औरlocationRadius
पैरामीटर के साथ काम करता है. इनकी मदद से, किसी भौगोलिक जगह से जुड़े वीडियो खोजे जा सकते हैं. जगह के हिसाब से नतीजे पाने के लिए, अनुरोध में दोनों पैरामीटर के लिए वैल्यू तय होनी चाहिए. अगर किसी अनुरोध में दोनों में से सिर्फ़ एक पैरामीटर शामिल है, तो एपीआई गड़बड़ी दिखाएगा.-
location
पैरामीटर, सर्कुलर भौगोलिक क्षेत्र के केंद्र में अक्षांश/देशांतर निर्देशांक दिखाता है. -
locationRadius
पैरामीटर से यह तय होता है कि खोज के नतीजों में वीडियो को शामिल करने के लिए, वीडियो से जुड़ी जगह की जगह के बीच वाले हिस्से से ज़्यादा से ज़्यादा कितनी दूरी तय की जा सकती है.
-
13 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
के संसाधन कीinvideoPromotion.items[]
प्रॉपर्टी को अपडेट कर दिया गया है. इससे पता चलता है कि आम तौर पर, अपने चैनल के लिए प्रमोट किया गया सिर्फ़ एक आइटम सेट किया जा सकता है. अगर प्रमोशन वाले कई आइटम डालने की कोशिश की जाती है, तो एपीआईtooManyPromotedItems
गड़बड़ी दिखाएगा. इसमें एक एचटीटीपी400
स्टेटस कोड होगा. -
channelSection
संसाधन में अब कुछ नए तरह के चुनिंदा कॉन्टेंट की जानकारी शामिल हो सकती है.channelSection
के संसाधन कीsnippet.type
प्रॉपर्टी अब इन वैल्यू के साथ काम करती है:postedPlaylists
- वे प्लेलिस्ट जिन्हें चैनल के मालिक ने चैनल के ऐक्टिविटी फ़ीड में पोस्ट किया हैpostedVideos
- ऐसे वीडियो जिन्हें चैनल के मालिक ने चैनल के गतिविधि फ़ीड पर पोस्ट किया हैsubscriptions
- वे चैनल जिनकी सदस्यता चैनल के मालिक ने ली है
-
video
के रिसॉर्स की नईcontentDetails.contentRating.ifcoRating
प्रॉपर्टी, वीडियो को आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस से मिली रेटिंग की पहचान करती है. -
watermark
के संसाधन कीposition.cornerPosition
प्रॉपर्टी की परिभाषा को इस तरह से अपडेट किया गया है कि वॉटरमार्क हमेशा प्लेयर के सबसे ऊपर दाएं कोने में दिखेगा. -
search.list
तरीके के लिएq
पैरामीटर की परिभाषा को ध्यान में रखते हुए अपडेट किया गया है कि क्वेरी शब्द में किसी खास खोज के लिए शब्द से जुड़े वीडियो शामिल न करने के लिए, बूलियन NOT (-
) ऑपरेटर का इस्तेमाल किया जा सकता है. यह वैल्यू, खोज के लिए इस्तेमाल हुए कई शब्दों में से किसी एक से जुड़े वीडियो ढूंढने के लिए, बूलियन OR (|
) ऑपरेटर का इस्तेमाल भी कर सकती है. -
search.list
कॉल के एपीआई से मिले रिस्पॉन्स में,pageInfo.totalResults
प्रॉपर्टी की परिभाषा को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि यह पता लगाया जा सके कि वैल्यू अनुमानित है और हो सकता है कि उससे सटीक वैल्यू न मिले. इसके अलावा, अधिकतम मान 10,00,000 है. आपको पेज पर नंबर डालने वाले लिंक बनाने के लिए, इस वैल्यू का इस्तेमाल नहीं करना चाहिए. इसके बजाय,nextPageToken
औरprevPageToken
प्रॉपर्टी की वैल्यू का इस्तेमाल करके, यह तय करें कि पेज पर नंबर डालने वाले लिंक दिखाने हैं या नहीं. -
watermarks.set
औरwatermarks.unset
वाले तरीकों को अपडेट किया गया है, ताकि यह दिखाया जा सके कि एपीआई उन तरीकों के सफल अनुरोधों के लिए, एक एचटीटीपी204
रिस्पॉन्स कोड दिखाता है.
2 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
नया
i18nLanguage
संसाधन, ऐप्लिकेशन के लिए ऐसी भाषा की पहचान करता है जो YouTube वेबसाइट पर काम करती है. ऐप्लिकेशन भाषा को यूज़र इंटरफ़ेस (यूआई) भाषा के रूप में भी रेफ़र किया जा सकता है. YouTube वेबसाइट के लिए, Google खाते की सेटिंग, ब्राउज़र की भाषा या आईपी लोकेशन के आधार पर ऐप्लिकेशन की भाषा अपने-आप चुनी जा सकती है. साथ ही, उपयोगकर्ता YouTube साइट फ़ुटर से मैन्युअल रूप से भी अपनी पसंद की यूज़र इंटरफ़ेस (यूआई) भाषा चुन सकता है.एपीआई, इस्तेमाल की जा सकने वाली ऐप्लिकेशन भाषाओं को सूची में शामिल करने की सुविधा देता है.
videoCategories.list
औरguideCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय,hl
पैरामीटर की वैल्यू के तौर पर काम करने वाली भाषाओं का इस्तेमाल किया जा सकता है. -
नया
i18nRegion
संसाधन ऐसे भौगोलिक इलाके की पहचान करता है जिसे YouTube उपयोगकर्ता अपनी पसंदीदा कॉन्टेंट क्षेत्र के तौर पर चुन सकता है. कॉन्टेंट वाले क्षेत्र को कॉन्टेंट स्थान-भाषा भी कहा जा सकता है. YouTube वेबसाइट के लिए, कॉन्टेंट का कोई क्षेत्र अपने-आप चुना जा सकता है. ऐसा YouTube डोमेन या उपयोगकर्ता के आईपी पते जैसी सुविधाओं के आधार पर किया जा सकता है. साथ ही, उपयोगकर्ता YouTube साइट के फ़ुटर से, मैन्युअल तरीके से कॉन्टेंट का पसंदीदा क्षेत्र भी चुन सकता है.यह एपीआई, इस्तेमाल किए जा सकने वाले कॉन्टेंट क्षेत्रों को सूची में शामिल करने के लिए काम करता है.
search.list
,videos.list
,activities.list
, औरvideoCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय,regionCode
पैरामीटर की वैल्यू के तौर पर क्षेत्र के कोड का इस्तेमाल किया जा सकता है.
7 अप्रैल, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
channelSection
के नए संसाधन में, वीडियो के उस सेट के बारे में जानकारी शामिल होती है जिसे चैनल ने दिखाने के लिए चुना है. उदाहरण के लिए, किसी सेक्शन में किसी चैनल पर अपलोड किए गए नए वीडियो, सबसे लोकप्रिय वीडियो या एक या एक से ज़्यादा प्लेलिस्ट के वीडियो दिख सकते हैं.एपीआई, चैनल के सेक्शन को सूची में डालने, शामिल करने, अपडेट करने या मिटाने के तरीकों के साथ काम करता है. पुष्टि किए गए उपयोगकर्ता के चैनल के लिए चैनल सेक्शन की सूची फिर से पाई जा सकती है. इसके लिए, किसी खास चैनल आईडी की जानकारी दें या यूनीक चैनल सेक्शन आईडी की सूची तय करें.
गड़बड़ी के दस्तावेज़ को भी अपडेट किया गया है. इसका मकसद, गड़बड़ी के उन मैसेज के बारे में बताना है जो एपीआई खास तौर पर इन नए तरीकों के लिए काम करता है.
-
video
संसाधन केfileDetails
ऑब्जेक्ट की परिभाषा को अपडेट किया गया है. ऐसा यह बताने के लिए किया गया है कि वह ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब वीडियो कीprocessingDetails.fileDetailsAvailability
प्रॉपर्टी की वैल्यूavailable
होगी.इसी तरह,
video
संसाधन केsuggestions
ऑब्जेक्ट की परिभाषा को यह बताने के लिए अपडेट किया गया है कि वह ऑब्जेक्ट सिर्फ़ तब दिखाया जाएगा, जब वीडियो कीprocessingDetails.tagSuggestionsAvailability
प्रॉपर्टी या उसकीprocessingDetails.editorSuggestionsAvailability
प्रॉपर्टी की वैल्यूavailable
हो. -
videos.insert
औरvideos.update
तरीकों के दस्तावेज़ को अपडेट किया गया है. इससे यह पता चलता है किstatus.publishAt
प्रॉपर्टी को उन तरीकों को कॉल करते समय सेट किया जा सकता है. -
channel
संसाधन केinvideoPromotion
ऑब्जेक्ट की परिभाषा को अपडेट किया गया है, ताकि यह बताया जा सके कि ऑब्जेक्ट को सिर्फ़ चैनल का मालिक ही वापस पा सकता है. -
videos.rate
तरीके के लिए पैरामीटर की सूची अपडेट की गई है. इससे पता चलता है कि वह तरीका,onBehalfOfContentOwner
पैरामीटर के साथ काम नहीं करता. यह दस्तावेज़ से जुड़ी एक गड़बड़ी थी, क्योंकिvideos.rate
के अनुरोध करने पर इस पैरामीटर को सेट करने पर500
गड़बड़ी दिखती है.
31 मार्च, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
video
के संसाधन की नईstatus.publishAt
प्रॉपर्टी की मदद से, किसी निजी वीडियो को पब्लिश करने के लिए शेड्यूल किए जाने की तारीख और समय तय किया जा सकता है. इस प्रॉपर्टी को सिर्फ़ तब सेट किया जा सकता है, जब वीडियो की निजता की स्थितिprivate
पर सेट हो और वीडियो को कभी पब्लिश न किया गया हो. इस नई प्रॉपर्टी पर रोक लगाने की नीति लागू नहीं होती.
13 मार्च, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई अब
channel
संसाधनों के लिए,contentOwnerDetails
वाले हिस्से के साथ काम करता है. नए हिस्से में चैनल का ऐसा डेटा मौजूद है जो चैनल से जुड़े YouTube पार्टनर के काम का है. इसमें चैनल से लिंक किए गए कॉन्टेंट के मालिक का आईडी शामिल है. साथ ही, वह तारीख और समय भी शामिल है जब कॉन्टेंट के मालिक और चैनल को लिंक किया गया था. ध्यान दें कि इस नए हिस्से पर, रोक लगाने की नीति लागू नहीं होती है. -
दस्तावेज़ में अब नीचे दी गई प्रॉपर्टी के लिए, वर्णों की तय की गई सीमा की जानकारी दी गई है:
संसाधन प्रॉपर्टी ज़्यादा से ज़्यादा लंबाई channel
invideoPromotion.items[].customMessage
40 वर्ण video
snippet.title
100 वर्ण video
snippet.description
5000 बाइट video
snippet.tags
500 वर्ण. ध्यान दें कि प्रॉपर्टी की वैल्यू एक सूची होती है. इस सूची में मौजूद आइटम के बीच कॉमा लगाकर उसे सीमा में गिना जाता है. -
channel
संसाधन कीbrandingSettings.watch.featuredPlaylistId
प्रॉपर्टी अब काम नहीं करती. एपीआई की वैल्यू सेट करने की कोशिश करने पर, वह गड़बड़ी दिखाएगा. -
नीचे दी गई
video
संसाधन प्रॉपर्टी, वैल्यू की सूची में जोड़ी गई हैं. इन्हें किसी वीडियो को शामिल या अपडेट करते समय सेट किया जा सकता है: -
गड़बड़ी के दस्तावेज़ में अब हर तरह की गड़बड़ी के लिए एचटीटीपी रिस्पॉन्स कोड के बारे में बताया गया है.
-
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest (400)
invalidCriteria
अगर अनुरोध में ऐसे फ़िल्टर पैरामीटर के बारे में बताया गया है जिनका इस्तेमाल एक-दूसरे के साथ नहीं किया जा सकता, तो channels.list
वाला तरीका यह गड़बड़ी वाला मैसेज दिखाता है.badRequest (400)
channelTitleUpdateForbidden
अगर किसी चैनल के brandingSettings
वाले हिस्से को अपडेट करने औरbrandingSettings.channel.title
प्रॉपर्टी की वैल्यू बदलने की कोशिश की जाती है, तोchannels.update
वाला तरीका गड़बड़ी का मैसेज दिखाता है. ध्यान दें कि प्रॉपर्टी को छोड़ने पर, एपीआई गड़बड़ी नहीं दिखाता.badRequest (400)
invalidRecentlyUploadedBy
अगर invideoPromotion.items[].id.recentlyUploadedBy
प्रॉपर्टी किसी अमान्य चैनल आईडी के बारे में बताती है, तोchannels.update
तरीके से यह गड़बड़ी दिखती है.badRequest (400)
invalidTimingOffset
अगर invideoPromotion
वाला हिस्सा अमान्य टाइम ऑफ़सेट के बारे में बताता है, तोchannels.update
तरीका यह गड़बड़ी दिखाता है.badRequest (400)
tooManyPromotedItems
अगर invideoPromotion
वाले हिस्से में, प्रमोशन वाले सामान की संख्या तय सीमा से ज़्यादा है, तोchannels.update
वाला तरीका यह गड़बड़ी दिखाता है.forbidden (403)
promotedVideoNotAllowed
अगर invideoPromotion.items[].id.videoId
प्रॉपर्टी किसी ऐसे वीडियो आईडी के बारे में बताती है जो मौजूद नहीं है या प्रमोशन वाले आइटम के तौर पर इस्तेमाल नहीं किया जा सकता, तोchannels.update
तरीके से यह गड़बड़ी दिखती है.forbidden (403)
websiteLinkNotAllowed
अगर invideoPromotion.items[].id.websiteUrl
प्रॉपर्टी किसी ऐसे यूआरएल के बारे में बताती है जिसकी अनुमति नहीं है, तोchannels.update
वाला तरीका यह गड़बड़ी दिखाता है.required (400)
requiredTimingType
channels.update
तरीके से यह गड़बड़ी तब मिलती है, जब किसी अनुरोध में यह तय न किया गया हो कि YouTube को प्रमोट किया गया आइटम कब दिखाना चाहिए.required (400)
requiredTiming
channels.update
वाले तरीके में, प्रमोट किए गए हर आइटम के लिए,invideoPromotion.items[].timing
ऑब्जेक्ट बताना ज़रूरी है.required (400)
requiredWebsiteUrl
channels.update
वाले तरीके में, प्रमोट किए गए हर आइटम के लिए,invideoPromotion.items[].id.websiteUrl
प्रॉपर्टी तय करनी होगी.badRequest (400)
invalidPublishAt
अगर अनुरोध का मेटाडेटा पब्लिश करने के लिए तय किए गए अमान्य समय के बारे में बताता है, तो videos.insert
तरीका यह गड़बड़ी दिखाता है.
4 मार्च, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API, v3 पर अब सेवा को बंद करने की नीति लागू है. इसके बारे में 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
(जाएं)
24 अक्टूबर, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
इस एपीआई में, लाइव ब्रॉडकास्ट कॉन्टेंट को ढूंढने और उसे दिखाने में मदद करने के लिए डिज़ाइन की गई दो अतिरिक्त सुविधाएं मिलती हैं:
खोज के नतीजों में नई
snippet.liveBroadcastContent
प्रॉपर्टी से पता चलता है कि किसी वीडियो या चैनल के रिसॉर्स में लाइव ब्रॉडकास्ट कॉन्टेंट है या नहीं. प्रॉपर्टी की मान्य वैल्यूupcoming
,active
, औरnone
हैं.-
video
के संसाधन की नईsnippet.liveBroadcastContent
प्रॉपर्टी से पता चलता है कि वीडियो, आने वाला है या चालू लाइव ब्रॉडकास्ट है. नीचे दी गई सूची में, प्रॉपर्टी की संभावित वैल्यू के बारे में बताया गया है:upcoming
– वीडियो एक लाइव ब्रॉडकास्ट है, जो अभी तक शुरू नहीं हुआ है.active
– वीडियो का लाइव ब्रॉडकास्ट चल रहा है.none
– वीडियो, आने वाले समय में या चालू लाइव ब्रॉडकास्ट में से किसी एक को न माना जाए. यह पूरे किए गए उन ब्रॉडकास्ट के लिए प्रॉपर्टी की वैल्यू होगी जिन्हें YouTube पर अब भी देखा जा सकता है.
-
video
के संसाधन की नईliveStreamingDetails
प्रॉपर्टी एक ऑब्जेक्ट है, जिसमें लाइव वीडियो ब्रॉडकास्ट का मेटाडेटा होता है. इस मेटाडेटा को फिर से पाने के लिए,part
पैरामीटर वैल्यू की संसाधन पार्ट की सूची मेंliveStreamingDetails
शामिल करें. मेटाडेटा में ये नई प्रॉपर्टी शामिल हैं:liveStreamingDetails.actualStartTime
– प्रसारण शुरू होने का समय. (ब्रॉडकास्ट की स्थितिactive
होने पर यह वैल्यू मौजूद होगी.)liveStreamingDetails.actualEndTime
– प्रसारण खत्म होने का समय. (ब्रॉडकास्ट खत्म होने के बाद, यह वैल्यू मौजूद होगी.)liveStreamingDetails.scheduledStartTime
– ब्रॉडकास्ट शुरू होने का समय तय किया गया है.liveStreamingDetails.scheduledEndTime
– ब्रॉडकास्ट खत्म होने का समय तय किया गया. अगर प्रॉपर्टी की वैल्यू खाली है या उसमें प्रॉपर्टी मौजूद नहीं है, तो ब्रॉडकास्ट को अनिश्चित समय तक जारी रखने के लिए शेड्यूल किया जाता है.liveStreamingDetails.concurrentViewers
– लाइव ब्रॉडकास्ट देखने वाले लोगों की संख्या.
इस मेटाडेटा को फिर से पाने के लिए,
videos.list
,videos.insert
याvideos.update
तरीके को कॉल करते समय,part
पैरामीटर वैल्यू मेंliveStreamingDetails
शामिल करें.
ध्यान दें कि लाइव ब्रॉडकास्ट कॉन्टेंट की पहचान करने के लिए, 1 अक्टूबर, 2013 को दो अन्य सुविधाएं रिलीज़ की गई थीं –
search.list
तरीके काeventType
पैरामीटर और खोज के नतीजे कीsnippet.liveBroadcastContent
प्रॉपर्टी. -
-
videos.insert
वाला तरीका अबnotifySubscribers
पैरामीटर के साथ काम करता है. इससे यह पता चलता है कि YouTube को वीडियो के चैनल की सदस्यता लेने वाले उपयोगकर्ताओं को नए वीडियो के बारे में सूचना भेजनी चाहिए या नहीं. पैरामीटर की डिफ़ॉल्ट वैल्यूTrue
है. इससे पता चलता है कि सदस्यों को अपलोड किए गए नए वीडियो की सूचना दी जाएगी. हालांकि, ऐसा हो सकता है कि कई वीडियो अपलोड करने वाले चैनल का मालिक, इसकी वैल्यूFalse
पर सेट करे. इससे, चैनल के सदस्यों को हर नए वीडियो की सूचना नहीं भेजी जाएगी. -
channels.update
तरीके को कॉल करते समय जिन प्रॉपर्टी में बदलाव किया जा सकता है उनकी सूची अपडेट कर दी गई है, ताकिinvideoPromotion.items[].customMessage
औरinvideoPromotion.items[].websiteUrl
प्रॉपर्टी को शामिल किया जा सके. साथ ही, सूची में ऐसेbrandingSettings
प्रॉपर्टी की पहचान करने के लिए बदलाव किया गया है जिनमें बदलाव किया जा सकता है. इनbrandingSettings
प्रॉपर्टी में पहले से ही बदलाव किया जा सकता था. इसलिए, दस्तावेज़ में किए गए बदलाव का मतलब है कि एपीआई के मौजूदा फ़ंक्शन में कोई बदलाव नहीं हुआ है. -
playlists.insert
,playlists.update
, औरplaylists.delete
के तरीके अबonBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. -
playlists.insert
वाला तरीका अबonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करता है. यह पैरामीटर पहले से ही कई दूसरे तरीकों के साथ काम करता है. -
video
संसाधन कीcontentDetails.contentRating.tvpgRating
प्रॉपर्टी अबpg14
की वैल्यू के साथ काम करती है, जोTV-14
रेटिंग के बराबर है. -
snippet.liveBroadcastContent
प्रॉपर्टी की परिभाषा, जो खोज के नतीजों का हिस्सा है, उसमें सुधार किया गया है. इससे पता चलता है किlive
एक मान्य प्रॉपर्टी है, लेकिनactive
एक मान्य प्रॉपर्टी वैल्यू नहीं है. -
video
संसाधन कीcontentDetails.contentRating.mibacRating
प्रॉपर्टी अब दो अतिरिक्त रेटिंग के साथ काम करती है:mibacVap
(VAP) – बच्चों के साथ एक वयस्क होना चाहिए.mibacVm6
(V.M.6) – 6 साल और इससे ज़्यादा उम्र के लिए सीमित.mibacVm12
(V.M.12) – 12 साल और उससे ज़्यादा उम्र के लिए सीमित.
-
channel
संसाधन की नईinvideoPromotion.items[].promotedByContentOwner
प्रॉपर्टी से पता चलता है कि प्रमोशन दिखाते समय कॉन्टेंट के मालिक का नाम दिखाया जाएगा या नहीं. इस फ़ील्ड को सिर्फ़ तब सेट किया जा सकता है, जब वैल्यू को सेट करने वाला एपीआई अनुरोध, कॉन्टेंट के मालिक की ओर से किया जा रहा हो. ज़्यादा जानकारी के लिए,onBehalfOfContentOwner
पैरामीटर देखें.
1 अक्टूबर, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
के संसाधन के नएauditDetails
ऑब्जेक्ट में, चैनल का डेटा शामिल होता है. इसका आकलन, कई चैनलों का नेटवर्क (एमसीएन) यह तय करते समय करेगा कि किसी चैनल को स्वीकार करना है या अस्वीकार करना. ध्यान दें कि जो भी एपीआई अनुरोध इस रिसॉर्स के हिस्से को फिर से हासिल करता है उसेhttps://www.googleapis.com/auth/youtubepartner-channel-audit
स्कोप वाला ऑथराइज़ेशन टोकन देना होगा. इसके अलावा, उस दायरे का इस्तेमाल करने वाले किसी भी टोकन को तब रद्द करना होगा, जब एमसीएन चैनल को स्वीकार या अस्वीकार करने का फ़ैसला ले. इसके अलावा, टोकन जारी करने की तारीख से दो हफ़्तों के अंदर, टोकन को भी रद्द करना होगा. -
channel
संसाधन कीinvideoPromotion.items[].id.type
प्रॉपर्टी में अबrecentUpload
की वैल्यू इस्तेमाल की जा सकती है. इससे पता चलता है कि प्रमोट किया गया आइटम, किसी चैनल पर हाल ही में अपलोड किया गया वीडियो है.डिफ़ॉल्ट रूप से, चैनल वही होता है जिसके लिए, वीडियो में प्रमोशन के लिए डेटा सेट किया गया है. हालांकि, किसी दूसरे चैनल के हाल ही में अपलोड किए गए वीडियो का प्रमोशन किया जा सकता है. इसके लिए, उस चैनल की नई
invideoPromotion.items[].id.recentlyUploadedBy
प्रॉपर्टी की वैल्यू को चैनल आईडी पर सेट करें. -
channel
के संसाधन में तीन नई प्रॉपर्टी शामिल हैं –brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
, औरbrandingSettings.image.bannerTvHighImageUrl
. इनसे टेलीविज़न ऐप्लिकेशन में चैनल पेज पर दिखने वाली बैनर इमेज के यूआरएल की जानकारी मिलती है. -
खोज के नतीजों में नई
snippet.liveBroadcastContent
प्रॉपर्टी से पता चलता है कि किसी वीडियो या चैनल के रिसॉर्स में लाइव ब्रॉडकास्ट कॉन्टेंट है या नहीं. प्रॉपर्टी की मान्य वैल्यूupcoming
,active
, औरnone
हैं.video
संसाधन के लिए,upcoming
की वैल्यू से पता चलता है कि वीडियो एक लाइव ब्रॉडकास्ट है जो अभी तक शुरू नहीं हुआ है. वहीं,active
की वैल्यू से पता चलता है कि वीडियो का लाइव ब्रॉडकास्ट चल रहा है.channel
संसाधन के लिए,upcoming
की वैल्यू से पता चलता है कि चैनल पर एक ऐसा ब्रॉडकास्ट शेड्यूल है जो अभी तक शुरू नहीं हुआ है. वहीं,acive
की वैल्यू से पता चलता है कि चैनल पर कोई लाइव ब्रॉडकास्ट चल रहा है.
-
watermark
रिसॉर्स में,targetChannelId
प्रॉपर्टी को किसी ऑब्जेक्ट से स्ट्रिंग में बदल दिया गया है. वॉटरमार्क इमेज से लिंक किए गए चैनल के YouTube चैनल आईडी के बारे में बताने वाली चाइल्ड प्रॉपर्टी के बजाय, अबtargetChannelId
प्रॉपर्टी उस चैनल की वैल्यू के बारे में बताती है. इस वजह से, संसाधन कीtargetChannelId.value
प्रॉपर्टी हटा दी गई है. -
thumbnails.set
वाला तरीका अबonBehalfOfContentOwner
पैरामीटर के साथ काम करता है. यह पैरामीटर पहले से ही कई दूसरे तरीकों के साथ काम करता है. -
search.list
वाला तरीका अबeventType
पैरामीटर के साथ काम करता है. यह किसी खोज को सिर्फ़ चालू, आने वाले या पूरे हो चुके ब्रॉडकास्ट इवेंट दिखाने के लिए सीमित करता है. -
नई
contentDetails.contentRating.mibacRating
प्रॉपर्टी से, वीडियो को मिली रेटिंग की पहचान होती है. यह रेटिंग इटली के ministo dei Beni e delle Attivita Culturei e del Turismo से मिला है. -
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest
invalidImage
अगर इमेज का कॉन्टेंट अमान्य है, तो thumbnails.set
वाला तरीका यह गड़बड़ी दिखाता है.forbidden
videoRatingDisabled
अगर रेट किए जा रहे वीडियो के मालिक ने उस वीडियो की रेटिंग बंद कर दी है, तो videos.rate
तरीके से यह गड़बड़ी दिखती है.
27 अगस्त, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
नया
watermark
संसाधन, किसी खास चैनल के वीडियो चलाने के दौरान दिखने वाली इमेज की पहचान करता है. ऐसे टारगेट चैनल के बारे में भी बताया जा सकता है जिससे इमेज लिंक होगी. साथ ही, उसके दिखने के समय की जानकारी भी दी जा सकती है. इससे यह तय होता है कि वीडियो चलने के दौरान वॉटरमार्क कब दिखेगा और वह कितनी देर तक दिखेगा.watermarks.set
वाला तरीका, चैनल की वॉटरमार्क इमेज अपलोड और सेट करता है.watermarks.unset
का इस्तेमाल करने से, चैनल की वॉटरमार्क इमेज मिट जाती है.गड़बड़ी के दस्तावेज़ में, गड़बड़ी के उन मैसेज के बारे में बताया गया है जो एपीआई के साथ काम करता है और खास तौर पर
watermarks.set
औरwatermarks.unset
तरीकों के लिए काम करता है. -
channel
के संसाधन की नईstatistics.hiddenSubscriberCount
प्रॉपर्टी में एक बूलियन वैल्यू है. इससे पता चलता है कि चैनल के सदस्यों की संख्या छिपी हुई है या नहीं. इसलिए, अगर चैनल के सदस्यों की संख्या सार्वजनिक तौर पर दिखती है, तो प्रॉपर्टी की वैल्यूfalse
होगी. -
playlists.list
वाला तरीका अबonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करता है. दोनों पैरामीटर पहले से ही कई अन्य तरीकों के साथ काम करते हैं. -
videos.list
वाला तरीका अबregionCode
पैरामीटर के साथ काम करता है. इससे यह पता चलता है कि कॉन्टेंट के किस क्षेत्र के लिए चार्ट को वापस लाया जाना चाहिए. इस पैरामीटर का इस्तेमाल सिर्फ़chart
पैरामीटर के साथ जोड़कर किया जा सकता है. पैरामीटर वैल्यू, ISO 3166-1 ऐल्फ़ा-2 देश का कोड है. -
error documentation
में, अनुरोध से जुड़ी इस नई सामान्य गड़बड़ी के बारे में बताया गया है. यह गड़बड़ी, एपीआई के कई तरीकों से हो सकती है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा forbidden
insufficientPermissions
अनुरोध के लिए दिए गए OAuth 2.0 टोकन से जुड़े स्कोप, अनुरोध किए गए डेटा को ऐक्सेस करने के लिए काफ़ी नहीं हैं.
15 अगस्त, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन केinvideoPromotion
ऑब्जेक्ट में, नीचे दी गई नई और अपडेट की गई प्रॉपर्टी हैं:-
एपीआई अब किसी वेबसाइट को, प्रचार किए गए आइटम के तौर पर बताने की सुविधा देता है. ऐसा करने के लिए,
invideoPromotion.items[].id.type
प्रॉपर्टी की वैल्यू कोwebsite
पर सेट करें और यूआरएल बताने के लिए नईinvideoPromotion.items[].id.websiteUrl
प्रॉपर्टी का इस्तेमाल करें. साथ ही, प्रमोशन के लिए अपनी पसंद के मुताबिक मैसेज दिखाने के लिए, नईinvideoPromotion.items[].customMessage
प्रॉपर्टी का इस्तेमाल करें.ये लिंक, सीएसएस से जुड़ी वेबसाइटों, कारोबारियों या कंपनियों की साइटों या सोशल नेटवर्किंग साइटों के हो सकते हैं. अपने कॉन्टेंट के लिंक जोड़ने की सुविधा चालू करने के बारे में ज़्यादा जानकारी के लिए, YouTube के सहायता केंद्र पर लिंक की गई वेबसाइटों और व्यापारी/कंपनी/कारोबारी की साइटों के लिए दिए गए निर्देश देखें.
प्रचार के लिंक जोड़कर, आप सहमति देते हैं कि उन लिंक का इस्तेमाल ट्रैफ़िक को बिना मंज़ूरी वाली साइटों पर रीडायरेक्ट करने के लिए नहीं किया जाएगा. साथ ही, आप इस बात से भी सहमत हैं कि वे लिंक YouTube की AdWords नीतियों, YouTube विज्ञापन नीतियों, YouTube के कम्यूनिटी दिशा-निर्देशों, और YouTube की सेवा की शर्तों के मुताबिक होंगे.
-
वीडियो चलाने के दौरान, प्रमोट किए गए आइटम दिखाने के लिए, टाइमिंग की सेटिंग से जुड़ी प्रॉपर्टी को नए तरीके से बनाया गया है:
-
invideoPromotion.timing
ऑब्जेक्ट कोinvideoPromotion.items[].timing
में ले जाया गया. इस ऑब्जेक्ट की मदद से, अबinvideoPromotion.items[]
सूची में मौजूद, प्रमोशन वाले हर आइटम के लिए, समय से जुड़ा डेटा अपनी पसंद के मुताबिक सेट किया जा सकता है. -
नया
invideoPromotion.defaultTiming
ऑब्जेक्ट, आपके प्रमोशन के लिए समय की डिफ़ॉल्ट सेटिंग तय करता है. ये सेटिंग तय करती हैं कि आपके चैनल के किसी वीडियो को चलाने के दौरान, प्रमोट किया गया कोई आइटम कब दिखेगा.invideoPromotion.items[].timing
ऑब्जेक्ट का इस्तेमाल करके, प्रमोट किए गए किसी भी आइटम के लिए, डिफ़ॉल्ट समय को बदला जा सकता है. -
नई
invideoPromotion.items[].timing.durationMs
प्रॉपर्टी से यह तय होता है कि प्रमोशन कितनी देर तक दिखाया जाएगा. यह मिलीसेकंड में होता है.invideoPromotion.defaultTiming
ऑब्जेक्ट में एकdurationMs
फ़ील्ड भी होता है, जो यह बताता है कि प्रमोट किया गया आइटम डिफ़ॉल्ट तौर पर कितनी देर तक दिखाया जाएगा.
-
-
invideoPromotion.items[].type
औरinvideoPromotion.items[].videoId
प्रॉपर्टी, दोनों कोinvideoPromotion.items[].id
ऑब्जेक्ट में ले जाया गया है.
-
-
subscriptions.list
वाला तरीका अबonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करता है. दोनों पैरामीटर पहले से ही कई अन्य तरीकों के साथ काम करते हैं. -
thumbnails.set
अनुरोध पर एपीआई के रिस्पॉन्स में,kind
प्रॉपर्टी की वैल्यू कोyoutube#thumbnailListResponse
से बदलकरyoutube#thumbnailSetResponse
कर दिया गया है. -
इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)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 से 1,600 का बदलाव किया गया है.
30 जुलाई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channelBanner
संसाधन में,kind
प्रॉपर्टी की वैल्यू कोyoutube#channelBannerInsertResponse
से बदलकरyoutube#channelBannerResource
कर दिया गया है. यह संसाधन,channelBanners.insert
अनुरोध के जवाब में दिखाया गया है. -
channel
के संसाधन की नईbrandingSettings.channel.profileColor
प्रॉपर्टी में, ऐसा रंग बताया गया है जो चैनल के कॉन्टेंट के साथ शानदार तरीके से मेल खाता हो. प्रॉपर्टी का मान एक पाउंड चिह्न (#
) के बाद होता है. इसके बाद, छह वर्णों वाली हेक्साडेसिमल स्ट्रिंग होती है, जैसे कि#2793e6
. -
एपीआई अब यह तय करने की सुविधा देता है कि सदस्यता, चैनल की सभी गतिविधियों के लिए है या सिर्फ़ नए अपलोड के लिए.
subscription
के संसाधन की नईcontentDetails.activityType
प्रॉपर्टी, ऐसी गतिविधियों की पहचान करती है जिनके बारे में सदस्य को सूचना दी जाएगी. प्रॉपर्टी की मान्य वैल्यूall
औरuploads
हैं. -
videos.list
वाला तरीका, YouTube पर सबसे लोकप्रिय वीडियो के चार्ट को फिर से पाने के लिए नए पैरामीटर के साथ काम करता है:chart
पैरामीटर उस चार्ट की पहचान करता है जिसे आपको वापस पाना है. फ़िलहाल,mostPopular
का ही इस्तेमाल किया जा सकता है. ध्यान दें किchart
पैरामीटर एक फ़िल्टर पैरामीटर है. इसका मतलब है कि इसका इस्तेमाल, दूसरे फ़िल्टर पैरामीटर (id
औरmyRating
) के अनुरोध में नहीं किया जा सकता.videoCategoryId
पैरामीटर उस वीडियो कैटगरी की पहचान करता है जिसके लिए चार्ट को हासिल किया जाना चाहिए. इस पैरामीटर का इस्तेमाल सिर्फ़chart
पैरामीटर के साथ जोड़कर किया जा सकता है. डिफ़ॉल्ट रूप से, चार्ट किसी खास कैटगरी तक सीमित नहीं होते.
-
video
के संसाधन की नईtopicDetails.relevantTopicIds[]
प्रॉपर्टी, Freebase के उन विषय आईडी की सूची उपलब्ध कराती है जो वीडियो या उसके कॉन्टेंट के हिसाब से काम के हैं. इन विषयों से जुड़े विषयों का वीडियो में ज़िक्र हो सकता है या वे वीडियो में दिख सकते हैं. -
video
संसाधन कीrecordingDetails.location.elevation
प्रॉपर्टी का नाम बदलकरrecordingDetails.location.altitude
कर दिया गया है. साथ ही, इसकीfileDetails.recordingLocation.location.elevation
प्रॉपर्टी का नाम बदलकरfileDetails.recordingLocation.location.altitude
कर दिया गया है. -
video
के संसाधन काcontentDetails.contentRating
ऑब्जेक्ट, उन रेटिंग के बारे में बताता है जो किसी वीडियो को अलग-अलग रेटिंग स्कीम के तहत मिली हैं. इनमें MPAA रेटिंग, TVPG रेटिंग वगैरह शामिल हैं. हर रेटिंग सिस्टम के लिए, एपीआई अब रेटिंग की एक वैल्यू के साथ काम करता है. इससे पता चलता है कि वीडियो को रेट नहीं किया गया है. ध्यान दें कि MPAA रेटिंग के लिए, "अनरेटेड" रेटिंग का इस्तेमाल अक्सर फ़िल्मों के बिना काटे गए वर्शन की पहचान करने के लिए किया जाता है. हालांकि, इसके लिए फ़िल्म के कट वर्शन को आधिकारिक रेटिंग दी गई है. -
video
के संसाधन की नईcontentDetails.contentRating.ytRating
प्रॉपर्टी, उम्र की पाबंदी वाले कॉन्टेंट की पहचान करती है. अगर YouTube को पता चलता है कि वीडियो में ऐसा कॉन्टेंट शामिल है जो 18 साल से कम उम्र के उपयोगकर्ताओं के लिए सही नहीं है, तो प्रॉपर्टी की वैल्यूytAgeRestricted
होगी. अगर प्रॉपर्टी मौजूद नहीं है या उसकी वैल्यू खाली है, तो इसका मतलब है कि वीडियो पर उम्र से जुड़ी पाबंदी नहीं लगाई गई है. -
channels.list
तरीके केmySubscribers
पैरामीटर को हटा दिया गया है. पुष्टि किए गए उपयोगकर्ता के चैनल पर सदस्यों की सूची फिर से पाने के लिए,subscriptions.list
तरीके और इसकेmySubscribers
पैरामीटर का इस्तेमाल करें. -
channelBanners.insert
,channels.update
,videos.getRating
, औरvideos.rate
तरीके अबonBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं. इस पैरामीटर से पता चलता है कि पुष्टि किया गया उपयोगकर्ता, पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. -
channels.update
तरीके के दस्तावेज़ को अपडेट किया गया है. ऐसा यह बताने के लिए किया गया है किchannel
के रिसॉर्स केbrandingSettings
ऑब्जेक्ट और उसकी चाइल्ड प्रॉपर्टी को अपडेट करने के लिए, इस तरीके का इस्तेमाल किया जा सकता है. इस दस्तावेज़ में अब उन प्रॉपर्टी की अपडेट की गई सूची भी शामिल है जिन्हेंchannel
रिसॉर्स केinvideoPromotion
ऑब्जेक्ट के लिए सेट किया जा सकता है. -
error documentation
में इन नई गड़बड़ियों की जानकारी दी गई है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा forbidden
accountDelegationForbidden
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. यह बताता है कि पुष्टि किया गया उपयोगकर्ता बताए गए Google खाते की ओर से कार्रवाई करने के लिए अधिकृत नहीं है. forbidden
authenticatedUserAccountClosed
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता का YouTube खाता बंद है. अगर उपयोगकर्ता किसी दूसरे Google खाते की ओर से काम कर रहा है, तो यह गड़बड़ी उस खाते को बंद होने का संकेत देगी. forbidden
authenticatedUserAccountSuspended
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. इससे पता चलता है कि पुष्टि किए गए उपयोगकर्ता का YouTube खाता निलंबित कर दिया गया है. अगर उपयोगकर्ता किसी दूसरे Google खाते की ओर से कार्रवाई कर रहा है, तो यह गड़बड़ी यह बताती है कि दूसरा खाता निलंबित है. forbidden
authenticatedUserNotChannel
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. इससे पता चलता है कि एपीआई सर्वर, एपीआई अनुरोध से जुड़े चैनल की पहचान नहीं कर सकता. अगर अनुरोध को अनुमति मिली है और वह onBehalfOfContentOwner
पैरामीटर का इस्तेमाल करता है, तो आपकोonBehalfOfContentOwnerChannel
पैरामीटर भी सेट करना चाहिए.forbidden
cmsUserAccountNotFound
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. कॉन्टेंट मैनेजमेंट सिस्टम का इस्तेमाल करने वाले व्यक्ति को, बताए गए कॉन्टेंट के मालिक की ओर से कार्रवाई करने की अनुमति नहीं है. notFound
contentOwnerAccountNotFound
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. कॉन्टेंट के मालिक के तौर पर डाला गया खाता नहीं मिला. badRequest
invalidPart
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. अनुरोध के part
पैरामीटर में ऐसे हिस्से तय किए जाते हैं जिन्हें एक ही समय पर नहीं लिखा जा सकता.badRequest
videoChartNotFound
videos.list
वाला तरीका यह गड़बड़ी तब दिखाता है, जब अनुरोध ऐसे वीडियो चार्ट के बारे में बताता है जो उपलब्ध नहीं है या काम नहीं करता.notFound
videoNotFound
videos.update
वाला तरीका यह बताने के लिए गड़बड़ी का मैसेज दिखाता है कि जिस वीडियो को अपडेट करने की कोशिश की जा रही है वह नहीं मिला. अनुरोध के मुख्य हिस्से मेंid
प्रॉपर्टी की वैल्यू की जांच करके पक्का करें कि वह सही है.
10 जून, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channels.list
तरीके के नएforUsername
पैरामीटर की मदद से, किसी चैनल का YouTube उपयोगकर्ता नाम तय करके उसके बारे में जानकारी पाई जा सकती है. -
activities.list
वाला तरीका अबregionCode
पैरामीटर के साथ काम करता है. इससे एपीआई को निर्देश मिलता है कि वह बताए गए देश के हिसाब से काम के नतीजे दिखाए. YouTube इस वैल्यू का इस्तेमाल तब करता है, जब YouTube पर अनुमति पा चुके उपयोगकर्ता की पिछली गतिविधि ने गतिविधि फ़ीड जनरेट करने के लिए ज़रूरी जानकारी नहीं दी है. -
प्लेलिस्ट के संसाधनों में अब
snippet.tags
प्रॉपर्टी शामिल है. प्रॉपर्टी सिर्फ़ उन अधिकृत उपयोगकर्ताओं को वापस की जाएगी जो अपनी प्लेलिस्ट के बारे में डेटा हासिल कर रहे हैं. अनुमति पा चुके उपयोगकर्ता,playlists.insert
याplaylists.update
वाले तरीकों को कॉल करते समय भी प्लेलिस्ट के टैग सेट कर सकते हैं. -
onBehalfOfContentOwner
पैरामीटर, जो पहलेchannels.list
औरsearch.list
तरीकों के साथ काम करता था अबvideos.insert
,videos.update
, औरvideos.delete
तरीकों के साथ भी काम करता है. ध्यान दें कि जबvideos.insert
वाले कॉल में इस पैरामीटर का इस्तेमाल किया जाता है, तो अनुरोध में नएonBehalfOfContentOwnerChannel
पैरामीटर के लिए भी एक वैल्यू तय करनी होगी. इससे उस चैनल की पहचान होगी जिसमें वीडियो जोड़ा जाएगा. चैनल को कॉन्टेंट के उस मालिक से लिंक होना चाहिए जिसेonBehalfOfContentOwner
पैरामीटर तय करता है.पैरामीटर से पता चलता है कि अनुरोध के लिए, अनुमति देने वाले क्रेडेंशियल से YouTube सीएमएस का इस्तेमाल करने वाले उस व्यक्ति की पहचान होती है जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. उपयोगकर्ता जिस कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है वह खाता, YouTube कॉन्टेंट के उस मालिक से जुड़ा होना चाहिए.
यह पैरामीटर उन कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इस पैरामीटर की मदद से, उन पार्टनर को एक बार पुष्टि करने के बाद, अपने वीडियो और चैनल के पूरे डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं पड़ती.
खास तौर पर इस रिलीज़ के संबंध में, इस पैरामीटर की मदद से अब कॉन्टेंट पार्टनर अपने मालिकाना हक वाले किसी भी YouTube चैनल में वीडियो डाल सकता है, अपडेट कर सकता है या मिटा सकता है.
-
error documentation
में इन नई गड़बड़ियों की जानकारी दी गई है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा forbidden
insufficientCapabilities
यह गड़बड़ी किसी खास एपीआई के तरीके से जुड़ी नहीं है. यह बताता है कि एपीआई को कॉल करने वाले सीएमएस उपयोगकर्ता के पास, अनुरोध की गई कार्रवाई करने के लिए ज़रूरी अनुमतियां नहीं हैं. यह गड़बड़ी onBehalfOfContentOwner
पैरामीटर के इस्तेमाल से जुड़ी है, जो कई एपीआई तरीकों के साथ काम करता है.unauthorized
authorizationRequired
activities.list
वाला तरीका यह गड़बड़ी तब दिखाता है, जब अनुरोध मेंhome
पैरामीटर का इस्तेमाल किया जाता है, लेकिन सही तरीके से अनुमति नहीं दी गई होती. -
channels
संसाधन से,invideoPromotion.channelId
प्रॉपर्टी हटा दी गई है, क्योंकि संसाधन कीid
प्रॉपर्टी का इस्तेमाल करके, चैनल आईडी की जानकारी पहले ही दी जा चुकी है. -
चैनल आईडी के साथ काम करने से जुड़ी नई गाइड में बताया गया है कि एपीआई, चैनल आईडी का इस्तेमाल कैसे करता है. यह गाइड, एपीआई के पिछले वर्शन से माइग्रेट करने वाले डेवलपर के लिए काम की हो सकती है. साथ ही, उनके पास ऐसे ऐप्लिकेशन हैं जिनके लिए या तो
default
उपयोगकर्ता से कॉन्टेंट का अनुरोध किया जाता है या जो इस धारणा पर निर्भर हैं कि हर YouTube चैनल का एक अलग उपयोगकर्ता नाम है, जो अब लागू नहीं होता.
22 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channelBanners.insert
के नए तरीके की मदद से, एक बैनर इमेज अपलोड की जा सकती है. इस इमेज कोchannel
संसाधन की नईbrandingSettings.image.bannerExternalUrl
प्रॉपर्टी का इस्तेमाल करके, चैनल की बैनर इमेज के तौर पर सेट किया जा सकता है. -
तरीके को कॉल करते समय जिन प्रॉपर्टी में बदलाव किया जा सकता है उनकी सूची बनाने के लिए,
channels.update
तरीके के दस्तावेज़ को अपडेट किया गया है. -
video
के संसाधन दस्तावेज़ में अबsuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
, औरsuggestions.editorSuggestions[]
प्रॉपर्टी के लिए,unspecified
को मान्य प्रॉपर्टी वैल्यू के तौर पर शामिल नहीं किया गया है. -
videos.list
तरीके केmaxResults
पैरामीटर की डिफ़ॉल्ट वैल्यू अब5
है. -
error documentation
में अबchannelBanners.insert
औरsubscriptions.list
तरीकों की गड़बड़ियों की सूची दी गई है. इसमें,channels.update
तरीके से जुड़ी कई नई गड़बड़ियों की जानकारी भी दी गई है.
14 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
स्टैंडअलोन पेजों में अब Java, .NET, PHP, और Ruby के कोड के नमूने शामिल हैं.
-
Python के कोड सैंपल की सूची वाले पेज में, अब सदस्यता जोड़ने, प्लेलिस्ट बनाने, और वीडियो अपडेट करने के उदाहरण शामिल किए गए हैं.
10 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube, अब एक्सपेरिमेंट के तौर पर शुरू की गई एपीआई सुविधाओं और सेवाओं की पहचान नहीं करता. इसके बजाय, अब हम उन YouTube API (एपीआई) के लिए सूची मुहैया कराते हैं जिन पर सुविधा को बंद करने की नीति लागू होती है.
8 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
चैनल के संसाधन अब
inVideoPromotion
ऑब्जेक्ट के साथ काम करते हैं. इसमें चैनल से जुड़े किसी प्रमोशन वाले कैंपेन के बारे में जानकारी शामिल होती है. कोई चैनल, इन-वीडियो प्रमोशन कैंपेन का इस्तेमाल करके, प्रमोट किए गए वीडियो की थंबनेल इमेज को, वीडियो प्लेयर में वीडियो चलने के दौरान दिखा सकता है.इस डेटा को फिर से पाने के लिए,
channels.list
अनुरोध केpart
पैरामीटर वैल्यू मेंinvideoPromotion
शामिल करें. -
channels.update
के नए तरीके का इस्तेमाल, किसी चैनल के इन-वीडियो प्रमोशन कैंपेन का डेटा अपडेट करने के लिए किया जा सकता है. ध्यान दें कि यह तरीका सिर्फ़channel
संसाधन केinvideoPromotion
वाले हिस्से को अपडेट करता है. फ़िलहाल, यह तरीके उस संसाधन के दूसरे हिस्सों को अपडेट नहीं करता.
2 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
चैनल संसाधन अब
status.isLinked
प्रॉपर्टी के साथ काम करते हैं. इससे पता चलता है कि चैनल डेटा से किसी ऐसे उपयोगकर्ता की पहचान होती है जो पहले से ही YouTube उपयोगकर्ता नाम या Google+ खाते से लिंक है. जिस उपयोगकर्ता के पास इनमें से कोई एक लिंक है, उसकी पहले से ही एक सार्वजनिक YouTube पहचान है, जो वीडियो अपलोड करने जैसी कई कार्रवाइयों के लिए एक ज़रूरी शर्त है. -
सदस्यता से जुड़े संसाधन अब
subscriberSnippet
वाले हिस्से के साथ काम करते हैं. वह ऑब्जेक्ट एनकैप्सुलेट करता है, जिसमें सदस्य के चैनल का स्निपेट डेटा होता है. -
अब एपीआई,
videos.getRating
तरीके के साथ काम करता है. इससे उन रेटिंग को वापस लाया जा सकता है जो पुष्टि किए गए उपयोगकर्ता ने एक या एक से ज़्यादा वीडियो की सूची को दी थीं. -
videos.list
तरीके के नएmyRating
पैरामीटर की मदद से, उन वीडियो की सूची फिर से पाई जा सकती है जिन्हें पुष्टि किए गए उपयोगकर्ता नेlike
याdislike
रेटिंग से रेट किया है.myRating
पैरामीटर औरid
पैरामीटर, दोनों को अब फ़िल्टर पैरामीटर माना जाता है. इसका मतलब है कि एपीआई अनुरोध में, इनमें से कोई एक पैरामीटर होना ज़रूरी है. (पहले, इस तरीके के लिएid
पैरामीटर एक ज़रूरी पैरामीटर था.)यह तरीका उन अनुरोधों के लिए
forbidden
गड़बड़ी दिखाता है जो वीडियो रेटिंग की जानकारी पाने की कोशिश करते हैं, लेकिन जिन्हें ऐसा करने की अनुमति नहीं होती. -
myRating
पैरामीटर के लॉन्च होने के साथ ही,videos.list
तरीके को भी अपडेट किया गया है, ताकि पेज पर नंबर डालना आसान हो सके. हालांकि, ध्यान दें कि पेजिंग पैरामीटर सिर्फ़myRating
पैरामीटर का इस्तेमाल करने वाले अनुरोधों के लिए काम करते हैं.id
पैरामीटर का इस्तेमाल करने वाले अनुरोधों के लिए, पेजिंग पैरामीटर और जानकारी का इस्तेमाल नहीं किया जा सकता.-
maxResults
पैरामीटर से यह पता चलता है कि एपीआई, नतीजे के सेट में ज़्यादा से ज़्यादा कितने वीडियो दिखा सकता है. साथ ही,pageToken
पैरामीटर नतीजे के सेट में उस खास पेज की पहचान करता है जिसे आपको वापस लाना है. -
videos.list
के अनुरोध के जवाब में मिलने वालेyoutube#videoListResponse
संसाधन में अबpageInfo
ऑब्जेक्ट शामिल है. इसमें, मौजूदा नतीजे के सेट में शामिल नतीजों की कुल संख्या और नतीजों की संख्या जैसी जानकारी शामिल होती है.youtube#videoListResponse
संसाधन मेंnextPageToken
औरprevPageToken
प्रॉपर्टी भी शामिल हो सकती हैं. इनमें से हर प्रॉपर्टी एक टोकन देता है, जिसका इस्तेमाल नतीजे के सेट में किसी खास पेज को फिर से पाने के लिए किया जा सकता है.
-
-
videos.insert
वाला तरीका, इन नए पैरामीटर के साथ काम करता है:autoLevels
– YouTube को वीडियो की रोशनी और रंग अपने-आप बेहतर बनाने के निर्देश देने के लिए, इस पैरामीटर वैल्यू कोtrue
पर सेट करें.stabilize
– इस पैरामीटर वैल्यू कोtrue
पर सेट करें, ताकि YouTube कैमरे के मोशन की वजह से हिलने-डुलने वाली स्क्रीन को हटाकर, वीडियो में बदलाव कर सके.
-
इन संसाधनों के लिए,
channelTitle
प्रॉपर्टी कोsnippet
में जोड़ा गया:playlistItem
– प्रॉपर्टी से उस चैनल का नाम पता चलता है जिसने प्लेलिस्ट में आइटम जोड़ा है.playlist
– प्रॉपर्टी से, प्लेलिस्ट बनाने वाले चैनल का नाम पता चलता है.subscription
– प्रॉपर्टी से उस चैनल का नाम पता चलता है जिसकी सदस्यता ली गई है.
-
इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:
activities.insert
(रूबी)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, रूबी)videos.insert
(.NET, रूबी)
-
subscriptions.list
तरीके के नएmySubscribers
पैरामीटर की मदद से, ऐसे उपयोगकर्ताओं की सूची फिर से पाई जा सकती है जिनकी पुष्टि हो चुकी है. इस पैरामीटर का इस्तेमाल, सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है.ध्यान दें: इस सुविधा का मकसद,
channels.list
तरीके के साथ काम करने वालेmySubscribers
पैरामीटर को बदलना है. वह पैरामीटर काम नहीं करेगा. -
video
संसाधन में,unspecified
प्रॉपर्टी की वैल्यू अब इनमें से किसी भी प्रॉपर्टी के लिए संभावित वैल्यू नहीं है: -
अब ऐसे एपीआई अनुरोधों में
badRequest
गड़बड़ी दिखती है जिनमें अनचाहा पैरामीटर होता है. साथ ही, गड़बड़ी की रिपोर्ट की गई वजहunexpectedParameter
है. -
जब प्लेलिस्ट में पहले से ही स्वीकृत आइटम की अधिकतम संख्या मौजूद होती है, तो
playlistItems.insert
तरीके से दिखाई जाने वाली गड़बड़ी को अपडेट किया जाता है. गड़बड़ी को अबforbidden
गड़बड़ी के तौर पर रिपोर्ट किया जाता है और गड़बड़ी की वजहplaylistContainsMaximumNumberOfVideos
है.
19 अप्रैल, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
videos.rate
के नए तरीके का इस्तेमाल करके, उपयोगकर्ता किसी वीडियो परlike
याdislike
रेटिंग सेट कर सकता है या किसी वीडियो से रेटिंग हटा सकता है.गड़बड़ी के दस्तावेज़ को भी अपडेट किया गया है, ताकि उन गड़बड़ियों की सूची बनाई जा सके जो एपीआई के
videos.rate
तरीके से किए जाने वाले कॉल के जवाब में मिल सकती है. -
एपीआई दस्तावेज़ में, अब थंबनेल इमेज की पहचान एक अलग संसाधन के तौर पर की जाती है.
thumbnails.set
का नया तरीका आपको YouTube पर कस्टम वीडियो थंबनेल अपलोड करने और उसे वीडियो के लिए सेट करने की सुविधा देता है.गड़बड़ी के दस्तावेज़ को भी अपडेट किया गया है, ताकि उन गड़बड़ियों की सूची बनाई जा सके जो एपीआई के
thumbnails.set
तरीके से किए जाने वाले कॉल के जवाब में मिल सकती है.ध्यान दें कि इस बदलाव का असर, उन मौजूदा संसाधनों पर नहीं पड़ेगा जो थंबनेल इमेज दिखाते हैं. थंबनेल इमेज को उन संसाधनों में उसी तरह दिखाया जाता है जैसा वे पहले करते थे. हालांकि, दस्तावेज़ में अब अलग-अलग थंबनेल साइज़ के नामों की सूची दी गई है जिन्हें एपीआई दिखा सकता है.
-
channel
के संसाधन का नयाbrandingSettings
हिस्सा, चैनल के चैनल पेज और वीडियो के वॉच पेज की सेटिंग, टेक्स्ट, और इमेज की पहचान करता है. -
playlistItem
संसाधन में ये नई प्रॉपर्टी शामिल हैं:-
नया
status
ऑब्जेक्ट, प्लेलिस्ट में मौजूद आइटम के स्टेटस की जानकारी को इकट्ठा करता है. साथ ही,status.privacyStatus
प्रॉपर्टी, प्लेलिस्ट में मौजूद आइटम की निजता की स्थिति की पहचान करती है.
-
-
video
संसाधन में ये नई प्रॉपर्टी शामिल हैं:-
status.publicStatsViewable
प्रॉपर्टी से पता चलता है कि वॉच पेज पर मौजूद, बड़े किए गए वीडियो के आंकड़े सार्वजनिक तौर पर देखे जा सकते हैं या नहीं. डिफ़ॉल्ट रूप से, उन आंकड़ों को देखा जा सकता है. साथ ही, प्रॉपर्टी की वैल्यूfalse
पर सेट होने पर भी, वीडियो को देखे जाने की संख्या और रेटिंग जैसे आंकड़े सार्वजनिक तौर पर दिखते रहेंगे.videos.insert
याvideos.update
वाले तरीके को कॉल करते समय, इस प्रॉपर्टी की वैल्यू सेट की जा सकती है. -
contentDetails.contentRating
ऑब्जेक्ट में, अलग-अलग रेटिंग स्कीम के तहत वीडियो को मिली रेटिंग को इकट्ठा किया जाता है. यहां दी गई सूची, इस्तेमाल किए जा सकने वाले रेटिंग सिस्टम की पहचान करती है. साथ ही, हर रेटिंग सिस्टम से जुड़ी प्रॉपर्टी का लिंक भी देती है. प्रॉपर्टी की परिभाषाएं, हर सिस्टम के लिए इस्तेमाल की जा सकने वाली रेटिंग की वैल्यू की पहचान करती हैं.देश रेटिंग सिस्टम प्रॉपर्टी अमेरिका मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए) contentDetails.contentRating.mpaaRating
अमेरिका माता-पिता के लिए टीवी से जुड़े दिशा-निर्देश contentDetails.contentRating.tvpgRating
ऑस्ट्रेलिया ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी) contentDetails.contentRating.acbRating
ब्राज़ील Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
कनाडा कैनेडियन होम वीडियो रेटिंग सिस्टम (CHVRS) contentDetails.contentRating.chvrsRating
फ़्रांस सेंटर नैशनल डू सिनेमा एट डे एल इमेज एनिमी (फ़्रेंच संस्कृति मंत्रालय) contentDetails.contentRating.fmocRating
जर्मनी Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
ग्रेट ब्रिटेन ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) contentDetails.contentRating.bbfcRating
भारत सेंट्रल बोर्ड ऑफ़ फ़िल्म सर्टिफ़िकेशन (सीबीएफ़सी) contentDetails.contentRating.cbfcRating
जापान 映倫管理委員会 (EIRIN) में साइन इन करना contentDetails.contentRating.eirinRating
कोरिया 영상물등ACCESS위원 जी (KMRB) contentDetails.contentRating.kmrbRating
मेक्सिको जनरल डायरेक्टरेट ऑफ़ रेडियो, टेलीविज़न ऐंड सिनेमैटोग्राफ़ी (आरटीसी) contentDetails.contentRating.rtcRating
न्यूज़ीलैंड ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन contentDetails.contentRating.oflcRating
रूस नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन contentDetails.contentRating.russiaRating
स्पेन इंस्टीट्यूटो डे ला Cinematografía y de las Artes Audioविज़ुअलes (ICAA) contentDetails.contentRating.icaaRating
-
-
playlistItems.update
तरीके के दस्तावेज़ को अपडेट किया गया है, ताकि यह बताया जा सके कि अनुरोध के मुख्य हिस्से के तौर पर भेजे गए संसाधन मेंsnippet.resourceId
प्रॉपर्टी की जानकारी देना ज़रूरी है. -
search.list
तरीके में अब ये सुविधाएं काम करती हैं:-
नया
forMine
पैरामीटर किसी खोज को सिर्फ़ ऐसे उपयोगकर्ता के वीडियो पाने तक सीमित करता है जिसकी पुष्टि हो चुकी है. -
अब
order
पैरामीटर की मदद से, नतीजों को टाइटल (order=title
) या वीडियो की संख्या के हिसाब से घटते क्रम में (order=videoCount
) के हिसाब से क्रम से लगाया जा सकता है. -
नया
safeSearch
पैरामीटर बताता है कि खोज के नतीजों में प्रतिबंधित कॉन्टेंट शामिल होना चाहिए या नहीं.
-
-
videos.insert
वाला तरीका कई नई गड़बड़ियों के साथ काम करता है. इनकी जानकारी नीचे टेबल में दी गई है:गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा badRequest
invalidCategoryId
snippet.categoryId
प्रॉपर्टी में दी गई कैटगरी का आईडी अमान्य है. इस्तेमाल की जा सकने वाली कैटगरी को फिर से पाने के लिए,videoCategories.list
तरीके का इस्तेमाल करें.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
अनुरोध मेटाडेटा में वीडियो गेम की अमान्य रेटिंग मौजूद है. badRequest
invalidVideoMetadata
अनुरोध का मेटाडेटा अमान्य है. -
onBehalfOfContentOwner
पैरामीटर कोvideos.update
औरvideos.delete
तरीकों के साथ काम करने वाले पैरामीटर की सूची से हटा दिया गया है.
12 मार्च, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
इन संसाधनों के लिए,
channelTitle
प्रॉपर्टी कोsnippet
में जोड़ा गया: -
search.list
वाला तरीका, इन नए पैरामीटर के साथ काम करता है:-
channelType
पैरामीटर की मदद से, सभी चैनलों या सिर्फ़ शो को फिर से पाने के लिए, चैनलों की खोज को सीमित किया जा सकता है. -
videoType
पैरामीटर की मदद से, सभी वीडियो या सिर्फ़ फ़िल्मों या शो के एपिसोड को वापस लाने के लिए, वीडियो खोजने पर पाबंदी लगाई जा सकती है.
-
-
video
के संसाधन केrecordingDetails
वाले हिस्से की परिभाषा को अपडेट किया गया है. ऐसा इसलिए किया गया है, ताकि ऑब्जेक्ट को सिर्फ़ वीडियो के लिए उपलब्ध कराया जा सके. ऐसा तब किया जाएगा, जब वीडियो के जियोलोकेशन का डेटा या रिकॉर्डिंग का समय सेट किया गया हो. -
playlistItems.update
वाला तरीका अबinvalidSnippet
गड़बड़ी दिखाता है. अगर एपीआई अनुरोध में किसी मान्य स्निपेट के बारे में नहीं बताया गया है, तो यह गड़बड़ी दिखती है. -
एपीआई के कई तरीके, नए पैरामीटर के साथ काम करते हैं. ये पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए बनाए गए हैं. YouTube कॉन्टेंट पार्टनर में, फ़िल्म और टेलिविज़न स्टूडियो, रिकॉर्ड लेबल, और ऐसे अन्य कॉन्टेंट क्रिएटर्स शामिल हैं जो YouTube पर अपना कॉन्टेंट उपलब्ध कराते हैं.
-
onBehalfOfContentOwner
पैरामीटर से पता चलता है कि अनुरोध के लिए अनुमति देने वाले क्रेडेंशियल, YouTube सीएमएस का इस्तेमाल करने वाले किसी ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. उपयोगकर्ता जिस कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है वह खाता, YouTube कॉन्टेंट के उस मालिक से जुड़ा होना चाहिए.यह पैरामीटर उन कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इस पैरामीटर की मदद से, उन पार्टनर को एक बार पुष्टि करने के बाद, अपने वीडियो और चैनल के पूरे डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं पड़ती.
channels.list
,search.list
,videos.delete
,videos.list
, औरvideos.update
तरीके इस पैरामीटर के साथ काम करते हैं. -
channels.list
तरीके के साथ काम करने वालेmanagedByMe
पैरामीटर से, एपीआई को कॉन्टेंट के मालिक के मालिकाना हक वाले ऐसे सभी चैनलों को दिखाने का निर्देश मिलता है जिन्हेंonBehalfOfContentOwner
पैरामीटर ने तय किया है. -
forContentOwner
पैरामीटर,search.list
तरीके के साथ काम करता है. यह एपीआई को खोज के नतीजों को सीमित करने का निर्देश देता है, ताकि इसमें सिर्फ़ ऐसे संसाधन शामिल किए जा सकें जिनका मालिकाना हक कॉन्टेंट के मालिक के पास हो और जिन्हेंonBehalfOfContentOwner
पैरामीटर ने तय किया हो.
-
25 फ़रवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
यह एपीआई,
video
संसाधनों के लिए कई नए हिस्सों और प्रॉपर्टी के साथ काम करता है:-
fileDetails
,processingDetails
, औरsuggestions
के नए हिस्से, वीडियो के मालिकों को उनके अपलोड किए गए वीडियो की जानकारी देते हैं. यह डेटा उन ऐप्लिकेशन में बहुत उपयोगी होता है जो वीडियो अपलोड करने की सुविधा देते हैं और उसमें ये चीज़ें शामिल हैं:- प्रोसेसिंग की स्थिति और प्रोग्रेस
- वीडियो प्रोसेस करते समय आने वाली गड़बड़ियां या अन्य समस्याएं
- थंबनेल इमेज की उपलब्धता
- वीडियो या मेटाडेटा की क्वालिटी को बेहतर बनाने के सुझाव
- YouTube पर अपलोड की गई मूल फ़ाइल के बारे में जानकारी
इन सभी हिस्सों को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है. नीचे दी गई सूची में, नए हिस्सों के बारे में कम शब्दों में बताया गया है.
video
संसाधन दस्तावेज़ में उन सभी प्रॉपर्टी के बारे में बताया गया है जिनमें हर हिस्से में शामिल है.-
fileDetails
ऑब्जेक्ट में, उस वीडियो फ़ाइल की जानकारी होती है जिसे YouTube पर अपलोड किया गया था. इसमें फ़ाइल का रिज़ॉल्यूशन, कुल समय, ऑडियो और वीडियो कोडेक, स्ट्रीम बिटरेट वगैरह शामिल है. -
processingProgress
ऑब्जेक्ट में, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने के मामले में YouTube की प्रोग्रेस के बारे में जानकारी होती है. ऑब्जेक्ट की प्रॉपर्टी, वीडियो प्रोसेस होने की मौजूदा स्थिति की पहचान करती हैं. इसके बाद, YouTube वीडियो की प्रोसेसिंग पूरी होने में लगने वाले समय का अनुमान लगाता है. इस हिस्से से यह भी पता चलता है कि वीडियो के लिए अलग-अलग तरह का डेटा या कॉन्टेंट उपलब्ध है या नहीं, जैसे कि फ़ाइल की जानकारी या थंबनेल इमेज.इस ऑब्जेक्ट को पोल कराने के लिए डिज़ाइन किया गया है, ताकि वीडियो अपलोड करने वाला व्यक्ति, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने में YouTube की प्रोग्रेस को ट्रैक कर सके.
-
suggestions
ऑब्जेक्ट में ऐसे सुझाव होते हैं जो वीडियो की क्वालिटी या अपलोड किए गए वीडियो के मेटाडेटा को बेहतर बनाने की सुविधाओं की पहचान करते हैं.
-
contentDetails
वाले हिस्से में चार नई प्रॉपर्टी शामिल हैं. इन प्रॉपर्टी को बिना पुष्टि वाले अनुरोधों के साथ वापस पाया जा सकता है.dimension
– इससे पता चलता है कि वीडियो 2D में उपलब्ध है या 3D में.definition
– इससे पता चलता है कि वीडियो स्टैंडर्ड या हाई डेफ़िनिशन में उपलब्ध है या नहीं.caption
– इससे पता चलता है कि वीडियो के लिए कैप्शन उपलब्ध हैं या नहीं.licensedContent
– इससे पता चलता है कि वीडियो में ऐसा कॉन्टेंट है या नहीं जिस पर YouTube कॉन्टेंट पार्टनर ने दावा किया है.
-
status
वाले हिस्से में दो नई प्रॉपर्टी शामिल हैं. वीडियो के मालिक, वीडियो डालते या अपडेट करते समय दोनों प्रॉपर्टी के लिए वैल्यू सेट कर सकते हैं. इन प्रॉपर्टी को बिना पुष्टि वाले अनुरोधों के साथ भी वापस पाया जा सकता है.embeddable
– इससे यह पता चलता है कि वीडियो को किसी दूसरी वेबसाइट पर एम्बेड किया जा सकता है या नहीं.license
– इससे वीडियो के लाइसेंस के बारे में पता चलता है. मान्य वैल्यूcreativeCommon
औरyoutube
हैं.
-
-
videos.list
,videos.insert
, औरvideos.update
तरीकों के लिएpart
पैरामीटर की परिभाषा अपडेट की गई है, ताकि ऊपर बताए गए नए हिस्सों के साथ-साथrecordingDetails
वाले हिस्से को भी सूची में शामिल किया जा सके, जो अनजाने में हटा दिया गया था. -
channel
के संसाधन की नईcontentDetails.googlePlusUserId
प्रॉपर्टी, चैनल से जुड़े Google+ प्रोफ़ाइल आईडी के बारे में बताती है. इस मान का उपयोग Google+ प्रोफ़ाइल का लिंक जनरेट करने के लिए किया जा सकता है. -
अब हर थंबनेल इमेज ऑब्जेक्ट, इमेज की चौड़ाई और ऊंचाई के बारे में बताता है. फ़िलहाल, थंबनेल इमेज
activity
,channel
,playlist
,playlistItem
,search result
,subscription
, औरvideo
संसाधनों में दिखाई गई हैं. -
अब
playlistItems.list
,videoId
पैरामीटर के साथ काम करता है. इसका इस्तेमालplaylistId
पैरामीटर के साथ जोड़कर किया जा सकता है, ताकि सिर्फ़ उस प्लेलिस्ट आइटम को वापस पाया जा सके जो खास वीडियो की जानकारी देता है.अगर पैरामीटर की पहचान करने वाला वीडियो प्लेलिस्ट में नहीं मिलता है, तो एपीआई
notFound
गड़बड़ी दिखाता है. -
गड़बड़ी के दस्तावेज़ में एक नई
forbidden
गड़बड़ी के बारे में बताया गया है. इससे पता चलता है कि अनुरोध की गई कार्रवाई के लिए, अनुरोध को सही तरीके से अनुमति नहीं दी गई है. -
channel
संसाधन कीsnippet.channelId
प्रॉपर्टी हटा दी गई है. संसाधन कीid
प्रॉपर्टी एक ही मान देती है.
30 जनवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
नए गड़बड़ी पेज पर, उन गड़बड़ियों की सूची दिखती है जिन्हें एपीआई दिखा सकता है. पेज पर सामान्य गड़बड़ियां मौजूद हैं. ये गड़बड़ियां, एपीआई के अलग-अलग तरीकों से हो सकती हैं. साथ ही, पेज पर किसी खास तरीके से हुई गड़बड़ियां भी दिख सकती हैं.
16 जनवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
कोड सैंपल अब नीचे दी गई सूची में दिखाए गए तरीकों और भाषाओं के लिए उपलब्ध हैं:
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 वाले तरीके का इस्तेमाल करें.