इस पेज पर YouTube Data API (v3) में हुए बदलावों और दस्तावेज़ों से जुड़े अपडेट दिए गए हैं. इस बदलाव लॉग की सदस्यता लें.
30 अप्रैल, 2024
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
इस अपडेट में ये बदलाव शामिल हैं:
यह API अब चैनल चर्चाओं को शामिल करने या पुनर्प्राप्त करने की क्षमता का समर्थन नहीं करता है. यह बदलाव YouTube वेबसाइट पर काम करने वाली सुविधा के मुताबिक है. वेबसाइट पर चैनल पर टिप्पणियां पोस्ट करने की सुविधा काम नहीं करती.
13 मार्च, 2024
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
इस अपडेट में ये बदलाव शामिल हैं:
sync
पैरामीटर
captions.insert
और
captions.update
तरीके
को बंद कर दिया गया है. YouTube,
पैरामीटर का डेटा 12 अप्रैल, 2024 तक का है.
इस बदलाव के नतीजे के तौर पर, डेवलपर को रिपोर्ट डालते समय या कैप्शन ट्रैक को अपडेट करना नहीं है या अपलोड नहीं हो पाएगा.
12 मार्च, 2024
इस अपडेट में ये बदलाव शामिल हैं:
captions
संसाधन के दस्तावेज़ अपडेट कर दिए गए हैं. इसका मकसद यह बताना है कि snippet.name
की ज़्यादा से ज़्यादा लंबाई
फ़ील्ड में 150 वर्ण हैं. एपीआई, nameTooLong
दिखाता है
गड़बड़ी होती है अगर ट्रैक का नाम इससे लंबा है.
7 मार्च, 2024
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
channel
संसाधन प्रॉपर्टी
brandingSettings.channel.moderateComments
का इस्तेमाल नहीं किया जा सकता. YouTube बंद हो जाएगा
पैरामीटर का इस्तेमाल 7 मार्च, 2024 से किया जा रहा है.
31 जनवरी, 2024
इस अपडेट में ये बदलाव शामिल हैं:
channels.list
तरीके की नई forHandle
पैरामीटर की मदद से, किसी चैनल के YouTube हैंडल को तय करके उसके बारे में जानकारी हासिल की जा सकती है.
9 नवंबर, 2023
Comments
में दिए गए videoId
संसाधन के सभी रेफ़रंस
को हटा दिया गया है, क्योंकि एपीआई कॉल का इस्तेमाल करके videoId
संसाधन नहीं लौटाया जा रहा है.
12 सितंबर, 2023
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
comments.markAsSpam
तरीका
इसका लंबे समय से इस्तेमाल नहीं किया जा रहा है. यह तरीका YouTube पर पहले से ही काम नहीं करता है और
अब एपीआई की मदद से काम करता है.
उन सभी दस्तावेज़ों में
comments.markAsSpam
तरीका.
22 अगस्त, 2023
search.list
तरीका अब,
videoPaidProductPlacement
पैरामीटर. इस पैरामीटर की मदद से, खोज के नतीजों को फ़िल्टर करके सिर्फ़ वे वीडियो शामिल किए जा सकते हैं जो
क्रिएटर ने बताया हो कि उसका प्रमोशन पैसे लेकर किया गया है.
18 अगस्त, 2023
video
संसाधन की परिभाषा
liveStreamingDetails.concurrentViewers
को ध्यान में रखते हुए अपडेट किया गया है कि एक ही समय पर देखने वाले दर्शक गिन सकते हैं कि YouTube Data API से
यह संख्या, YouTube पर वीडियो को एक साथ देखने वाले उन दर्शकों की संख्या से अलग होती है जो स्पैम वाले वीडियो से स्पैम के तौर पर मार्क नहीं किए जाते
आंकड़े. कॉन्टेंट बनाने
YouTube सहायता केंद्र
से लाइव स्ट्रीमिंग की मेट्रिक के बारे में ज़्यादा जानकारी मिलती है.
7 अगस्त, 2023
12 जून, 2023 को किए गए एलान के मुताबिक,
search.list
तरीके का
relatedToVideoId
पैरामीटर अब काम नहीं करता. वह पैरामीटर अब मौजूद नहीं है
और पैरामीटर के रेफ़रंस, एपीआई दस्तावेज़ से हटा दिए गए हैं.
28 जून, 2023
thumbnails.set तरीका इस्तेमाल करके
uploadRateLimitExceeded
गड़बड़ी, जिससे पता चलता है कि चैनल ने बहुत ज़्यादा वीडियो अपलोड किए हैं
थंबनेल अपलोड किए गए हों और कुछ देर बाद कोशिश करनी चाहिए.
12 जून, 2023
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
search.list वाले तरीके की
relatedToVideoId
पैरामीटर अब काम नहीं करता. YouTube,
पैरामीटर का डेटा 7 अगस्त, 2023 तक का है.
इस समय, search.list
तरीके में, जानकारी रोकने की सूचना जोड़ी गई है
दस्तावेज़. यह पैरामीटर, search.list
दस्तावेज़ से पूरी तरह हटा दिया जाएगा
7 अगस्त, 2023 या इसके बाद लागू होगा.
इसके अलावा, मिलते-जुलते वीडियो को वापस लाने का तरीका दिखाने वाला एक उदाहरण इसे एपीआई लागू करने की गाइड से हटाया गया.
22 अगस्त, 2022
video.statistics के लिए ठीक किए गए एनोटेशन .
5 अगस्त, 2022
YouTube ने कैप्शन आईडी जनरेट करने का तरीका बदल दिया है. इस बदलाव के तहत,
सभी कैप्शन ट्रैक को नए कैप्शन आईडी असाइन करते हुए. ऐसा हो सकता है कि यह बदलाव, पुराने सिस्टम के साथ काम न करे
स्टोर करने वाले ऐप्लिकेशन के लिए बदलाव
caption_id
वैल्यू हैं. हालांकि, ऐसा नहीं होगा
उन ऐप्लिकेशन पर असर डालें जो सेव नहीं होते
caption_id
वैल्यू.
अब से 1 दिसंबर, 2022 के बीच,
captions.list
,
captions.update
,
captions.download
, और
और captions.delete
तरीकों से
पुराने और नए कैप्शन ट्रैक आईडी दोनों का समर्थन करता है. हालांकि, 1 दिसंबर, 2022 या इसके बाद, YouTube
पुराने कैप्शन ट्रैक आईडी का समर्थन करना बंद कर देगा. उस समय, इनमें से किसी भी एपीआई तरीके को कॉल करना
पुराने कैप्शन ट्रैक आईडी के साथ वीडियो दिखाने पर
captionNotFound
गड़बड़ी.
इस बदलाव के लिए तैयार रहने के लिए, आपको सेव किए गए सभी कैप्शन ट्रैक डेटा को पूरी तरह से बदलना होगा
अब से 1 दिसंबर, 2022 तक. इसका मतलब है कि ऐसे हर वीडियो के लिए कैप्शन ट्रैक को सेव किया जाएगा
डेटा, तो आपको वर्तमान में संग्रहित डेटा को हटाना चाहिए, फिर
पाने का captions.list
तरीका
वीडियो के लिए कैप्शन ट्रैक का मौजूदा सेट और एपीआई रिस्पॉन्स में डेटा को वैसे ही सेव करता है जैसे आप
सामान्य रूप से.
12 जुलाई, 2022
YouTube API सेवाओं की सेवा की शर्तें अपडेट कर दी गई हैं. प्लीज़ YouTube API सेवाओं की सेवा की शर्तें - संशोधन देखें इतिहास पर क्लिक करें.
27 अप्रैल, 2022
videos.insert
तरीके की जानकारी को अपडेट कर दिया गया है. इसमें यह जानकारी दी गई है कि अपलोड किए गए वीडियो का फ़ाइल साइज़, 128 जीबी से बढ़ाकर 256 जीबी कर दिया गया है.
8 अप्रैल, 2022
subscriptions.list
तरीके का
myRecentSubscribers
और mySubscribers
पैरामीटर की परिभाषाएं
दोनों में बदलाव किया गया है. एपीआई से वापस लौटने वाले सदस्यों की ज़्यादा से ज़्यादा संख्या सीमित हो सकती है.
यह बदलाव, दस्तावेज़ में किए गए सुधार को दिखाता है, न कि एपीआई के काम करने के तरीके में.
15 दिसंबर, 2021
जैसा कि 18 नवंबर, 2021 को किया गया था.
वीडियो को नापसंद करने की सुविधा में किए गए बदलाव
वीडियो को YouTube के पूरे प्लैटफ़ॉर्म पर निजी रखा जाता है. इसका मतलब यह है कि यह video
संसाधन के
statistics.dislikeCount
प्रॉपर्टी अब निजी हो गई है.
इस बदलाव के बारे में ज़्यादा जानने के लिए, YouTube का आधिकारिक ब्लॉग देखें.
18 नवंबर, 2021
इसमें परिवर्तन
वीडियो को नापसंद किए जाने की संख्या को YouTube के सभी प्लैटफ़ॉर्म पर निजी के तौर पर सेट करें, video
संसाधन
statistics.dislikeCount
प्रॉपर्टी 13 दिसंबर, 2021 से 'निजी' के तौर पर सेट हो जाएगी. इसका मतलब है कि प्रॉपर्टी सिर्फ़
अगर एपीआई अनुरोध यह था, तो उसे videos.list
एंडपॉइंट से एपीआई रिस्पॉन्स में शामिल किया जाएगा
वीडियो के मालिक ने पुष्टि की है.
videos.rate
एंडपॉइंट पर कोई असर नहीं पड़ा है
कितना असर पड़ रहा है.
ऐसे डेवलपर जो वीडियो को नापसंद किए जाने की संख्या सार्वजनिक रूप से नहीं दिखाते हैं उन्हें भी अपने वीडियो के लिए नापसंद किए जाने की संख्या की ज़रूरत होती है एपीआई क्लाइंट को अनुमति वाली सूची में शामिल करने के लिए आवेदन किया जा सकता है. छूट पाने का आवेदन करने के लिए, इसे पूरा करना होगा आवेदन फ़ॉर्म भरना होगा.
इस बदलाव के बारे में ज़्यादा जानने के लिए, YouTube का आधिकारिक ब्लॉग देखें.
2 जुलाई, 2021
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
commentThreads.update
एंडपॉइंट को अब बंद कर दिया गया है और यह अब काम नहीं करता.
इस एंडपॉइंट की डुप्लीकेट सुविधा, अन्य एपीआई एंडपॉइंट के ज़रिए उपलब्ध है. इसके बजाय, आप यह कर सकते है:
comments.update
को कॉल करो
commentThreads
संसाधन की ज़रूरत है, तो
commentThreads.list
तरीका.
1 जुलाई, 2021
YouTube की एपीआई सेवाओं का इस्तेमाल करने वाले सभी डेवलपर को एपीआई के नियमों के पालन की जांच पूरी करनी होगी. इससे, उन्हें 10,000 यूनिट के डिफ़ॉल्ट कोटा से ज़्यादा की रकम असाइन की जा सकेगी. अब तक, YouTube API सेवाएं - ऑडिट और कोटा एक्सटेंशन फ़ॉर्म भरकर, डेवलपर ने अनुपालन ऑडिट प्रोसेस और अतिरिक्त कोटा यूनिट असाइन करने के अनुरोध किए हैं.
इन प्रोसेस के बारे में साफ़ तौर पर बताने और हमारी एपीआई सेवाओं का इस्तेमाल करने वाले डेवलपर की ज़रूरतों को बेहतर तरीके से पूरा करने के लिए, हम तीन नए फ़ॉर्म जोड़ रहे हैं. साथ ही, फ़ॉर्म भरने के लिए एक गाइड भी जोड़ रहे हैं:
- ऑडिट किया गया डेवलपर अनुरोध फ़ॉर्म: जो डेवलपर एपीआई कंप्लायंस ऑडिट को पहले ही पास कर चुके हैं वे असाइन किए गए कोटा को बढ़ाने का अनुरोध करने के लिए, इस छोटे फ़ॉर्म को भरकर सबमिट कर सकते हैं.
- अपील फ़ॉर्म: जिन डेवलपर के एपीआई प्रोजेक्ट की जांच में पालन नहीं हो पाता या जिन्हें कोटा यूनिट बढ़ाने की अनुमति नहीं मिलती, वे इस फ़ॉर्म को भरकर सबमिट कर सकते हैं.
- कंट्रोल में बदलाव करने के लिए फ़ॉर्म: डेवलपर या उसके लिए एपीआई क्लाइंट चलाने वाले किसी भी पक्ष को यह फ़ॉर्म भरना और सबमिट करना होगा. ऐसा तब होगा, जब किसी एपीआई प्रोजेक्ट से जुड़े कंट्रोल में बदलाव (उदाहरण के लिए, स्टॉक की खरीदारी या बिक्री, मर्जर या किसी अन्य तरह के कॉर्पोरेट लेन-देन की वजह से) हुआ हो. इससे YouTube की एपीआई टीम को हमारे रिकॉर्ड अपडेट करने, नए एपीआई प्रोजेक्ट के इस्तेमाल के उदाहरण के पालन को ऑडिट करने, और डेवलपर के मौजूदा कोटा के बंटवारे की पुष्टि करने में मदद मिलती है.
हर नए फ़ॉर्म से हमें यह पता चलेगा कि आपने YouTube API का इस्तेमाल कैसे किया होगा. साथ ही, इससे हमें आपकी बेहतर तरीके से मदद करने में मदद मिलेगी.
ज़्यादा जानकारी हमारी नई एपीआई अनुपालन ऑडिट गाइड में उपलब्ध है.
12 मई, 2021
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
इस अपडेट में, एपीआई में हुए इन बदलावों को शामिल किया गया है:
-
channel
संसाधन काcontentDetails.relatedPlaylists.favorites
प्रॉपर्टी रोक दी गई है. पसंदीदा वीडियो की सुविधा इसके लिए पहले ही बंद कर दी गई है जैसा कि 28 अप्रैल, 2016 में हुए संशोधन में बताया गया है, इतिहास की एंट्री.इस अपडेट से पहले, अगर एपीआई क्लाइंट ऐसा करने की कोशिश करता था, तो एपीआई अब भी नई प्लेलिस्ट बनाता था किसी गैर-मौजूद पसंदीदा प्लेलिस्ट में वीडियो जोड़ना. अब से, प्लेलिस्ट बनाया जाएगा और एपीआई गड़बड़ी दिखाएगा. पसंदीदा प्लेलिस्ट में बदलाव करने की कोशिश पहले की सूचनाओं के हिसाब से आइटम जोड़ने, उनमें बदलाव करने या उन्हें मिटाने पर रोक लगा दी जाती है और किसी भी समय गड़बड़ियां दिखाना शुरू कर सकती हैं.
-
यहां दिया गया
channel
संसाधन प्रॉपर्टी रोक दी गई हैं. YouTube Studio के यूज़र इंटरफ़ेस (यूआई) में ये प्रॉपर्टी पहले से ही काम करती हैं और YouTube पर. इस वजह से अब ये एपीआई की मदद से भी काम नहीं करते.brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
सभी प्रॉपर्टी को
channel
संसाधन निरूपण हैं और उनकी परिभाषाएं संसाधन के प्रॉपर्टी की सूची. इसके अलावा, गड़बड़ियां इन प्रॉपर्टी से जुड़ी जानकारी को, खास तरीके के लिए बने दस्तावेज़ से हटा दिया गया है. -
यहां दिया गया
channelSection
संसाधन प्रॉपर्टी रोक दी गई हैं. YouTube Studio के यूज़र इंटरफ़ेस (यूआई) में ये प्रॉपर्टी पहले से ही काम करती हैं और YouTube पर. इस वजह से अब ये एपीआई की मदद से भी काम नहीं करते.snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
इस बदलाव के साथ,
channelSection.list
तरीकाhl
पैरामीटर में यह भी है बंद कर दिया गया है, क्योंकि इसके साथ काम करने वाली सुविधाएं काम नहीं करतीं.सभी प्रॉपर्टी को
channelSection
संसाधन निरूपण हैं और उनकी परिभाषाएं संसाधन के प्रॉपर्टी की सूची. इसके अलावा, गड़बड़ियां इन प्रॉपर्टी से जुड़ी जानकारी को, खास तरीके के लिए बने दस्तावेज़ से हटा दिया गया है. -
channelSection
संसाधन के लिएsnippet.type
प्रॉपर्टी, ये वैल्यू अब काम नहीं करतीं. YouTube पर ये वैल्यू पहले से इस्तेमाल नहीं की जा सकतीं और इस वजह से, वे अब API के ज़रिए भी काम नहीं करते.likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
playlist
संसाधन काsnippet.tags[]
प्रॉपर्टी रोक दी गई है. यह प्रॉपर्टी पहले से ही काम नहीं कर रही है को डाउनलोड किया है और इस वजह से, यह अब API के ज़रिए काम नहीं करता.
9 फ़रवरी, 2021
playlistItem
संसाधन दो नई प्रॉपर्टी के साथ काम करता है:
snippet.videoOwnerChannelId
प्रॉपर्टी, प्लेलिस्ट वीडियो अपलोड करने वाले चैनल के आईडी की पहचान करती है.snippet.videoOwnerChannelTitle
प्रॉपर्टी, प्लेलिस्ट वीडियो अपलोड करने वाले चैनल के नाम की पहचान करती है.
28 जनवरी, 2021
इस अपडेट में ये बदलाव शामिल हैं:
-
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
, औरplaylists.update
तरीके सभी काम करते हैंplaylistOperationUnsupported
की कोई नई गड़बड़ी. गड़बड़ी तब होती है, जब कोई अनुरोध कोई ऐसी कार्रवाई करेगा जिसकी किसी विशेष प्लेलिस्ट के लिए अनुमति नहीं है. उदाहरण के लिए, कोई उपयोगकर्ता अपलोड किए गए वीडियो की प्लेलिस्ट से वीडियो मिटाना या उस प्लेलिस्ट को मिटाना.सभी मामलों में, यह गड़बड़ी
400
एचटीटीपी रिस्पॉन्स कोड (खराब अनुरोध) दिखाती है. -
playlistItems.list
तरीके काwatchHistoryNotAccessible
औरwatchLaterNotAccessible
गड़बड़ियों में दस्तावेज़ से हटा दिया गया है. वहीं उपयोगकर्ता देखने के इतिहास और बाद में देखे जाने वाले वीडियो की सूचियां, असल में API के ज़रिए ऐक्सेस नहीं किया जा सकता, इसलिए ये खास गड़बड़ियां एपीआई से नहीं दिखाई जाती हैं.
15 अक्टूबर, 2020
डेवलपर खाते में दो नए सेक्शन जोड़े गए हैं नीतियां:
- नए सेक्शन III.E.4.i में YouTube के एम्बेड किए गए प्लेयर से इकट्ठा किए गए और भेजे गए डेटा के बारे में ज़्यादा जानकारी. आपने लोगों तक पहुंचाया मुफ़्त में आपके द्वारा YouTube एम्बेड किए गए प्लेयर के माध्यम से हमें भेजे जाने वाले किसी भी उपयोगकर्ता डेटा के लिए उपयोगकर्ता ने प्लेबैक इंटेंट बताने के लिए प्लेयर से इंटरैक्ट किया है. आपके पास शेयर किए जाने वाले डेटा को सीमित करने का विकल्प है वीडियो अपने-आप चलने की सुविधा को 'गलत है' पर सेट करके, उपयोगकर्ता के YouTube के साथ इंटरैक्ट करने से पहले.
- नया सेक्शन III.E.4.j, वीडियो को अपनी साइटों पर एम्बेड करने से पहले, उसके 'बच्चों के लिए बने' (MFK) की स्थिति देखना दिखाई देता है. यह जानना आपकी ज़िम्मेदारी है कि आपके एपीआई क्लाइंट पर एम्बेड किए गए वीडियो कब बनाए गए और एम्बेड किए गए प्लेयर से इकट्ठा किए गए डेटा को उसी हिसाब से इस्तेमाल किया जाए. इसलिए, आपको अपने एपीआई पर एम्बेड करने से पहले, YouTube Data API सेवा का इस्तेमाल करके कॉन्टेंट का स्टेटस देखें YouTube के एम्बेड किए गए प्लेयर से क्लाइंट करें.
नया किसी वीडियो के लिए MadeForKids के स्टेटस का पता लगाना इस गाइड में बताया गया है कि YouTube Data API सेवा.
इन बदलावों के साथ ही, इसमें एक रिमाइंडर जोड़ा गया है एम्बेड किए गए प्लेयर पैरामीटर का दस्तावेज़. इसमें बताया गया है कि अगर आपने वीडियो अपने-आप चलने की सुविधा को चालू किया है, तो उपयोगकर्ता के इंटरैक्शन के बिना ही वीडियो चलता रहेगा; प्लेबैक इसलिए, डेटा इकट्ठा और शेयर किया जाएगा.
8 अक्टूबर, 2020
इस अपडेट में तीन छोटे बदलाव शामिल किए गए हैं
channel
संसाधन:
snippet.thumbnails
ऑब्जेक्ट जो किसी चैनल के थंबनेल इमेज की पहचान करता है, हो सकता है कि नई चीज़ों के लिए खाली हो हैं और इन्हें भरने में एक दिन लग सकता है.statistics.videoCount
प्रॉपर्टी से, चैनल के सिर्फ़ सार्वजनिक वीडियो की संख्या दिखती है. यहां तक कि मालिकों के लिए भी नहीं. यह व्यवहार YouTube वेबसाइट पर दिखाई गई संख्या से मेल खाता हो.- चैनल कीवर्ड, जिनकी पहचान
brandingSettings.channel.keywords
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है प्रॉपर्टी को छोटा किया जा सकता है. ऐसा तब किया जाएगा, जब वे 500 वर्णों की तय सीमा से ज़्यादा हों या अगर उनमें अनएस्केप्ड कोटेशन मार्क ("
) हों. ध्यान दें कि 500 वर्ण सीमा प्रति-कीवर्ड सीमा नहीं है, बल्कि सभी कीवर्ड की कुल लंबाई की सीमा है. यह तरीका YouTube की वेबसाइट पर दिए गए व्यवहार से मेल खाता है.
9 सितंबर, 2020
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
इस अपडेट में, एपीआई में हुए इन बदलावों को शामिल किया गया है. सभी बदलाव इस तारीख को या इस तारीख के बाद लागू होंगे यह एलान 9 सितंबर, 2020 को किया जाएगा. इस बात को ध्यान में रखते हुए, डेवलपर को अब नीचे दी गई किसी भी एपीआई सुविधा का इस्तेमाल करें.
-
इन एपीआई रिसॉर्स, तरीकों, पैरामीटर, और रिसॉर्स प्रॉपर्टी का इस्तेमाल नहीं किया जा सकता
साथ ही, इस एलान की तारीख को या इसके बाद काम करना बंद कर देगा:
- यहां दिया गया
channel
संसाधन प्रॉपर्टी:statistics.commentCount
प्रॉपर्टीbrandingSettings.image
ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टीbrandingSettings.hints
सूची और इसकी सभी चाइल्ड प्रॉपर्टी
channels.list
तरीके काcategoryId
फ़िल्टर पैरामीटरguideCategories
संसाधन औरguideCategories.list
तरीका
- यहां दिया गया
-
एपीआई से मिले जवाब
channels.list
तरीके का नंबर लंबे समय तकprevPageToken
प्रॉपर्टी, अगर एपीआई अनुरोधmanagedByMe
पैरामीटरtrue
तक. इस बदलाव का असरprevPageToken
प्रॉपर्टी पर नहीं पड़ेगा अन्यchannels.list
अनुरोधों के लिए है और इससेnextPageToken
प्रॉपर्टी का इस्तेमाल करें. -
channel
संसाधन काcontentDetails.relatedPlaylists.watchLater
औरcontentDetails.relatedPlaylists.watchHistory
प्रॉपर्टी का एलान हुआ था जैसा कि 11 अगस्त, 2016 को बंद कर दिया गया. कॉन्टेंट बनानेplaylistItems.insert
तरीके औरplaylistItems.delete
तरीके से जुड़ी सहायता इन प्लेलिस्ट के लिए भी, अब पूरी तरह से रोक लगा दी गई है. साथ ही, दोनों प्रॉपर्टी को हटा दिया गया है दस्तावेज़ में दिए गए पेज से. -
channels.list
तरीके काmySubscribers
पैरामीटर, जो यह था एलान 30 जुलाई, 2013 को किया गया था. इसे दस्तावेज़ से हटा दिया गया है. इसका इस्तेमाल करेंsubscriptions.list
तरीका और यहmySubscribers
पैरामीटर है, जो पुष्टि किए गए उपयोगकर्ता के चैनल की पुष्टि करें. -
channel
संसाधन काinvideoPromotion
ऑब्जेक्ट और उसके सभी चाइल्ड प्रॉपर्टी, जिन्हें 27 नवंबर, 2017 को दस्तावेज़ से हटा दिया गया है.
29 जुलाई, 2020
हमने एपीआई अनुरोधों के लिए शुल्क लेने की अपनी प्रोसेस को आसान बना दिया है. इसके लिए,
part
पैरामीटर से जुड़ी लागत. हम तुरंत आपके बैंक खाते से
कॉल करने वाले तरीके की मूल लागत. आपको सरल बनाए गए
यहां दिया गया है.
इस बदलाव का असर यह होगा कि ज़्यादातर एपीआई कॉल का कोटा थोड़ा कम होगा, जबकि कुछ एपीआई कॉल के लिए अब भी वही शुल्क लगेगा. इस बदलाव से किसी भी एपीआई की लागत नहीं बढ़ती है कॉल. इसका असर आपके कोटे की तय सीमा पर पड़ेगा. इसे यहां देखा जा सकता है: Google Cloud Console, इससे बेहतर काम करेगा.
हमारा सुझाव है कि सभी डेवलपर अनुपालन के ऑडिट के लिए, YouTube API सेवाओं का ऐक्सेस बना रहे.
बदलावों के इतिहास की यह एंट्री मूल रूप से 20 जुलाई, 2020 को पब्लिश हुई थी.
28 जुलाई, 2020
videos.insert
के माध्यम से अपलोड किए गए सभी वीडियो
28 जुलाई, 2020 के बाद बनाए गए, पुष्टि नहीं किए गए एपीआई प्रोजेक्ट के एंडपॉइंट का इस्तेमाल,
निजी वीडियो देखने वाला मोड. इस पाबंदी को हटाने के लिए, हर प्रोजेक्ट के लिए ज़रूरी है कि
पुष्टि करने के लिए ऑडिट कराना
अनुपालन
सेवा की शर्तें.
ऐसे क्रिएटर्स जो वीडियो अपलोड करने के लिए, ऐसे एपीआई क्लाइंट का इस्तेमाल करते हैं जिसकी पुष्टि नहीं हुई है उनके वीडियो को 'निजी' के तौर पर लॉक कर दिया गया है. साथ ही, वे इस पाबंदी से बचने के लिए, या ऑडिट किया गया क्लाइंट.
28 जुलाई, 2020 से पहले बनाए गए एपीआई प्रोजेक्ट, पर इस बदलाव का कोई असर नहीं होगा. हालांकि, हमारा सुझाव है कि सभी डेवलपर को अनुपालन ऑडिट को पूरा करें साथ ही, हम चाहते हैं कि उनके प्रोजेक्ट के लिए, YouTube API की सेवाओं का ऐक्सेस बना रहे.
21 जुलाई, 2020
[28 जुलाई, 2020 को अपडेट किया गया.] इस संशोधन में बताया गया दस्तावेज़ से जुड़ा अपडेट इतिहास की एंट्री को 28 जुलाई, 2020 को फिर से पब्लिश किया गया था.
कल हमने कोटा चार्ज करने की हमारी प्रक्रिया से जुड़े दस्तावेज़ का अपडेट पब्लिश किया था. हालांकि, कुछ खास परिस्थितियों की वजह से, कोटा में हुए बदलाव को लागू नहीं किया जा सका है. इस वजह से, सटीक होने के मक़सद से, दस्तावेज़ को पहले जैसा कर दिया गया है. भ्रम की स्थिति से बचने के लिए, संशोधन बदलाव की जानकारी देने वाली इतिहास की एंट्री को हटा दिया गया है और आने वाले समय में इसे फिर से पब्लिश किया जाएगा.
7 जुलाई, 2020
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
videos.insert
तरीके का
autoLevels
और stabilize
पैरामीटर अब काम नहीं करते. साथ ही, ये दोनों पैरामीटर अब काम नहीं करते
दस्तावेज़ से पैरामीटर हटा दिए गए हैं. उनके मानों को अनदेखा किया जाता है और
अपलोड किए गए नए वीडियो को प्रोसेस करने का
तरीका होता है.
15 जून, 2020
YouTube डेवलपर का अनुपालन करने वाला नया नीतियों वाली गाइड में दिशा-निर्देश और उदाहरण दिए गए हैं. इनसे आपको यह पक्का करने में मदद मिलती है कि आपके एपीआई क्लाइंट इन दिशा-निर्देशों का पालन करते हैं या नहीं खास हिस्सों को ऐक्सेस करने की अनुमति देते हैं. शर्तें और नीतियां (एपीआई की सेवा की शर्तें).
इस दिशा-निर्देश से आपको यह अहम जानकारी मिलती है कि YouTube, एपीआई की सेवा की शर्तों के कुछ पहलुओं को कैसे लागू करता है, लेकिन किसी मौजूदा दस्तावेज़ को न बदलें. इस गाइड में, आम तौर पर पूछे जाने वाले कुछ सवालों के जवाब दिए गए हैं डेवलपर, एपीआई के अनुपालन से जुड़े ऑडिट के दौरान पूछते हैं. हमें उम्मीद है कि इससे सुविधाओं को डेवलप करने में आसानी होगी हम अपनी नीतियों को कैसे समझ पाते हैं और उन्हें कैसे लागू करते हैं.
4 जून, 2020
ध्यान दें: यह सुविधा बंद करने की पहले की गई घोषणा में अपडेट है.
चैनल बुलेटिन की सुविधा पूरी तरह से बंद कर दी गई है. इस बदलाव का एलान पहले किया गया था
17 अप्रैल, 2020 से लागू कर दिया गया है. इस वजह से,
activities.insert
तरीका नहीं है
लंबे समय तक काम करता है और
activities.list
तरीका अब चैनल बुलेटिन नहीं दिखाता. ज़्यादा जानकारी के लिए, कृपया यह देखें
YouTube सहायता केंद्र.
17 अप्रैल, 2020
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
YouTube, चैनल बुलेटिन की सुविधा बंद कर रहा है. इस वजह से,
activities.insert
तरीका होगा
के इस्तेमाल पर रोक लगा दी है और activities.list
तरीका, चैनल बुलेटिन दिखाना बंद कर देगा. ये बदलाव API में इस तारीख को लागू होंगे या
यह ऑफ़र 18 मई, 2020 के बाद लागू होगा. ज़्यादा जानकारी के लिए, कृपया यह देखें
YouTube सहायता केंद्र.
31 मार्च, 2020
इस अपडेट में ये बदलाव शामिल हैं:
-
नए संसाधन और तरीके
-
नया
member
संसाधन पैसे चुकाकर किसी YouTube चैनल की सदस्यता ली है. कोई सदस्य क्रिएटर को खास फ़ायदे मिलते हैं. उदाहरण के लिए, सदस्य चैट कर सकते हैं, जब क्रिएटर, चैट के लिए 'सिर्फ़ सदस्यों के लिए' मोड को चालू कर देता है.यह संसाधन,
sponsor
की जगह ले लेता है के एक हिस्से के तौर पर मौजूद है. कॉन्टेंट बनानेsponsor
संसाधन अब काम नहीं कर रहा है. एपीआई क्लाइंट को कॉल यहां अपडेट करने चाहिएsponsors.list
तरीके का इस्तेमाल करके इसके बजाय,members.list
तरीके का इस्तेमाल करें. -
नया
membershipsLevel
संसाधन, एपीआई अनुरोध को अनुमति देने वाले क्रिएटर की ओर से मैनेज किए जाने वाले कीमत के लेवल की पहचान करता है.membershipsLevels.list
तरीका, क्रिएटर की सदस्यता के सभी लेवल की सूची को फिर से हासिल करता है.
-
10 जनवरी, 2020
यह एपीआई अब बच्चों के लिए बने कॉन्टेंट की पहचान करने की सुविधा देता है, जिसे YouTube "बच्चों के लिए बना" है. इसके बारे में ज़्यादा जानें "बच्चों के लिए बने" कॉन्टेंट के बारे में ज़्यादा जानकारी मिलेगी.
channel
और
video
संसाधन दो नई प्रॉपर्टी के साथ काम करते हैं
कॉन्टेंट क्रिएटर्स और दर्शकों को बच्चों के लिए बने वीडियो की पहचान करने की सुविधा देना:
-
selfDeclaredMadeForKids
प्रॉपर्टी की मदद से कॉन्टेंट क्रिएटर्स यह तय कर सकते हैं कि channel या वीडियो बच्चों के लिए बना है.
चैनलों के लिए, इस प्रॉपर्टी कोchannels.update
तरीका. वीडियो के लिए, इस प्रॉपर्टी को तब सेट किया जा सकता है, जबvideos.insert
याvideos.update
तरीके.
ध्यान दें कि यह प्रॉपर्टी सिर्फ़ एपीआई के उन जवाबों में शामिल होती है जिनमेंchannel
याvideo
संसाधन, अगर चैनल के मालिक ने एपीआई अनुरोध की अनुमति दी है. -
madeForKids
प्रॉपर्टी की मदद से, कोई भी उपयोगकर्ता "बच्चों के लिए" कैटगरी वाले वीडियो को फिर से पा सकता है स्थिति या चैनल के वीडियो. उदाहरण के लिए, स्थितिselfDeclaredMadeForKids
प्रॉपर्टी की वैल्यू के आधार पर तय किया जाता है. ज़्यादा जानकारी के लिए, ज़्यादा जानकारी के लिए, YouTube सहायता केंद्र पर जाएं आपके चैनल, वीडियो या ब्रॉडकास्ट के लिए दर्शक तय करने के बारे में जानकारी.
हमने YouTube API की सेवाओं की शर्तें और डेवलपर के लिए बनाई गई नीतियों को भी अपडेट किया है. प्लीज़ YouTube API सेवाओं की सेवा की शर्तें - संशोधन देखें इतिहास पर क्लिक करें. YouTube API की सेवाओं की शर्तों में हुए बदलाव और डेवलपर के लिए नीतियां 10 जनवरी, 2020 पैसिफ़िक समय के हिसाब से लागू होंगी.
10 सितंबर, 2019
एपीआई के रेफ़रंस दस्तावेज़ को अपडेट कर दिया गया है, ताकि सदस्य के तरीके में हुए बदलाव को दिखाया जा सके
की संख्या YouTube पर रिपोर्ट की जाती है और इसलिए, API से मिले जवाबों में भी इन्हें दिखाया जाता है. इस बदलाव की वजह से,
YouTube Data API सेवा से वापस मिलने वाले सदस्यों की संख्या को तीन बड़ी संख्या में बदल दिया जाता है
सदस्यों की संख्या 1,000 से ज़्यादा होने पर. इस परिवर्तन से
channel
संसाधन
statistics.subscriberCount
प्रॉपर्टी.
ध्यान दें: इसका असर इस प्रॉपर्टी की वैल्यू पर तब भी पड़ता है, जब कोई उपयोगकर्ता अपने चैनल का डेटा पाने के लिए, अनुमति वाला अनुरोध भेजता है. चैनल के मालिक अब भी यह देख सकते हैं कि YouTube Studio में सदस्यों की संख्या में हुई बढ़ोतरी.
उदाहरण के लिए, अगर किसी चैनल के 1,23,456 सदस्य हैं, तो
statistics.subscriberCount
प्रॉपर्टी की वैल्यू 123000
होगी.
यहां दी गई टेबल में कुछ उदाहरण दिए गए हैं. इनमें बताया गया है कि एपीआई से मिले जवाबों में सदस्यों की संख्या को राउंड ऑफ़ किया जाता है और
सार्वजनिक रूप से दिखने वाले अन्य YouTube यूज़र इंटरफ़ेस में छोटे किए गए नाम का इस्तेमाल किया जा सकता है:
सदस्यों की संख्या का उदाहरण | YouTube डेटा एपीआई | सार्वजनिक तौर पर दिखने वाले YouTube यूज़र इंटरफ़ेस (यूआई) |
---|---|---|
1,234 | 1230 | 1.23 हज़ार |
12,345 | 12300 | 12.3 हज़ार |
1,23,456 | 123000 | 1.23 लाख |
12,34,567 | 1230000 | 12.3 लाख |
1,23,45,678 | 12300000 | 1.23 करोड़ |
12,34,56,789 | 123000000 | 12.3 करोड़ |
4 अप्रैल, 2019
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई के रेफ़रंस दस्तावेज़ को अपडेट किया गया है, ताकि हर तरीके को इस्तेमाल के सामान्य उदाहरणों के बारे में बेहतर तरीके से बताया जा सके. साथ ही, एपीआई एक्सप्लोरर विजेट के ज़रिए डाइनैमिक और अच्छी क्वालिटी वाले कोड सैंपल उपलब्ध कराए जा सकें. उदाहरण के लिए,
channels.list
तरीके का दस्तावेज़ देखें. एपीआई के तरीकों के बारे में जानकारी देने वाले पेजों पर, अब दो नए एलिमेंट दिख रहे हैं:-
एपीआई एक्सप्लोरर विजेट की मदद से, अनुमति देने के दायरे चुने जा सकते हैं. साथ ही, सैंपल पैरामीटर और प्रॉपर्टी की वैल्यू डाली जा सकती हैं. इसके बाद, एपीआई के असल अनुरोध भेजने और एपीआई से मिले असल रिस्पॉन्स देखने की सुविधा मिलती है. विजेट में एक फ़ुलस्क्रीन व्यू भी दिखता है. इसमें पूरे कोड सैंपल दिखते हैं. ये सैंपल, आपकी ओर से डाले गए दायरे और वैल्यू का इस्तेमाल करने के लिए, डाइनैमिक तौर पर अपडेट होते हैं.
-
इस्तेमाल के सामान्य उदाहरण सेक्शन में, पेज पर बताए गए तरीके के एक या एक से ज़्यादा सामान्य उदाहरणों के बारे में बताया गया है. उदाहरण के लिए, किसी चैनल का डेटा पाने या मौजूदा उपयोगकर्ता के चैनल का डेटा पाने के लिए,
channels.list
तरीके को कॉल किया जा सकता है.अपने इस्तेमाल के उदाहरण के लिए, एपीआई एक्सप्लोरर को सैंपल वैल्यू से भरने के लिए या पहले से भरी गई वैल्यू के साथ फ़ुलस्क्रीन एपीआई एक्सप्लोरर खोलने के लिए, उस सेक्शन में मौजूद लिंक का इस्तेमाल किया जा सकता है. इन बदलावों का मकसद, ऐसे कोड सैंपल को देखना आसान बनाना है जो आपके ऐप्लिकेशन में लागू किए जा रहे इस्तेमाल के उदाहरण पर सीधे लागू होते हैं.
फ़िलहाल, कोड सैंपल Java, JavaScript, PHP, Python, और कर्ल के साथ काम करते हैं.
-
-
कोड सैंपल टूल को नए यूज़र इंटरफ़ेस (यूआई) के साथ भी अपडेट किया गया है. इसमें ऊपर बताई गई सभी सुविधाएं मौजूद हैं. इस टूल का इस्तेमाल करके, अलग-अलग तरीकों के इस्तेमाल के उदाहरण एक्सप्लोर किए जा सकते हैं और APIs Explorer में वैल्यू लोड की जा सकती हैं. साथ ही, Java, JavaScript, PHP, और Python में कोड सैंपल पाने के लिए, फ़ुलस्क्रीन API एक्सप्लोरर खोला जा सकता है.
इस बदलाव के साथ ही, Java, JavaScript, PHP, और Python के लिए पहले से उपलब्ध कोड सैंपल की सूची वाले पेजों को हटा दिया गया है.
-
Java, JavaScript, PHP, और Python के लिए क्विकस्टार्ट गाइड अपडेट कर दी गई हैं. बदली गई गाइड में यह बताया गया है कि एपीआई एक्सप्लोरर के कोड सैंपल का इस्तेमाल करके, एक सैंपल एपीआई पासकोड और दूसरा सैंपल, OAuth 2.0 क्लाइंट आईडी के साथ कैसे चलाया जा सकता है.
ध्यान दें कि ऊपर बताए गए बदलाव एक ऐसे इंटरैक्टिव टूल की जगह ले लेते हैं जिसे 2017 में एपीआई दस्तावेज़ में जोड़ा गया था.
9 जुलाई, 2018
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन कीsnippet.thumbnails
प्रॉपर्टी की परिभाषा यह नोट करने के लिए अपडेट की गई है कि आपके ऐप्लिकेशन में थंबनेल दिखाते समय, आपके कोड को इमेज के यूआरएल का इस्तेमाल ठीक उसी तरह करना चाहिए जिस तरह वे एपीआई के रिस्पॉन्स में दिखते हैं. उदाहरण के लिए, आपके ऐप्लिकेशन को एपीआई रिस्पॉन्स के तौर पर मिले यूआरएल में,https
डोमेन के बजायhttp
डोमेन का इस्तेमाल नहीं करना चाहिए.जुलाई 2018 से, चैनल के थंबनेल के यूआरएल सिर्फ़
https
डोमेन में उपलब्ध होंगे. एपीआई से मिले जवाबों में यूआरएल इसी तरह से दिखते हैं. इसके बाद, अगर आपका ऐप्लिकेशनhttp
डोमेन से YouTube इमेज लोड करने की कोशिश करता है, तो आपको उसमें काम न करने वाली इमेज दिख सकती हैं. -
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
video
संसाधन कीrecordingDetails.location.altitude
प्रॉपर्टी बंद कर दी गई है. इस बात की कोई गारंटी नहीं है कि वीडियो, इस प्रॉपर्टी के लिए वैल्यू दिखाएगा. इसी तरह, अगर एपीआई अनुरोध उस प्रॉपर्टी के लिए वैल्यू सेट करने की कोशिश करते हैं, तो भी हो सकता है कि आने वाला डेटा सेव न हो.
22 जून, 2018
लागू करने की गाइड को पहले लागू करने और माइग्रेशन गाइड को अपडेट कर दिया गया है, ताकि v2 API को v3 API से जोड़ा. इसके अलावा, ऐसी सुविधाओं के लिए भी निर्देश हटा दिए गए हैं जिनमें को v3 API में बंद कर दिया गया है, जैसे कि पसंदीदा वीडियो.
27 नवंबर, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
YouTube, चुनिंदा वीडियो और चुनिंदा वेबसाइट की सुविधाएं बंद कर रहा है. ये सुविधाएं,
channel
संसाधन केinvideoPromotion
ऑब्जेक्ट के ज़रिए एपीआई में काम करती हैं. इस वजह से, वह ऑब्जेक्ट और उसकी सभी चाइल्ड प्रॉपर्टी अब काम नहीं करतीं.आप अब भी
invideoPromotion
का डेटा वापस पा सकते हैं और उसे 14 दिसंबर, 2017 तक सेट कर सकते हैं. YouTube TV की सदस्यता रद्द करने की तारीख के बाद:channels.list
को कॉल करते समयinvideoPromotion
वाले हिस्से को फिर से पाने की कोशिश करने पर,invideoPromotion
खाली दिखेगा याinvideoPromotion
का कोई डेटा नहीं दिखेगा.channels.update
को कॉल करते समयinvideoPromotion
का डेटा अपडेट करने की कोशिश करने पर कम से कम 27 मई, 2018 तक जवाब मिल जाएगा. हालांकि, इसे कोई कार्रवाई नहीं माना जाएगा. इसका मतलब यह है कि ये डिवाइस असल में अपडेट नहीं करेंगे.
27 मई, 2018 के बाद, ऐसा हो सकता है कि इन अनुरोधों के जवाब में गड़बड़ी के मैसेज दिखें. जैसे, यह दिखाने के लिए कि
invalidPromotion
एक अमान्य हिस्सा है.
16 नवंबर, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
इंटरैक्टिव कोड स्निपेट टूल अब Node.js कोड के सैंपल के साथ काम करता है. एपीआई के करीब-करीब सभी तरीकों, जैसे कि
channels.list
तरीके के लिए दस्तावेज़ में भी ये सैंपल देखे जा सकते हैं.पसंद के मुताबिक बनाए जा सकने वाले सैंपल, इस तरह से डिज़ाइन किए गए हैं कि आप Node.js ऐप्लिकेशन को इस्तेमाल के उदाहरण के तौर पर शुरुआत कर सकते हैं. यह सुविधा Node.js की क्विकस्टार्ट गाइड में दिए गए कोड जैसी ही है. हालांकि, सैंपल में कुछ ऐसे यूटिलिटी फ़ंक्शन होते हैं जो क्विकस्टार्ट में नहीं दिखते:
removeEmptyParameters
फ़ंक्शन, एपीआई अनुरोध के पैरामीटर से जुड़े की-वैल्यू पेयर की सूची लेता है और बिना वैल्यू वाले पैरामीटर को हटा देता है.createResource
फ़ंक्शन, किसी एपीआई रिसॉर्स में मौजूद प्रॉपर्टी से जुड़े की-वैल्यू पेयर की सूची लेता है. इसके बाद, यह प्रॉपर्टी को ऐसे JSON ऑब्जेक्ट में बदल देता है जिसका इस्तेमालinsert
औरupdate
की कार्रवाइयों में किया जा सकता है. यहां दिए गए उदाहरण में, प्रॉपर्टी के नाम और वैल्यू का सेट दिखाया गया है. साथ ही, JSON ऑब्जेक्ट भी दिखाया गया है, जो कोड कोड से बनाया जाएगा:# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
ये सभी सैंपल, डाउनलोड करने और स्थानीय तौर पर चलाने के लिए डिज़ाइन किए गए हैं. ज़्यादा जानकारी के लिए, कोड स्निपेट टूल के निर्देशों में सभी कोड सैंपल को स्थानीय तौर पर चलाने से जुड़ी ज़रूरी शर्तें देखें.
25 अक्टूबर, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
इंटरैक्टिव कोड स्निपेट टूल में Python कोड के सैंपल,
oauth2client
लाइब्रेरी के बजायgoogle-auth
औरgoogle-auth-oauthlib
लाइब्रेरी का इस्तेमाल करने के लिए अपडेट किए गए हैं. लाइब्रेरी अब काम नहीं करती.इस बदलाव के अलावा, यह टूल अब इंस्टॉल किए गए Python ऐप्लिकेशन और Python वेब सर्वर ऐप्लिकेशन के लिए पूरे कोड सैंपल उपलब्ध कराता है. ये सैंपल, अनुमति देने के थोड़े अलग तरीके का इस्तेमाल करते हैं. पूरे सैंपल (और इस बदलाव) को देखने के लिए:
- इंटरैक्टिव कोड स्निपेट टूल या एपीआई वाले किसी भी तरीके के दस्तावेज़ पर जाएं, जैसे कि
channels.list
तरीका. - कोड सैंपल के ऊपर मौजूद
Python
टैब पर क्लिक करें. - स्निपेट देखने से पूरे सैंपल पर स्विच करने के लिए, टैब के ऊपर मौजूद टॉगल पर क्लिक करें.
- टैब में अब एक पूरा कोड सैंपल दिखना चाहिए. इस सैंपल में,
InstalledAppFlow
के ऑथराइज़ेशन फ़्लो का इस्तेमाल किया जाता है. नमूने के ऊपर दिए गए विवरण में यह बताया गया है और यह वेब सर्वर ऐप्लिकेशन के नमूने के लिंक भी है. - वेब सर्वर के उदाहरण पर स्विच करने के लिए, लिंक पर क्लिक करें. वह सैंपल, फ़्लास्क वेब ऐप्लिकेशन फ़्रेमवर्क और अनुमति देने के एक अलग फ़्लो का इस्तेमाल करता है.
ये सभी सैंपल, डाउनलोड करने और स्थानीय तौर पर चलाने के लिए डिज़ाइन किए गए हैं. अगर आपको सैंपल चलाना है, तो कोड स्निपेट टूल के निर्देशों में पूरे कोड सैंपल को स्थानीय तौर पर चलाने के निर्देश देखें.
- इंटरैक्टिव कोड स्निपेट टूल या एपीआई वाले किसी भी तरीके के दस्तावेज़ पर जाएं, जैसे कि
29 अगस्त, 2017
इस अपडेट में ये बदलाव शामिल हैं:
search.list
तरीके केforContentOwner
पैरामीटर की परिभाषा को अपडेट कर दिया गया है. इससे यह पता चलेगा कि अगर उस पैरामीटर कोtrue
पर सेट किया गया है, तोtype
पैरामीटर कोvideo
पर सेट किया जाना चाहिए.search.list
तरीके केregionCode
पैरामीटर की परिभाषा को अपडेट कर दिया गया है. इससे यह साफ़ तौर पर पता चल पाएगा कि पैरामीटर, खोज के नतीजों में सिर्फ़ ऐसे वीडियो दिखाता है जिन्हें किसी खास देश/इलाके में देखा जा सकता है.- YouTube ने अपने ब्रैंडिंग लोगो और आइकॉन अपडेट कर दिए हैं. नया "YouTube की मदद से बनाया गया" लोगो ब्रैंडिंग के दिशा-निर्देशों वाले पेज से डाउनलोड किए जा सकते हैं. उस पेज पर YouTube के दूसरे नए लोगो और आइकॉन भी दिखाए जाते हैं. इन्हें YouTube ब्रैंड साइट से डाउनलोड किया जा सकता है.
24 जुलाई, 2017
इस अपडेट में ये बदलाव शामिल हैं:
- iOS के लिए, YouTube Data API की क्विकस्टार्ट गाइड उपलब्ध है. इस गाइड में YouTube Data API को इस्तेमाल करने का तरीका बताया गया है. इसे Objective-C या Swift में लिखे गए एक आसान iOS ऐप्लिकेशन में इस्तेमाल करने का तरीका बताया गया है.
- YouTube Data API के इंटरैक्टिव कोड स्निपेट टूल में, अब टूल की कुछ सुविधाओं के बारे में जानकारी देने वाला दस्तावेज़ शामिल है:
- एपीआई अनुरोधों को एक्ज़ीक्यूट किया जा रहा है
- कोड स्निपेट और पूरे कोड सैंपल के बीच टॉगल करना
- बॉयलरप्लेट फ़ंक्शन का इस्तेमाल करना
- मौजूदा संसाधन लोड हो रहे हैं (अपडेट के तरीकों के लिए)
ध्यान दें: इस टूल को, एपीआई के तरीकों के लिए, एपीआई रेफ़रंस दस्तावेज़ में भी एम्बेड किया गया है (उदाहरण).
1 जून, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
ध्यान दें: यह सुविधा बंद होने से जुड़ी सूचना है.
यहां दी गई
video
रिसॉर्स प्रॉपर्टी काम नहीं करतीं. हालांकि, प्रॉपर्टी 1 दिसंबर, 2017 तक काम करेंगी, लेकिन इस बात की कोई गारंटी नहीं है कि वीडियो उस समय तक इन प्रॉपर्टी के लिए वैल्यू दिखाना जारी रखेंगे. इसी तरह, उन प्रॉपर्टी वैल्यू को सेट करने वालेvideos.insert
औरvideos.update
अनुरोध, उस तारीख से पहले गड़बड़ियां जनरेट नहीं करेंगे. हालांकि, हो सकता है कि आने वाला डेटा सेव न हो.
17 मई, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई के रेफ़रंस दस्तावेज़ को अपडेट कर दिया गया है, ताकि कोड स्निपेट को ज़्यादा से ज़्यादा लोगों तक पहुंचाया जा सके और वे इंटरैक्टिव हो सकें. एपीआई के तरीकों के बारे में जानकारी देने वाले पेज, जैसे कि
channels.list
याvideos.rate
अब एक इंटरैक्टिव टूल की सुविधा देते हैं. इसकी मदद से, Java, JavaScript, PHP, Python, Ruby, Apps Script, और Go में कोड स्निपेट को देखा और पसंद के मुताबिक बनाया जा सकता है.किसी दिए गए तरीके के लिए, यह टूल एक या उससे ज़्यादा इस्तेमाल के उदाहरणों के लिए कोड स्निपेट दिखाता है. साथ ही, इस्तेमाल का हर उदाहरण उस तरीके को कॉल करने के सामान्य तरीके के बारे में बताता है. उदाहरण के लिए, किसी खास चैनल या मौजूदा उपयोगकर्ता के चैनल का डेटा हासिल करने के लिए,
channels.list
तरीके को कॉल किया जा सकता है.कोड सैंपल के साथ भी इंटरैक्ट किया जा सकता है:
-
पैरामीटर और प्रॉपर्टी की वैल्यू में बदलाव करते हैं. साथ ही, आपकी दी गई वैल्यू दिखाने के लिए, कोड स्निपेट डाइनैमिक तौर पर अपडेट होते हैं.
-
कोड स्निपेट और पूरे सैंपल के बीच टॉगल करें. कोड स्निपेट, एपीआई के तरीके को कॉल करने वाले कोड का हिस्सा दिखाता है. पूरे सैंपल में, अनुरोध की अनुमति देने और उसे भेजने के लिए उस स्निपेट के साथ-साथ बॉयलरप्लेट कोड भी शामिल होता है. कमांड लाइन या लोकल वेब सर्वर से, पूरे सैंपल को कॉपी करके चलाया जा सकता है.
-
एक बटन पर क्लिक करके अनुरोध लागू करें. (अनुरोधों पर कार्रवाई करने के लिए, आपको टूल को अपनी ओर से एपीआई को कॉल करने की अनुमति देनी होगी.)
ध्यान दें कि इस टूल ने उन पेजों पर API एक्सप्लोरर की जगह ले ली है जहां यह उपलब्ध है. (हर पेज एक लिंक दिखाता है, ताकि आपके पास एपीआई एक्सप्लोरर में काम करने वाले अनुरोध को लोड करने का विकल्प भी हो.)
-
-
Data API कोड स्निपेट टूल को भी एक नए यूज़र इंटरफ़ेस (यूआई) के साथ अपडेट किया गया है. इसमें ऊपर बताई गई सभी सुविधाएं मौजूद हैं. इस पेज पर उपलब्ध मुख्य नई सुविधाएं ये हैं:
- डेटा लिखने वाले एपीआई अनुरोधों के लिए सहायता.
- Java सैंपल के साथ काम करता है.
- उपयोगकर्ताओं को अनुमति देने और एपीआई अनुरोधों को बनाने के लिए, ज़्यादा सुविधाजनक और बेहतर बॉयलरप्लेट कोड.
27 अप्रैल, 2017
इस अपडेट में ये बदलाव शामिल हैं:
- नई क्विकस्टार्ट गाइड में एक आसान ऐप्लिकेशन सेट अप करने का तरीका बताया गया है, जिससे YouTube Data API के अनुरोध किए जा सकते हैं. गाइड फ़िलहाल Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python, और Ruby के लिए उपलब्ध हैं.
30 मार्च, 2017
इस अपडेट में ये बदलाव शामिल हैं:
channel
संसाधन की नईtopicDetails.topicCategories[]
प्रॉपर्टी में, Wikipedia के उन यूआरएल की सूची मौजूद है जो चैनल के कॉन्टेंट की जानकारी देते हैं. यूआरएल, संसाधन कीtopicDetails.topicIds[]
प्रॉपर्टी में दिखाए गए विषय के आईडी से जुड़े होते हैं.playlistItem
संसाधन की नईcontentDetails.videoPublishedAt
प्रॉपर्टी से यह पता चलता है कि वीडियो को YouTube पर कब से पब्लिश किया गया था. संसाधन में पहले से हीsnippet.publishedAt
प्रॉपर्टी शामिल होती है, जो प्लेलिस्ट में आइटम को जोड़े जाने के समय की जानकारी देती है.channel
संसाधन की तरह,video
संसाधन भी अबtopicDetails.topicCategories[]
प्रॉपर्टी दिखाता है. इसमें, वीडियो के कॉन्टेंट के बारे में जानकारी देने वाले Wikipedia के यूआरएल की सूची होती है.video
संसाधनों के लिए, यूआरएल, संसाधन कीtopicDetails.relevantTopicIds[]
प्रॉपर्टी में दिखाए गए विषय के आईडी के मुताबिक होते हैं.video
संसाधन की नईcontentDetails.contentRating.mpaatRating
प्रॉपर्टी, उस रेटिंग की पहचान करती है जो मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका ने किसी फ़िल्म के ट्रेलर या झलक को दी है.
27 फ़रवरी, 2017
मूल रूप से 11 अगस्त, 2016 को की गई घोषणा के मुताबिक, YouTube ने विषय आईडी की काम करने वाली सूची को क्यूरेटेड सूची पर स्विच कर दिया है. इस्तेमाल किए जा सकने वाले टॉप आईडी की पूरी सूची, channel
और video
रिसॉर्स के लिए topicDetails
प्रॉपर्टी में शामिल है. साथ ही, search.list
तरीके के topicId
पैरामीटर में भी शामिल है.
ध्यान दें कि चुनी गई सूची में कई बदलाव किए गए हैं:
- इन विषयों को
Society
के उप-विषयों के तौर पर जोड़ा गया है:नाम विषय आईडी कारोबार /m/09s1f
स्वास्थ्य /m/0kt51
सेना /m/01h6rj
राजनीति /m/05qt0
धर्म /m/06bvp
Animated cartoon
विषय को हटा दिया गया है. यह विषय पहलेEntertainment
का चाइल्ड था.Children's music
विषय को हटा दिया गया है. यह विषय पहलेMusic
का चाइल्ड था.
इस बदलाव की वजह से, किसी वीडियो से जुड़े विषय अब हमेशा video
संसाधन की topicDetails.relevantTopicIds[]
प्रॉपर्टी वैल्यू में दिखाए जाते हैं.
29 नवंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
विषय आईडी की सूची में तीन छोटे बदलाव किए गए हैं, जो 10 फ़रवरी, 2017 से काम करने लगेंगे:
Professional wrestling
कैटगरी, पहलेSports
कैटगरी की चाइल्ड कैटगरी थी. अब यहEntertainment
कैटगरी का चाइल्ड कैटगरी है.TV shows
कैटगरी, जोEntertainment
का चाइल्ड है, नई है.Health
कैटगरी को हटा दिया गया है. यह कैटगरी पहलेLifestyle
की ही चाइल्ड कैटगरी थी.
यह भी ध्यान रखें कि कुछ पैरंट कैटगरी हैं (
Entertainment
,Gaming
,Lifestyle
,Music
, औरSports
). चाइल्ड कैटगरी से जुड़ा कोई भी वीडियो, जैसे किTennis
को पैरंट कैटगरी (Sports
) के साथ जोड़ा जाएगा.
10 नवंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
जैसा कि पहली बार 11 अगस्त, 2016 को एलान किया गया था, Freebase और Freebase API को बंद करने के लिए विषय आईडी से जुड़े कई बदलाव करने होंगे. विषय आईडी,
channel
औरvideo
संसाधनों से जुड़े विषयों की पहचान करते हैं. साथ ही, किसी खास विषय से जुड़े चैनल या वीडियो ढूंढने के लिए,topicId
खोज पैरामीटर का भी इस्तेमाल किया जा सकता है.10 फ़रवरी, 2017 से YouTube, अब तक मिले आईडी के बजाय छोटे-छोटे विषय आईडी दिखाना शुरू कर देगा. साथ ही, ध्यान रखें कि इस बात की कोई गारंटी नहीं है कि चैनल और वीडियो किसी ऐसे विषय से जुड़े होंगे जो एपीआई के मौजूदा व्यवहार से मेल खाता हो.
ताकि आप अपने एपीआई क्लाइंट को उन बदलावों के लिए तैयार कर सकें. इसलिए, नीचे दिए गए एपीआई पैरामीटर और प्रॉपर्टी की परिभाषाएं अपडेट कर दी गई हैं. ऐसा उन विषय के आईडी की सूची बनाने के लिए किया गया है जो उस समय के बाद काम करेंगे. ध्यान दें कि कैटगरी की सूची सभी प्रॉपर्टी के लिए एक जैसी होती है.
channel
संसाधन कीtopicDetails.topicIds[]
प्रॉपर्टी.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[]
से, वीडियो को FPB (दक्षिण अफ़्रीका) में मिलने की वजहों का पता चलता है. -
mcstRating
का नया वर्शन, वियतनाम में वीडियो को मिली रेटिंग की पहचान करता है.
-
-
videos.list
तरीके में दो नए पैरामीटर इस्तेमाल किए जा सकते हैं,maxHeight
औरmaxWidth
.video
संसाधनों मेंplayer
वाले हिस्से को वापस पाने के लिए, पैरामीटर या दोनों पैरामीटर का इस्तेमाल किया जा सकता है.डिफ़ॉल्ट रूप से,
player.embedHtml
प्रॉपर्टी में दिखाए गए<iframe>
की ऊंचाई 360 पिक्सल होती है. वीडियो के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) के हिसाब से, चौड़ाई अडजस्ट हो जाती है. इससे यह पक्का होता है कि एम्बेड किए गए प्लेयर पर, वीडियो के चारों ओर काले रंग की पट्टियां न हों. उदाहरण के लिए, अगर किसी वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 है, तो प्लेयर की चौड़ाई 640 पिक्सल होगी.नए पैरामीटर की मदद से, यह तय किया जा सकता है कि डिफ़ॉल्ट डाइमेंशन के बजाय, एम्बेड कोड में ऐप्लिकेशन के लेआउट के लिए सही लंबाई और/या चौड़ाई का इस्तेमाल किया जाए. एपीआई सर्वर, प्लेयर के डाइमेंशन को ज़रूरत के हिसाब से स्केल करता है. इससे यह पक्का किया जाता है कि एम्बेड किए गए प्लेयर में, वीडियो के फ़्रेम में काले रंग की पट्टी न लगाई गई हो. ध्यान दें कि दोनों पैरामीटर एम्बेड किए गए प्लेयर के ज़्यादा से ज़्यादा डाइमेंशन तय करते हैं. इसलिए, अगर दोनों पैरामीटर तय किए गए हैं, तो हो सकता है कि एक डाइमेंशन उस डाइमेंशन के लिए तय की गई ज़्यादा से ज़्यादा सीमा से कम हो.
उदाहरण के लिए, मान लें कि किसी वीडियो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) 16:9 है. इस तरह, अगर
maxHeight
याmaxWidth
पैरामीटर सेट नहीं है, तोplayer.embedHtml
टैग में 640x360 का प्लेयर होगा.- अगर
maxHeight
पैरामीटर को720
पर सेट किया गया है औरmaxWidth
पैरामीटर को सेट नहीं किया गया है, तो एपीआई 1280x720 प्लेयर दिखाएगा. - अगर
maxWidth
पैरामीटर को960
पर सेट किया गया है औरmaxHeight
पैरामीटर को सेट नहीं किया गया है, तो एपीआई 960x540 प्लेयर दिखाएगा. - अगर
maxWidth
पैरामीटर960
पर औरmaxHeight
पैरामीटर450
पर सेट है, तो एपीआई 800x450 प्लेयर दिखाएगा.
ऊपर बताई गई नई
player.embedHeight
औरplayer.embedWidth
प्रॉपर्टी, प्लेयर के डाइमेंशन की पहचान करती हैं. - अगर
-
-
मौजूदा तरीकों, प्रॉपर्टी, और पैरामीटर में अपडेट
-
channelSection
संसाधन की जानकारी को अपडेट किया गया है. अब कोई चैनल, टारगेटिंग डेटा सेट किए बिना, ज़्यादा से ज़्यादा 10 शेल्फ़ बना सकता है. साथ ही, टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) डेटा की मदद से, ज़्यादा से ज़्यादा 100 शेल्फ़ बना सकता है.इसके अलावा,
channelSection
संसाधन कीtargeting
प्रॉपर्टी को अपडेट कर दिया गया है, ताकि यह बताया जा सके कि टारगेटिंग के विकल्प सिर्फ़ एपीआई का इस्तेमाल करके सेट किए जा सकते हैं. अगर चैनल सेक्शन को YouTube वेबसाइट पर यूज़र इंटरफ़ेस का इस्तेमाल करके बदला गया हो, तो टारगेटिंग के विकल्प मिटा दिए जाते हैं. -
i18nLanguage
संसाधन कीsnippet.name
प्रॉपर्टी की परिभाषा ठीक कर दी गई है, ताकि यह बताया जा सके कि वैल्यू किसी भाषा का नाम दिखाती है, जोi18nLanguage.list
तरीके केhl
पैरामीटर की मदद से बताई गई भाषा में लिखी गई है. -
playlistItem
रिसॉर्स कीcontentDetails.note
प्रॉपर्टी अपडेट की गई है, ताकि यह पता लगाया जा सके कि प्रॉपर्टी की वैल्यू, ज़्यादा से ज़्यादा 280 वर्ण तक की हो सकती है. -
playlistItem
संसाधन कीcontentDetails.startAt
औरcontentDetails.endAt
प्रॉपर्टी बंद कर दी गई हैं. अगर इन फ़ील्ड कोplaylistItems.insert
याplaylistItems.update
अनुरोधों में सेट किया गया है, तो उन्हें अनदेखा कर दिया जाता है. -
अब
playlistItems.delete
औरplaylistItems.update
तरीके,onBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. इस तरीके का इस्तेमाल करने वाले अनुरोधों को ऐसे टोकन से अनुमति देना ज़रूरी है जोhttps://www.googleapis.com/auth/youtubepartner
स्कोप का ऐक्सेस देता हो. -
search.list
तरीके केpublishedBefore
औरpublishedAfter
पैरामीटर, दोनों को अपडेट कर दिया गया है. इससे पता चलता है कि पैरामीटर की वैल्यू में शामिल किया गया है. उदाहरण के लिए, अगरpublishedBefore
पैरामीटर सेट है, तो एपीआई तय समय से या उस समय तक बनाए गए संसाधन दिखाता है. -
video
संसाधन कीcontentDetails.contentRating.grfilmRating
प्रॉपर्टी तीन अतिरिक्त वैल्यू के साथ काम करती है:grfilmK12
,grfilmK15
, औरgrfilmK18
. -
videos.insert
तरीके की जानकारी को अपडेट कर दिया गया है. इसमें यह जानकारी दी गई है कि अपलोड किए गए वीडियो की फ़ाइल का साइज़, 64 जीबी से बढ़ाकर 128 जीबी कर दिया गया है.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई में नीचे दी गई नई गड़बड़ियां शामिल हैं:
गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा forbidden (403)
homeParameterDeprecated
activities.list
तरीका, यह गड़बड़ी बताता है कि इस एपीआई से उपयोगकर्ता के होम पेज पर की गई गतिविधि का डेटा उपलब्ध नहीं है. यह गड़बड़ी तब हो सकती है, जब बिना अनुमति के किसी अनुरोध मेंhome
पैरामीटर कोtrue
पर सेट किया गया हो.invalidValue (400)
invalidContentDetails
playlistItems.insert
तरीका, गड़बड़ी के मैसेज के तौर पर यह दिखाता है कि अनुरोध में मौजूदcontentDetails
ऑब्जेक्ट अमान्य है. इस गड़बड़ी की एक वजह यह भी है किcontentDetails.note
फ़ील्ड में 280 से ज़्यादा वर्ण होते हैं.forbidden (403)
watchHistoryNotAccessible
playlistItems.list
तरीका, गड़बड़ी का यह मैसेज दिखाता है, ताकि यह पता चल सके कि अनुरोध में "देखने का इतिहास" को वापस पाने की कोशिश की गई है प्लेलिस्ट आइटम, लेकिन उन्हें एपीआई का इस्तेमाल करके वापस नहीं पाया जा सकता.forbidden (403)
watchLaterNotAccessible
playlistItems.list
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि अनुरोध में, "बाद में देखें" को वापस पाने की कोशिश की गई है प्लेलिस्ट आइटम, लेकिन उन्हें एपीआई का इस्तेमाल करके वापस नहीं पाया जा सकता.badRequest (400)
uploadLimitExceeded
videos.insert
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि चैनल ने, अपलोड किए जा सकने वाले वीडियो की संख्या पार कर ली है.forbidden (403)
forbiddenEmbedSetting
videos.update
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि एपीआई अनुरोध, वीडियो को जोड़ने की गलत सेटिंग सेट करने की कोशिश कर रहा है. ध्यान दें कि ऐसा हो सकता है कि कुछ चैनलों को लाइव स्ट्रीम के लिए, एम्बेड किए गए प्लेयर उपलब्ध कराने की अनुमति न हो. ज़्यादा जानकारी के लिए, YouTube के सहायता केंद्र पर जाएं. -
प्लेलिस्ट में डुप्लीकेट वीडियो डालने पर,
playlistItems.insert
तरीका अब गड़बड़ी नहीं दिखाएगा. यह गड़बड़ी पहले पसंदीदा वीडियो जैसी कुछ ऐसी प्लेलिस्ट के लिए हुई थी, जिन्होंने डुप्लीकेट की अनुमति नहीं दी थी, लेकिन अब काम नहीं करती हैं. आम तौर पर, प्लेलिस्ट में डुप्लीकेट वीडियो शामिल किए जा सकते हैं.
-
-
अन्य अपडेट
-
15 सितंबर, 2016 के बदलावों के इतिहास की एंट्री को यह बताने के लिए अपडेट किया गया है कि जब भी किसी रिस्पॉन्स में
channel
संसाधन कीcontentDetails.relatedPlaylists.watchHistory
औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी को शामिल किया जाता है, तब उनमें हमेशाHL
औरWL
की वैल्यू शामिल होती हैं. इसके अलावा, उन प्रॉपर्टी को सिर्फ़ तब शामिल किया जाता है, जब अनुमति वाला कोई उपयोगकर्ता, उपयोगकर्ता के चैनल का डेटा हासिल कर रहा हो.
-
15 सितंबर, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
11 अगस्त, 2016 को हुए बदलावों के इतिहास से जुड़े अपडेट में, विषय आईडी से जुड़े कई बदलावों पर चर्चा की गई है. इसमें यह जानकारी भी शामिल है कि 10 फ़रवरी, 2017 से काम करने वाले विषय आईडी के सेट में बदलाव होगा. समर्थित किए जाने वाले विषयों की सूची 10 नवंबर, 2016 तक प्रकाशित की जाएगी.
-
ये बदलाव अब लागू हैं. 11 अगस्त, 2016 को बदलावों के इतिहास में हुए अपडेट में, इन बदलावों की सूचना दी गई थी:
-
अगर
activities.list
तरीके कोhome
पैरामीटर कोtrue
पर सेट करके कॉल किया जाता है, तो एपीआई से मिले रिस्पॉन्स में अब ऐसे आइटम शामिल होंगे जो लॉग आउट किए गए YouTube उपयोगकर्ता को होम पेज पर दिखेंगे.यह एक छोटा सा बदलाव है, जिसका मकसद 11 अगस्त, 2016 को किए गए बदलावों के इतिहास में बताए गए व्यवहार से बेहतर उपयोगकर्ता अनुभव देना है. उस अपडेट में बताया गया था कि
home
पैरामीटर का इस्तेमाल करने पर, खाली सूची मिलेगी. -
channel
संसाधन कीcontentDetails.relatedPlaylists.watchHistory
औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी में, सभी चैनलों के लिए अबHL
औरWL
की वैल्यू शामिल हैं.साफ़ तौर पर बता दें कि ये प्रॉपर्टी सिर्फ़ उस उपयोगकर्ता को दिखती हैं जिसके पास अनुमति है. यह उपयोगकर्ता के चैनल का डेटा हासिल कर रहा है. प्रॉपर्टी में हमेशा
HL
औरWL
वैल्यू होती हैं. ऐसा तब भी होता है, जब कोई उपयोगकर्ता, उपयोगकर्ता के चैनल का डेटा हासिल कर रहा हो. इसलिए, देखने का इतिहास और बाद में देखने की सुविधा वाली प्लेलिस्ट के आईडी, एपीआई के ज़रिए वापस नहीं पाए जा सकते.साथ ही, किसी चैनल के 'देखने का इतिहास' या 'बाद में देखें' प्लेलिस्ट से जुड़ी प्लेलिस्ट की जानकारी (
playlists.list
) या प्लेलिस्ट में मौजूद आइटम (playlistItems.list
) पाने के अनुरोध में अब खाली सूचियां दिखती हैं. ऐसा, नई वैल्यूHL
औरWL
के साथ-साथ, वीडियो देखने के इतिहास या 'बाद में देखें' प्लेलिस्ट के ऐसे आईडी के लिए भी सही है जिन्हें आपके एपीआई क्लाइंट ने पहले से सेव किया हो.
-
-
video
संसाधन काfileDetails.recordingLocation
ऑब्जेक्ट और उसकी चाइल्ड प्रॉपर्टी अब नहीं दिखाई जाती हैं. पहले, इस डेटा (जैसे कि पैरंटfileDetails
ऑब्जेक्ट) को सिर्फ़ वीडियो का मालिक ही वापस ला सकता था.
11 अगस्त, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
हाल ही में पब्लिश की गई YouTube API सेवाओं की सेवा की शर्तें ("अपडेट की गई शर्तें"), जिनके बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर ज़्यादा जानकारी दी गई है. इनसे, सेवा की मौजूदा शर्तों को बेहतर तरीके से अपडेट करने में मदद मिलती है. 10 फ़रवरी, 2017 से लागू होने वाली अपडेट की गई शर्तों के अलावा, इस अपडेट में कई मददगार दस्तावेज़ शामिल हैं. इनसे डेवलपर को उन नीतियों की जानकारी देने में मदद मिलेगी जिनका पालन करना ज़रूरी है.
नए दस्तावेज़ों के पूरे सेट के बारे में अपडेट की गई शर्तों के बदलाव के इतिहास में बताया गया है. इसके अलावा, अपडेट की गई शर्तों या सहायक दस्तावेज़ों में आने वाले समय में होने वाले बदलावों की जानकारी भी बदलावों के इतिहास में दिखेगी. आप उस दस्तावेज़ में दिए लिंक से उस बदलाव के इतिहास में आरएसएस फ़ीड की लिस्टिंग में होने वाले बदलावों की सदस्यता ले सकते हैं.
-
Freebase और Freebase API के बंद होने की वजह से विषय आईडी से जुड़े कई बदलाव हो रहे हैं. विषय के आईडी का इस्तेमाल, एपीआई के इन संसाधनों और तरीकों में किया जाता है:
channel
संसाधन केtopicDetails
वाला हिस्सा, चैनल से जुड़े विषयों की पहचान करता है.video
संसाधन केtopicDetails
वाला हिस्सा, वीडियो से जुड़े विषयों की पहचान करता है.search.list
तरीके केtopicId
पैरामीटर की मदद से, किसी खास विषय से जुड़े वीडियो या चैनल खोजे जा सकते हैं.
इन सुविधाओं में ये बदलाव हुए हैं:
-
10 फ़रवरी, 2017 से YouTube, अब तक मिले आईडी के बजाय छोटे-छोटे विषय आईडी दिखाना शुरू कर देगा. इस्तेमाल किए जा सकने वाले विषयों का सेट, खेल-कूद या बास्केटबॉल जैसे हाई-लेवल कैटगरी की पहचान करेगा, लेकिन उदाहरण के लिए, वह किसी टीम या खिलाड़ी की पहचान नहीं करेगा. हम इस्तेमाल किए जा सकने वाले विषयों का एलान करेंगे, ताकि आपके पास इस बदलाव के लिए आवेदन करने के लिए समय हो.
-
आपके पास पहले से मिले किसी भी Freebase विषय आईडी का इस्तेमाल करके 10 फ़रवरी, 2017 तक कॉन्टेंट खोजने का विकल्प है. हालांकि, इसके बाद, पिछले आइटम में पहचाने गए विषयों के छोटे सेट का ही इस्तेमाल किया जा सकेगा. इससे विषय के हिसाब से खोज के नतीजे दिखाए जा सकेंगे.
-
अगर 10 फ़रवरी, 2017 के बाद, किसी ऐसे विषय आईडी का इस्तेमाल करके नतीजे खोजने की कोशिश की जाती है जो काम करने वाले विषय आईडी के छोटे सेट में नहीं है, तो एपीआई नतीजे के खाली सेट दिखाएगा.
-
12 सितंबर, 2016 से कई एपीआई फ़ील्ड और पैरामीटर का इस्तेमाल बंद कर दिया जाएगा:
-
activities.list
तरीके केhome
पैरामीटर की मदद से, उपयोगकर्ता के पास गतिविधि फ़ीड को फिर से पाने की अनुमति होती है. यह फ़ीड, उस उपयोगकर्ता के YouTube होम पेज पर दिखता है. 12 सितंबर, 2016 के बाद, इस पैरामीटर का इस्तेमाल करने वाले अनुरोधों की सूची खाली दिखेगी. -
channel
संसाधन कीcontentDetails.relatedPlaylists.watchHistory
औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टी सिर्फ़ उस उपयोगकर्ता को दिखती हैं जिसके पास अनुमति है. यह उपयोगकर्ता के चैनल का डेटा हासिल कर रहा है. सभी चैनलों के लिए 12 सितंबर, 2016 के बाद,contentDetails.relatedPlaylists.watchHistory
की वैल्यूHL
है औरcontentDetails.relatedPlaylists.watchLater
प्रॉपर्टीWL
की वैल्यू दिखाएगी.किसी चैनल के 'देखने के इतिहास' या 'बाद में देखें' प्लेलिस्ट से जुड़ी, प्लेलिस्ट की जानकारी (
playlists.list
) वापस पाने के अनुरोध में 12 सितंबर, 2016 के बाद, एक खाली सूची दिखेगी. इनमें से किसी भी प्लेलिस्ट से, प्लेलिस्ट के आइटम (playlistItems.list
) वापस पाने का अनुरोध करने पर, एक खाली सूची भी दिखेगी. यह नई वैल्यू,HL
औरWL
के साथ-साथ, वीडियो देखने के इतिहास या 'बाद में देखें' प्लेलिस्ट के उन आईडी के लिए भी सही है जिन्हें आपके एपीआई क्लाइंट ने पहले से सेव किया है. -
video
संसाधन काfileDetails.recordingLocation
ऑब्जेक्ट या उसकी कोई भी चाइल्ड प्रॉपर्टी, 12 सितंबर, 2016 के बाद नहीं दिखेगी. इस डेटा को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है, क्योंकि पैरंटfileDetails
ऑब्जेक्ट को सिर्फ़ वीडियो का मालिक ही वापस ला सकता है.
-
13 जून, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन कीcontentDetails.googlePlusUserId
प्रॉपर्टी बंद कर दी गई है. पहले, यह प्रॉपर्टी सिर्फ़ तब मौजूद होती थी, जब चैनल किसी Google+ प्रोफ़ाइल से जुड़ा होता था. बंद होने के बाद इस प्रॉपर्टी को किसी भीchannel
संसाधन में शामिल नहीं किया जाएगा. -
comment
संसाधन कीsnippet.authorGoogleplusProfileUrl
प्रॉपर्टी बंद कर दी गई है. पहले, यह प्रॉपर्टी सिर्फ़ तब मौजूद होती थी, जब चैनल किसी Google+ प्रोफ़ाइल से जुड़ा होता था. बंद होने के बाद इस प्रॉपर्टी को किसी भीcomment
संसाधन में शामिल नहीं किया जाएगा.
बंद होने के बाद, इनमें से कोई भी प्रॉपर्टी नहीं दिखेगी. इसलिए, दोनों प्रॉपर्टी को संबंधित संसाधन दस्तावेज़ से हटा दिया गया है.
31 मई, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
subscriptions.list
तरीके का नयाmyRecentSubscribers
पैरामीटर, पुष्टि किए गए उपयोगकर्ता के चैनल के सदस्यों की सूची को उस समय के उलटे क्रम में दिखाता है जब उन्होंने चैनल की सदस्यता ली थी.ध्यान दें कि नया पैरामीटर सिर्फ़ पुष्टि किए गए उपयोगकर्ता के चैनल पर, सबसे हाल के 1,000 सदस्यों को वापस लाने का काम करता है. सदस्यों की पूरी सूची पाने के लिए,
mySubscribers
पैरामीटर का इस्तेमाल करें. वह पैरामीटर, जो किसी खास क्रम में सदस्य नहीं दिखाता, वापस पाने के लिए सदस्यों की संख्या को सीमित नहीं करता. -
गतिविधि, playlistItem, playlist, खोज के नतीजे, थंबनेल, और वीडियो संसाधनों के लिए
snippet.thumbnails.(key)
प्रॉपर्टी की परिभाषा अपडेट की गई है, ताकि यह पता चल सके कि कुछ वीडियो के लिए थंबनेल इमेज के अलग-अलग साइज़ उपलब्ध हैं.standard
इमेज की चौड़ाई 640 पिक्सल और ऊंचाई 480 पिक्सल है.maxres
इमेज की चौड़ाई 1280 पिक्सल और ऊंचाई 720 पिक्सल है.
-
channelSection.list
तरीके केpart
पैरामीटर की परिभाषा को अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि यह पता लगाया जा सके किtargeting
वाला हिस्सा,2
कोटा यूनिट की लागत पर वापस लाया जा सकता है. -
जब गलत तरीके से अनुमति वाला कोई अनुरोध,
video
संसाधन केfileDetails
,processingDetails
याsuggestions
हिस्से को वापस पाने की कोशिश करता है, तोvideos.list
तरीका अब पाबंदी (403
) गड़बड़ी दिखाता है. ऐसे हिस्से सिर्फ़ वीडियो का मालिक देख सकता है.
17 मई, 2016
नया Data API कोड स्निपेट टूल, YouTube Data API के सामान्य इस्तेमाल के उदाहरणों के लिए शॉर्ट कोड स्निपेट उपलब्ध कराता है. फ़िलहाल, Apps Script, Go, JavaScript, PHP, Python, और Ruby में सभी रीड-ओनली एपीआई तरीकों के लिए कोड स्निपेट उपलब्ध हैं.
हर तरीके के लिए, यह टूल एक या एक से ज़्यादा इस्तेमाल के उदाहरणों के लिए कोड सैंपल दिखाता है. उदाहरण के लिए, यह search.list
तरीके के लिए पांच कोड स्निपेट उपलब्ध कराता है:
- कीवर्ड के हिसाब से वीडियो की सूची बनाएं
- जगह के हिसाब से वीडियो की सूची बनाएं
- लाइव इवेंट की सूची बनाना
- उस उपयोगकर्ता के वीडियो खोजें जिसकी पुष्टि हो चुकी है
- मिलते-जुलते वीडियो की सूची बनाएं
यह टूल, इस्तेमाल के हर उदाहरण के लिए एपीआई अनुरोध में इस्तेमाल किए गए पैरामीटर दिखाता है. पैरामीटर की वैल्यू में बदलाव किया जा सकता है. ऐसा करने पर, टूल आपकी दी गई पैरामीटर वैल्यू को दिखाने के लिए, कोड स्निपेट को अपडेट करता है.
आखिर में, यह टूल हर अनुरोध के लिए एपीआई का रिस्पॉन्स दिखाता है. अगर आपने अनुरोध के पैरामीटर में बदलाव किया है, तो एपीआई से मिले रिस्पॉन्स, आपकी दी गई पैरामीटर वैल्यू पर आधारित होते हैं. ध्यान दें कि एपीआई से मिले जवाब दिखाने के लिए, आपको टूल को अपनी ओर से अनुरोध सबमिट करने की अनुमति देनी होगी.
28 अप्रैल, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
video
संसाधन की नईcontentDetails.projection
प्रॉपर्टी, वीडियो के प्रोजेक्शन फ़ॉर्मैट की जानकारी देती है. प्रॉपर्टी की मान्य वैल्यू360
औरrectangular
हैं. -
video
संसाधन कीrecordingDetails.location
औरfileDetails.recordingLocation
प्रॉपर्टी, दोनों को अपडेट किया गया है, ताकि इन दोनों प्रॉपर्टी के बीच अंतर बताया जा सके:recordingDetails.location
प्रॉपर्टी उस जगह की पहचान करती है जिसे वीडियो का मालिक वीडियो के साथ जोड़ना चाहता है. इस जगह की जानकारी में बदलाव किया जा सकता है और इसे सार्वजनिक वीडियो पर खोजा जा सकता है. साथ ही, सार्वजनिक वीडियो के लिए यह जगह उपयोगकर्ताओं को दिखाई जा सकती है.fileDetails.recordingLocation
प्रॉपर्टी की वैल्यू में बदलाव नहीं किया जा सकता. साथ ही, यह अपलोड की गई ओरिजनल वीडियो फ़ाइल से जुड़ी जगह की जानकारी देती है. यह वैल्यू सिर्फ़ वीडियो के मालिक को दिखती है.
-
channel
संसाधन कीcontentDetails.relatedPlaylists.favorites
प्रॉपर्टी की परिभाषा को अपडेट कर दिया गया है. इससे यह पता लगाया जा सकता है कि प्रॉपर्टी की वैल्यू में, ऐसा प्लेलिस्ट आईडी हो सकता है जो खाली प्लेलिस्ट के बारे में बताता हो और जिसे फ़ेच न किया जा सके. इसकी वजह यह है कि पसंदीदा वीडियो की सुविधा पहले ही बंद कर दी गई है. ध्यान दें कि इस प्रॉपर्टी पर, एपीआई को बंद करने से जुड़ी नीति लागू नहीं होती. -
ineligibleAccount
गड़बड़ी की परिभाषा को अपडेट किया गया है. इसेcomments.insert
,comments.update
,commentThreads.insert
याcommentThreads.update
तरीके से दिखाया जा सकता है. अपडेट करके यह बताया गया है कि गड़बड़ी तब होती है, जब एपीआई अनुरोध की अनुमति देने के लिए इस्तेमाल किए गए YouTube खाते को, उपयोगकर्ता के Google खाते के साथ मर्ज नहीं किया जाता.
20 अप्रैल, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
channels.update
तरीके केpart
पैरामीटर की परिभाषा को अपडेट कर दिया गया है. इससे यह पता चलता है कि उस पैरामीटर के लिएlocalizations
भी एक मान्य वैल्यू है. -
शुरुआती निर्देश के कोटा का इस्तेमाल सेक्शन को Google Developer के Console से लिंक करने के लिए अपडेट कर दिया गया है. यहां आप अपने असल कोटा और कोटा के इस्तेमाल की जानकारी देख सकते हैं.
16 मार्च, 2016
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों में बदलाव
-
channelBanner
के संसाधन दस्तावेज़ को अपडेट किया गया है. इसमें यह जानकारी दी गई है कि चैनल की बैनर इमेज का सुझाया गया साइज़, 2560 पिक्सल x 1440 पिक्सल है. कम से कम साइज़ (2048 पिक्सल x 1152 पिक्सल) में कोई बदलाव नहीं हुआ है. -
channel
संसाधन की नईsnippet.customUrl
प्रॉपर्टी, चैनल से जुड़े कस्टम यूआरएल की पहचान करती है. (सभी चैनलों के कस्टम यूआरएल नहीं होते.) YouTube सहायता केंद्र पर कस्टम यूआरएल पाने की ज़रूरी शर्तों के साथ-साथ, यूआरएल सेट अप करने का तरीका भी बताया गया है. -
channel
रिसॉर्स केbrandingSettings.watch
ऑब्जेक्ट और इसकी सभी चाइल्ड प्रॉपर्टी को हटा दिया गया है. -
search.list
अनुरोध के एपीआई रिस्पॉन्स में अब एकregionCode
प्रॉपर्टी शामिल है. यह प्रॉपर्टी, क्षेत्र के उस कोड की पहचान करती है जिसका इस्तेमाल खोज क्वेरी के लिए किया गया था. इलाके का कोड, एपीआई को चुने गए देश के लिए खोज के नतीजे दिखाने का निर्देश देता है.प्रॉपर्टी की वैल्यू, देश का दो अक्षरों वाला आईएसओ कोड है, जिससे क्षेत्र की पहचान की जाती है.
i18nRegions.list
तरीका, इस्तेमाल किए जा सकने वाले इलाकों की सूची दिखाता है. डिफ़ॉल्ट वैल्यूUS
है. अगर आपने ऐसा क्षेत्र चुना है जहां यह सुविधा उपलब्ध नहीं है, तो YouTube क्वेरी को हैंडल करने के लिए, डिफ़ॉल्ट वैल्यू के बजाय कोई दूसरा क्षेत्र चुन सकता है. -
videoAbuseReportReason
संसाधन कीsnippet.label
औरsnippet.secondaryReasons[].label
प्रॉपर्टी की परिभाषाएं अपडेट कर दी गई हैं. ऐसा इसलिए किया गया है, ताकि प्रॉपर्टी के गलत इस्तेमाल की शिकायत करने के लिए, स्थानीय भाषा के अनुसार लेबल टेक्स्ट का इस्तेमाल किया जा सके.इसके अलावा,
videoAbuseReportReasons.list
तरीका अबhl
पैरामीटर के साथ काम करता है. इससे यह तय होता है कि एपीआई के रिस्पॉन्स में, लेबल टेक्स्ट के लिए किस भाषा का इस्तेमाल किया जाना चाहिए. पैरामीटर की डिफ़ॉल्ट वैल्यूen_US
है. -
video
संसाधन की नईcontentDetails.contentRating.ecbmctRating
प्रॉपर्टी, एक वीडियो की रेटिंग की पहचान करती है. यह रेटिंग, संस्कृति और पर्यटन मंत्रालय के तुर्किये के इवैलुएशन ऐंड क्लासिफ़िकेशन बोर्ड से मिली है.इसके अलावा, अन्य रेटिंग सिस्टम के लिए एपीआई की प्रॉपर्टी में, प्रॉपर्टी की इन नई वैल्यू का इस्तेमाल किया जा सकता है:
contentDetails.contentRating.fpbRating
(दक्षिण अफ़्रीका)
रेटिंग: 10; प्रॉपर्टी की वैल्यू:fpb10
contentDetails.contentRating.moctwRating
(ताइवान)
रेटिंग: R-12; प्रॉपर्टी की वैल्यू:moctwR12
contentDetails.contentRating.moctwRating
(ताइवान)
रेटिंग: R-15; प्रॉपर्टी की वैल्यू:moctwR15
-
video
संसाधन कीliveStreamingDetails.activeLiveChatId
प्रॉपर्टी में, वीडियो से जुड़ी चालू लाइव चैट का आईडी शामिल होता है. प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब वीडियो मौजूदा लाइव ब्रॉडकास्ट हो, जिसमें लाइव चैट की सुविधा चालू हो. ब्रॉडकास्ट खत्म होने और लाइव चैट खत्म होने के बाद, वीडियो प्रॉपर्टी को इसमें वापस नहीं लाया जा सकता. -
video
संसाधन कीstatus.rejectionReason
प्रॉपर्टी, नई प्रॉपर्टी की वैल्यूlegal
के साथ काम करती है.
-
-
एपीआई में नीचे दी गई नई गड़बड़ियां शामिल हैं:
गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest (400)
notEditable
channelSections.insert
,channelSections.update
, औरchannelSections.delete
तरीके यह गड़बड़ी दिखाते हैं कि चैनल के बताए गए सेक्शन को बनाया, अपडेट नहीं किया जा सकता, और न ही मिटाया जा सकता है.badRequest (400)
styleRequired
channelSections.insert
औरchannelSections.update
तरीके इस गड़बड़ी को दिखाते हैं. इससे पता चलता है कि एपीआई अनुरोध में सबमिट किए गएchannelSection
संसाधन कोsnippet.style
प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.badRequest (400)
typeRequired
channelSections.insert
औरchannelSections.update
तरीके इस गड़बड़ी को दिखाते हैं. इससे पता चलता है कि एपीआई अनुरोध में सबमिट किए गएchannelSection
संसाधन कोsnippet.type
प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.badRequest (400)
processingFailure
commentThreads.list
तरीका, यह गड़बड़ी दिखाता है. इससे पता चलता है कि एपीआई सर्वर, अनुरोध को प्रोसेस नहीं कर सका. यह गड़बड़ी कुछ समय के लिए हो सकती है, लेकिन आम तौर पर इससे पता चलता है कि अनुरोध का इनपुट अमान्य है. अनुरोध के मुख्य हिस्से में जाकर,commentThread
संसाधन की जांच करें. इससे यह पक्का किया जा सकेगा कि यह संसाधन मान्य है या नहीं.forbidden (403)
commentsDisabled
commentThreads.list
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है किvideoId
पैरामीटर से पहचाने गए वीडियो के लिए, टिप्पणियों की सुविधा बंद कर दी गई है.badRequest (400)
commentTextTooLong
commentThreads.insert
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि जोcomment
संसाधन शामिल किया जा रहा है उसकीsnippet.topLevelComment.snippet.textOriginal
प्रॉपर्टी में बहुत ज़्यादा वर्ण हैं.invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
playlistItems.insert
तरीका, गड़बड़ी का यह मैसेज दिखाता है कि प्लेलिस्ट में जो वीडियो जोड़ना है वह पहले से ही किसी दूसरी सीरीज़ प्लेलिस्ट में मौजूद है. सीरीज़ प्लेलिस्ट के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.badRequest (400)
subscriptionForbidden
subscriptions.insert
तरीका, इस गड़बड़ी को दिखाता है. इससे यह पता चलता है कि आपकी सदस्यता लेने की तय सीमा पूरी हो चुकी है या आपने हाल ही में बहुत सारी सदस्यताएं बनाई हैं. बाद वाले मामले में, कुछ घंटों बाद फिर से अनुरोध किया जा सकता है.badRequest (400)
invalidCategoryId
videos.update
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि अपलोड किए गएvideo
संसाधन में मौजूदsnippet.categoryId
प्रॉपर्टी के लिए, कैटगरी आईडी अमान्य है. इस्तेमाल की जा सकने वाली कैटगरी को वापस पाने के लिए,videoCategories.list
तरीके का इस्तेमाल करें.badRequest (400)
invalidDescription
videos.update
वाला तरीका यह बताने के लिए गड़बड़ी दिखाता है कि अपलोड किए गएvideo
संसाधन कीsnippet.description
प्रॉपर्टी में अमान्य वैल्यू दी गई है.badRequest (400)
invalidPublishAt
videos.update
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि अपलोड किए गएvideo
संसाधन में मौजूदstatus.publishAt
प्रॉपर्टी ने, पब्लिश करने के लिए जो समय तय किया है वह अमान्य है.badRequest (400)
invalidRecordingDetails
videos.update
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि अपलोड किए गएvideo
संसाधन में मौजूदrecordingDetails
ऑब्जेक्ट में, रिकॉर्डिंग की गलत जानकारी शामिल है.badRequest (400)
invalidTags
videos.update
वाला तरीका यह बताने के लिए गड़बड़ी दिखाता है कि अपलोड किए गएvideo
संसाधन कीsnippet.tags
प्रॉपर्टी में अमान्य वैल्यू दी गई है.badRequest (400)
invalidTitle
videos.update
तरीका, गड़बड़ी का यह मैसेज दिखाता है. इससे पता चलता है कि अपलोड किए गएvideo
संसाधन में मौजूदsnippet.title
प्रॉपर्टी के लिए, वीडियो का टाइटल अमान्य है या खाली है.badRequest (400)
invalidVideoMetadata
videos.update
तरीका, यह गड़बड़ी दिखाने के लिए गड़बड़ी दिखाता है. इससे पता चलता है कि अनुरोध का मेटाडेटा अमान्य है. गड़बड़ी का यह मैसेज तब दिखता है, जब अनुरोध की वजह सेvideo
रिसॉर्स केsnippet
वाले हिस्से को अपडेट किया जाता है, लेकिनsnippet.title
औरsnippet.categoryId
, दोनों प्रॉपर्टी के लिए कोई वैल्यू सेट नहीं की जाती है.
18 दिसंबर, 2015
यूरोपीय संघ (ईयू) के कानूनों के मुताबिक, यह ज़रूरी है कि ईयू में रहने वाले असली उपयोगकर्ताओं को कुछ जानकारी दी जानी चाहिए. साथ ही, उनसे सहमति ली जानी चाहिए. इसलिए, यूरोपीय संघ के असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने YouTube API की सेवा की शर्तों में इस ज़रूरी शर्त के बारे में एक सूचना जोड़ी है.
19 नवंबर, 2015
एपीआई अब playlist
और video
संसाधनों की snippet.title
और snippet.description
प्रॉपर्टी, channelSection
संसाधन की snippet.title
प्रॉपर्टी, और channel
संसाधन की snippet.description
प्रॉपर्टी के लिए स्थानीय भाषा के मुताबिक टेक्स्ट सेट और वापस पाने की सुविधा देता है.
-
स्थानीय भाषा में टाइटल और ब्यौरे सेट करना
किसी संसाधन के लिए
insert
याupdate
तरीके को कॉल करते समय, उस संसाधन के लिए स्थानीय भाषा में वैल्यू सेट की जा सकती है. अगर आपको किसी संसाधन के लिए स्थानीय भाषा में वैल्यू सेट करनी है, तो ये दोनों काम करें:-
पक्का करें कि संसाधन की
snippet.defaultLanguage
प्रॉपर्टी के लिए कोई वैल्यू सेट की गई हो. वह प्रॉपर्टी, संसाधन कीsnippet.title
औरsnippet.description
प्रॉपर्टी की भाषा की पहचान करती है. इसका मान कोई भी समर्थित ऐप्लिकेशन भाषा या ज़्यादातर अन्य ISO 639-1:2002 भाषा कोड हो सकते हैं. उदाहरण के लिए, अगर आपने कोई ऐसा वीडियो अपलोड किया है जिसका टाइटल और ब्यौरा अंग्रेज़ी में है, तो आपकोsnippet.defaultLanguage
प्रॉपर्टी कोen
पर सेट करना होगा.channel
के संसाधनों को अपडेट करने के बारे में ज़रूरी जानकारी: अगरchannel
संसाधन के लिएsnippet.defaultLanguage
प्रॉपर्टी सेट करनी है, तो आपकोbrandingSettings.channel.defaultLanguage
प्रॉपर्टी अपडेट करनी होगी. -
अपडेट किए जा रहे संसाधन में
localizations
ऑब्जेक्ट जोड़ें. हर ऑब्जेक्ट कुंजी एक ऐसी स्ट्रिंग है जो ऐप्लिकेशन की किसी भाषा या ISO 639-1:2002 भाषा कोड की पहचान करती है. साथ ही, हर कुंजी किसी ऐसे ऑब्जेक्ट से मैप करती है जिसमें संसाधन का स्थानीय शीर्षक (और ब्यौरा) शामिल होता है.नीचे दिया गया सैंपल स्निपेट, संसाधन की डिफ़ॉल्ट भाषा को अंग्रेज़ी पर सेट करता है. साथ ही, किसी वीडियो में स्थानीय भाषा में जर्मन और स्पैनिश भाषा के टाइटल और ब्यौरे भी जोड़े जाते हैं:
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
अहम जानकारी: याद रखें कि जब किसी संसाधन के लिए स्थानीय भाषा के मुताबिक डेटा अपडेट किया जाता है, तो एपीआई अनुरोध में डेटा के सभी मौजूदा स्थानीय वर्शन शामिल होने चाहिए. उदाहरण के लिए, अगर आपने ऊपर दिए गए उदाहरण में, वीडियो में पॉर्चुगीज़ डेटा जोड़ने के लिए बाद में कोई अनुरोध भेजा है, तो अनुरोध में जर्मन, स्पैनिश, और पॉर्चगीज़ के लिए, स्थानीय भाषा में डेटा शामिल करना होगा.
-
-
स्थानीय भाषा में वैल्यू फिर से पाना
किसी संसाधन के लिए, स्थानीय भाषा में वैल्यू वापस पाने के लिए, एपीआई दो तरीकों का इस्तेमाल करता है:
-
अपने
channels.list
,channelSections.list
,playlists.list
याvideos.list
अनुरोध मेंhl
पैरामीटर जोड़ें. इससे YouTube की वेबसाइट पर काम करने वाली किसी खास ऐप्लिकेशन भाषा का स्थानीय भाषा में डेटा वापस पाया जा सकता है. अगर स्थानीय भाषा में उपलब्ध संसाधन की जानकारी उस भाषा में उपलब्ध है, तो संसाधन केsnippet.localized
ऑब्जेक्ट में स्थानीय जगह के मुताबिक वैल्यू शामिल होंगी. हालांकि, अगर स्थानीय भाषा में जानकारी उपलब्ध नहीं है, तोsnippet.localized
ऑब्जेक्ट में संसाधन की डिफ़ॉल्ट भाषा में जानकारी शामिल होगी.उदाहरण के लिए, मान लें कि
videos.list
अनुरोध ने ऊपर बताए गए वीडियो का डेटा और स्थानीय भाषा में जर्मन और स्पैनिश भाषा में डेटा हासिल किया. अगरhl
पैरामीटर कोde
पर सेट किया जाता, तो संसाधन में यह डेटा शामिल होगा:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
हालांकि, अगर
hl
पैरामीटर कोfr
पर सेट किया जाता है, तोsnippet.localized
ऑब्जेक्ट में अंग्रेज़ी का टाइटल और ब्यौरा शामिल होगा, क्योंकि इस संसाधन की डिफ़ॉल्ट भाषा अंग्रेज़ी है और फ़्रेंच भाषा की जानकारी उपलब्ध नहीं है.अहम जानकारी:hl
पैरामीटर सिर्फ़ उन वैल्यू के साथ काम करता है जो ऐप्लिकेशन की उन भाषाओं की पहचान करती हैं जो YouTube की वेबसाइट पर काम करती हैं. यह तय करने के लिए कि स्थानीय भाषा में लिखा गया टेक्स्ट अन्य भाषाओं में उपलब्ध है या नहीं, आपको संसाधन और फ़िल्टर केlocalizations
वाले हिस्से को फिर से हासिल करना होगा. इससे यह पता चल पाएगा कि स्थानीय भाषा में लिखा गया टेक्स्ट मौजूद है या नहीं.
उदाहरण के लिए, आपको स्थानीय भाषा के अनुसार लिखे गए टेक्स्ट की पूरी सूची फिर से हासिल करनी होगी, ताकि यह पता लगाया जा सके कि स्थानीय भाषा में लिखा गया टेक्स्ट ऐपलेशन अंग्रेज़ी में उपलब्ध है या नहीं.
-
किसी संसाधन को पाने के दौरान,
part
पैरामीटर की वैल्यू मेंlocalizations
को शामिल करें. ऐसा करने से, उस संसाधन की स्थानीय भाषा में पूरी जानकारी मिल जाती है. अगर किसी ऐसी भाषा के लिए स्थानीय भाषा में डेटा हासिल किया जा रहा है जो YouTube ऐप्लिकेशन की मौजूदा भाषा नहीं है, तो आपको इस तरीके का इस्तेमाल करके, सभी स्थानीय भाषा के अनुसार अनुवाद पाना होगा. इसके बाद, फ़िल्टर लगाकर पता लगाना होगा कि मनमुताबिक जगह के मुताबिक डेटा मौजूद है या नहीं.
-
-
स्थानीय भाषा में लिखे गए टेक्स्ट की वैल्यू से जुड़ी गड़बड़ियां
एपीआई, स्थानीय जगह के अनुसार टेक्स्ट वैल्यू के लिए, यहां दी गई नई गड़बड़ियों के साथ भी काम करता है:
गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest (400)
defaultLanguageNotSetError
यह गड़बड़ी बताती है कि किसी संसाधन के लिए localizations
ऑब्जेक्ट को शामिल या अपडेट करने की कोशिश करने वाला अनुरोध काम नहीं कर रहा है, क्योंकि उस संसाधन के लिएsnippet.defaultLanguage
प्रॉपर्टी सेट नहीं है.channels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
, औरvideos.update
तरीके यह गड़बड़ी ठीक करते हैं.badRequest (400)
localizationValidationError
इस गड़बड़ी से पता चलता है कि संसाधन के localizations
ऑब्जेक्ट में मौजूद किसी वैल्यू की पुष्टि नहीं हो सकी. उदाहरण के लिए, यह गड़बड़ी तब हो सकती है, जब ऑब्जेक्ट में कोई अमान्य भाषा कोड हो.channels.update
,channelSections.insert
,channelSections.update
,playlists.insert
, औरplaylists.update
तरीके यह गड़बड़ी ठीक करते हैं.
4 नवंबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों में बदलाव
-
search.list
तरीके केorder
पैरामीटर को अपडेट कर दिया गया है. इससे यह पता चलेगा कि लाइव ब्रॉडकास्ट कोviewCount
के हिसाब से क्रम में लगाने पर, एपीआई के नतीजे ब्रॉडकास्ट के हिसाब से क्रम में दिखेंगे प्रसारण जारी होने के दौरान एक साथ देखने वाले दर्शकों की संख्या. -
search.list
तरीके केrelatedToVideoId
पैरामीटर को अपडेट किया गया है. इससे यह पता चलेगा कि अगर पैरामीटर को सेट किया गया है, तोpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(जिसेvideo
पर सेट किया जाना चाहिए), औरfields
सिर्फ़ ऐसे पैरामीटर हैं जिनका इस्तेमाल किया जा सकता है. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं हुआ है. -
video
संसाधन कीsnippet.publishedAt
प्रॉपर्टी की परिभाषा को यह नोट करने के लिए अपडेट किया गया है कि प्रॉपर्टी की वैल्यू से, वीडियो के पब्लिश होने की तारीख और समय की जानकारी मिलती है. यह वैल्यू, वीडियो अपलोड करने के समय से अलग हो सकती है. उदाहरण के लिए, अगर किसी वीडियो को निजी वीडियो के तौर पर अपलोड करके, बाद में सार्वजनिक किया जाता है, तो प्रॉपर्टी की वैल्यू से उस समय का पता चलता है जब वीडियो को सार्वजनिक किया गया था. अपडेट की गई परिभाषा से यह भी पता चलता है कि 'निजी' और 'सबके लिए मौजूद नहीं' के तौर पर सेट वीडियो के लिए, इन वैल्यू का डेटा कैसे जनरेट होता है.इस बदलाव को लागू करने के बाद, एपीआई के काम करने के तरीके में कोई बदलाव नहीं हुआ है.
-
video
संसाधन कीstatus.publishAt
प्रॉपर्टी की परिभाषा को अपडेट कर दिया गया है, ताकि:- अगर
videos.update
तरीके को कॉल करते समय इस प्रॉपर्टी की वैल्यू सेट की जाती है, तो आपकोstatus.privacyStatus
प्रॉपर्टी की वैल्यू को भीprivate
पर सेट करना होगा. भले ही, वीडियो पहले से ही 'निजी' के तौर पर सेट हो. - अगर अनुरोध किसी वीडियो को पब्लिश करने के लिए शेड्यूल किया जाता है, तो वह वीडियो तुरंत पब्लिश कर दिया जाता है. इसलिए,
status.publishAt
प्रॉपर्टी को पिछली तारीख और समय पर सेट करने का असर, वीडियो केprivacyStatus
कोprivate
सेpublic
में बदलने जैसा ही होता है.
- अगर
-
video
संसाधन कीcontentDetails.contentRating.cncRating
प्रॉपर्टी, फ़्रांस के कमीशन डी क्लासिफ़िकेशन सिनेटोग्राफ़ के ज़रिए, वीडियो की रेटिंग के बारे में बताती है. यह प्रॉपर्टी,contentDetails.contentRating.fmocRating
प्रॉपर्टी की जगह ले रही है, जिसे अब बंद कर दिया गया है. -
channel
संसाधन के brandingSettings.channel.keywords की परिभाषा को अपडेट किया गया है, ताकि यह सही तरीके से दिखाया जा सके कि प्रॉपर्टी की वैल्यू में, स्ट्रिंग की स्पेस से अलग की गई सूची मौजूद है, न कि कॉमा लगाकर अलग की गई सूची, जैसा कि पहले बताया गया है. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं हुआ है. -
thumbnails.set
तरीके के दस्तावेज़ अपडेट कर दिए गए हैं, ताकि यह साफ़ तौर पर बताया जा सके कि अनुरोध के मुख्य हिस्से में वह थंबनेल इमेज है जिसे आपने वीडियो के साथ अपलोड और जोड़ा है. अनुरोध के मुख्य हिस्से मेंthumbnail
संसाधन नहीं है. इससे पहले, दस्तावेज़ में बताया गया था कि इस तरीके का इस्तेमाल करते समय, आपको अनुरोध का मुख्य हिस्सा नहीं देना चाहिए. इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं हुआ है. -
activity
संसाधन की जानकारी को अपडेट कर दिया गया है, ताकि यह पता चल सके किactivities.list
वाले तरीके में, वीडियो की नई टिप्पणियों से जुड़े संसाधन फ़िलहाल उपलब्ध नहीं हैं. संसाधन केsnippet.type
औरcontentDetails.comment
भी अपडेट कर दिए गए हैं.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी की जानकारी activities.insert
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण invalidMetadata
ब्यौरा kind
प्रॉपर्टी, दिए गए आईडी टाइप से मेल नहीं खाती.commentThreads.update
comments.insert
comments.update
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण commentTextTooLong
ब्यौरा जो comment
संसाधन शामिल किया जा रहा है या अपडेट किया जा रहा है उसमेंsnippet.topLevelComment.snippet.textOriginal
प्रॉपर्टी में बहुत ज़्यादा वर्ण हैं.playlistItems.insert
playlistItems.update
एचटीटीपी रिस्पॉन्स कोड forbidden (403)
कारण playlistItemsNotAccessible
ब्यौरा अनुरोध को प्लेलिस्ट में मौजूद आइटम को शामिल करने, अपडेट करने या मिटाने की अनुमति नहीं है. playlists.delete
playlists.insert
playlists.update
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण playlistForbidden
ब्यौरा यह कार्रवाई प्रतिबंधित है या अनुरोध उचित तरीके से अधिकृत नहीं है. search.list
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण invalidLocation
ब्यौरा location
और/याlocationRadius
पैरामीटर की वैल्यू गलत तरीके से फ़ॉर्मैट की गई थी.search.list
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण invalidRelevanceLanguage
ब्यौरा relevanceLanguage
पैरामीटर वैल्यू को गलत तरीके से फ़ॉर्मैट किया गया था.subscriptions.insert
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण subscriptionForbidden
ब्यौरा यह गड़बड़ी तब दिखती है, जब इनमें से कोई बात सही हो: - आपको जो सदस्यता बनानी है वह पहले से मौजूद है
- आपकी सदस्यताएँ जोड़ने की तय सीमा पूरी हो चुकी है
- आपने अपने चैनल की सदस्यता लेने की कोशिश की है. यह सुविधा उपलब्ध नहीं है.
- आपने हाल ही में बहुत सारी सदस्यताएं बनाई हैं. फिर से अनुरोध करने से पहले आपको कुछ घंटे इंतज़ार करना होगा.
videos.update
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण invalidDefaultBroadcastPrivacySetting
ब्यौरा अनुरोध, डिफ़ॉल्ट ब्रॉडकास्ट के लिए अमान्य निजता सेटिंग सेट करने की कोशिश करता है.
-
28 अगस्त, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों में बदलाव
-
video
संसाधन कीstatistics.favoriteCount
प्रॉपर्टी बंद कर दी गई है.इस्तेमाल पर रोक लगाने की हमारी नीति के मुताबिक, इस एलान के बाद कम से कम एक साल तक यह प्रॉपर्टी,
video
के संसाधनों में शामिल रहेगी. हालांकि, अब प्रॉपर्टी की वैल्यू हमेशा0
पर सेट रहती है.
-
7 अगस्त, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों में बदलाव
-
एपीआई सर्वर, प्रॉपर्टी की वैल्यू का हिसाब कैसे लगाता है, इस बारे में ज़्यादा जानकारी देने के लिए
video
संसाधन कीsnippet.tags[]
प्रॉपर्टी की परिभाषा अपडेट कर दी गई है. ध्यान दें कि इस अपडेट से, एपीआई के काम करने के तरीके में कोई बदलाव नहीं आया है.खास तौर पर, परिभाषा से पता चलता है कि अगर किसी टैग में कोई स्पेस होता है, तो एपीआई सर्वर टैग की वैल्यू को इस तरह हैंडल करता है मानो उसे कोटेशन मार्क में रैप किया गया हो और कोटेशन मार्क की गिनती वर्ण सीमा में की जाती है. इसलिए, वर्ण सीमाओं के लिए, Foo-Baz टैग में सात वर्ण होते हैं, जबकि Foo Baz टैग में नौ वर्ण होते हैं.
-
commentThreads.insert
तरीका अबshareOnGooglePlus
पैरामीटर के साथ काम नहीं करता. इससे पहले यह पता चलता था कि किसी टिप्पणी और उस टिप्पणी पर दिए गए जवाबों को लेखक की Google+ प्रोफ़ाइल पर भी पोस्ट किया जाना चाहिए या नहीं. अगर किसी अनुरोध में पैरामीटर सबमिट किया जाता है, तो एपीआई सर्वर पैरामीटर को अनदेखा कर देता है और किसी अन्य तरीके से अनुरोध को हैंडल करता है.
-
18 जून, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
मौजूदा संसाधनों और तरीकों में बदलाव
-
commentThreads.list
तरीके का नयाorder
पैरामीटर वह क्रम तय करता है जिसमें एपीआई के जवाब में टिप्पणी के थ्रेड का क्रम तय किया जाना चाहिए. थ्रेड को समय के हिसाब से या कितने काम का है, इसके हिसाब से क्रम में लगाया जा सकता है. डिफ़ॉल्ट रूप से उन्हें समय के हिसाब से क्रम में लगाया जाता है. -
video
संसाधन की नईsnippet.defaultAudioLanguage
प्रॉपर्टी, वीडियो के डिफ़ॉल्ट ऑडियो ट्रैक में बोली जाने वाली भाषा के बारे में बताती है. -
video
संसाधन कीcontentDetails.licensedContent
प्रॉपर्टी की परिभाषा को अपडेट कर दिया गया है. इसका मकसद यह बताना है कि यह कॉन्टेंट, YouTube के कॉन्टेंट पार्टनर से लिंक किए गए किसी चैनल पर अपलोड किया गया होना चाहिए और इसके बाद उस पार्टनर ने उस पर दावा किया हो. यह एपीआई के काम करने के असल तरीके पर कोई असर नहीं डालता. -
captions.delete
,captions.download
,captions.insert
,captions.list
, औरcaptions.update
के तरीके अबonBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. इस तरीके का इस्तेमाल करने वाले अनुरोधों को ऐसे टोकन से अनुमति देना ज़रूरी है जोhttps://www.googleapis.com/auth/youtubepartner
स्कोप का ऐक्सेस देता हो.
-
-
नई और अपडेट की गई गड़बड़ियां
-
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी की जानकारी videos.rate
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण emailNotVerified
ब्यौरा वीडियो को रेटिंग देने से पहले उपयोगकर्ता को अपने ईमेल पते की पुष्टि करनी होगी. videos.rate
एचटीटीपी रिस्पॉन्स कोड badRequest (400)
कारण videoPurchaseRequired
ब्यौरा किराये पर लिए गए वीडियो को सिर्फ़ वे उपयोगकर्ता रेटिंग दे सकते हैं जिन्होंने उन्हें किराये पर लिया है. -
subscriptions.delete
औरsubscriptions.insert
तरीके अबaccountClosed
औरaccountSuspended
गड़बड़ियों के साथ काम नहीं करते.
-
27 अप्रैल, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
नए संसाधन और तरीके
-
नए
videoAbuseReportReason
संसाधन में, बुरे बर्ताव वाला कॉन्टेंट होने की वजह से वीडियो को फ़्लैग किए जाने की वजह के बारे में जानकारी शामिल होती है.videoAbuseReportReasons.list
तरीका, आपको वीडियो फ़्लैग किए जाने की सभी वजहों की सूची पाने में मदद करता है. -
videos.reportAbuse
के नए तरीके से, ऐसे वीडियो को फ़्लैग किया जा सकता है जिसमें बुरे बर्ताव वाला कॉन्टेंट है. अनुरोध के मुख्य हिस्से में एक JSON ऑब्जेक्ट होता है. इसमें यह बताया जाता है कि वीडियो को फ़्लैग किया गया है या नहीं. साथ ही, इसमें यह भी बताया गया है कि वीडियो में आपत्तिजनक कॉन्टेंट है. मान्य वजहों की जानकारी, ऊपर बताए गएvideoAbuseReportReason.list
तरीके से मिल सकती है.डेटा को दूसरी जगह भेजने से जुड़ी गाइड में, बुरे बर्ताव वाले वीडियो की शिकायत करने का उदाहरण भी जोड़ा गया है. इस बदलाव के साथ ही, v3 API में अब उन सभी v2 API सुविधाओं का इस्तेमाल किया जा सकता है जिनके साथ इसे इस्तेमाल करने के लिए शेड्यूल किया गया है. माइग्रेशन गाइड में इन सुविधाओं के बारे में पूरी जानकारी दी गई है.
-
-
मौजूदा संसाधनों और तरीकों में बदलाव
-
search.list
तरीके का नयाforDeveloper
फ़िल्टर पैरामीटर, किसी खोज को सिर्फ़ डेवलपर के ऐप्लिकेशन या वेबसाइट से अपलोड किए गए वीडियो तक पहुंचने से रोकता है.forDeveloper
पैरामीटर का इस्तेमाल, खोज के वैकल्पिक पैरामीटर, जैसे किq
पैरामीटर के साथ किया जा सकता है.इस सुविधा के लिए, अपलोड किया गया हर वीडियो अपने-आप उस प्रोजेक्ट नंबर से टैग हो जाता है जो Google Developers Console में डेवलपर के ऐप्लिकेशन से जुड़ा होता है.
जब कोई खोज अनुरोध,
forDeveloper
पैरामीटर कोtrue
पर सेट करता है, तो डेवलपर की पहचान करने के लिए एपीआई सर्वर, अनुरोध की पुष्टि करने वाले क्रेडेंशियल का इस्तेमाल करता है. इसलिए, डेवलपर अपने ऐप्लिकेशन या वेबसाइट पर अपलोड किए गए वीडियो के नतीजों पर पाबंदी लगा सकता है, लेकिन अन्य ऐप्लिकेशन या साइटों पर अपलोड किए गए वीडियो तक नहीं.नई सुविधा में कुछ सुविधाएं मिलती हैं. हालांकि, यह फ़ंक्शन डेवलपर टैग के उन फ़ंक्शन से मिलता-जुलता है जो v2 API पर काम करते हैं.
-
channel
संसाधन की नईsnippet.country
प्रॉपर्टी से चैनल के मालिक, अपने चैनलों को किसी खास देश से जोड़ सकते हैं.ध्यान दें: अगर
channel
रिसॉर्स के लिएsnippet.country
प्रॉपर्टी सेट करनी है, तो आपकोbrandingSettings.channel.country
प्रॉपर्टी अपडेट करनी होगी. -
यह एपीआई अब
channelSection
संसाधनों को टारगेट करने की सुविधा देता है. चैनल सेक्शन को टारगेट करने से, किसी खास शर्त को पूरा करने वाले उपयोगकर्ताओं को कॉन्टेंट का सेक्शन सिर्फ़ दिखाया जा सकता है.यह एपीआई, टारगेटिंग के तीन विकल्प दिखाता है. चैनल सेक्शन के दिखने के लिए, उपयोगकर्ता को टारगेटिंग की सभी सेटिंग को पूरा करना होगा.
-
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 एपीआई से टिप्पणी करने की सुविधा का इस्तेमाल करके अब भी ऐप्लिकेशन कैसे माइग्रेट किए जा सकते हैं.
इस गाइड में टिप्पणी करने की ऐसी कई सुविधाओं के बारे में भी बताया गया है जो v2 API पर काम नहीं करतीं, लेकिन v3 API पर काम करती हैं. इनमें शामिल हैं:
- किसी चैनल के बारे में टिप्पणियां वापस पाना
- किसी चैनल से जुड़ी टिप्पणी की सभी थ्रेड को वापस पाना. इसका मतलब है कि एपीआई से मिले जवाब में चैनल या उसके किसी भी वीडियो के बारे में टिप्पणियां शामिल की जा सकती हैं.
- किसी टिप्पणी का टेक्स्ट अपडेट करना
- किसी टिप्पणी को स्पैम के तौर पर मार्क करना
- टिप्पणी का मॉडरेशन स्टेटस सेट करना
-
पुश नोटिफ़िकेशन की सदस्यता लेने से जुड़ी गाइड अपडेट कर दी गई है. इससे यह जानकारी मिलती है कि सूचनाएं सिर्फ़ Google PubSubHubBub हब पर भेजी जाती हैं, सुपरफ़ीडर हब पर नहीं, जैसा कि पहले बताया गया है.
9 अप्रैल, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई के नए
commentThread
औरcomment
संसाधनों की मदद से, टिप्पणियों को वापस लाया जा सकता है, शामिल किया जा सकता है, अपडेट किया जा सकता है, मिटाया जा सकता है, और मॉडरेट किया जा सकता है.-
commentThread
संसाधन में, YouTube पर की गई टिप्पणी के थ्रेड के बारे में जानकारी होती है. इसमें टॉप लेवल की टिप्पणी और किसी टिप्पणी पर दिए गए जवाब शामिल होते हैं.commentThread
संसाधन, किसी वीडियो या चैनल के बारे में टिप्पणियों को दिखा सकता है.टॉप लेवल की टिप्पणी और उस पर दिए गए जवाब, असल में
comment
संसाधन हैं. येcommentThread
संसाधन में नेस्ट किए गए होते हैं. यह ध्यान रखना ज़रूरी है कि यह ज़रूरी नहीं है किcommentThread
संसाधन में, किसी टिप्पणी के सभी जवाब शामिल हों. अगर आपको किसी टिप्पणी के सभी जवाब वापस लाने हैं, तो आपकोcomments.list
तरीके का इस्तेमाल करना होगा. इसके अलावा, कुछ टिप्पणियों का जवाब नहीं दिया जाता.एपीआई,
commentThread
संसाधनों के लिए इन तरीकों के साथ काम करता है:commentThreads.list
– टिप्पणी थ्रेड की सूची पाएं. किसी वीडियो या चैनल से जुड़ी टिप्पणियों का पता लगाने के लिए, यह तरीका अपनाएं.commentThreads.insert
– टॉप-लेवल की कोई नई टिप्पणी करें. (किसी मौजूदा टिप्पणी का जवाब देने के लिए,comments.insert
तरीके का इस्तेमाल करें.)commentThreads.update
– किसी टॉप लेवल टिप्पणी में बदलाव करें.
-
comment
के संसाधन में, YouTube पर की गई एक टिप्पणी के बारे में जानकारी होती है.comment
संसाधन, किसी वीडियो या चैनल के बारे में किसी टिप्पणी को दिखा सकता है. इसके अलावा, टिप्पणी किसी टॉप लेवल की टिप्पणी या किसी टॉप लेवल की टिप्पणी का जवाब हो सकती है.एपीआई,
comment
संसाधनों के लिए इन तरीकों के साथ काम करता है:comments.list
– टिप्पणी की सूची फिर से पाएं. किसी खास टिप्पणी पर दिए गए सभी जवाबों को पाने के लिए, इस तरीके का इस्तेमाल करें.comments.insert
– किसी मौजूदा टिप्पणी का जवाब दें.comments.update
– किसी टिप्पणी में बदलाव करें.comments.markAsSpam
– एक या उससे ज़्यादा टिप्पणियों को स्पैम के तौर पर फ़्लैग करें.comments.setModerationStatus
– एक या उससे ज़्यादा टिप्पणियों को मॉडरेट करने की स्थिति सेट करें. उदाहरण के लिए, सार्वजनिक तौर पर दिखने के लिए किसी टिप्पणी को हटाना या किसी टिप्पणी को 'दिखाया नहीं जा सकता' के तौर पर अस्वीकार करना. एपीआई अनुरोध को टिप्पणियों से जुड़े चैनल या वीडियो के मालिक से अनुमति मिलनी चाहिए.comments.delete
– कोई टिप्पणी मिटाएं.
ध्यान दें कि 2 अप्रैल, 2015 के संशोधन इतिहास में बताया गया एपीआई का नया
https://www.googleapis.com/auth/youtube.force-ssl
दायराcomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
, औरcommentThreads.update
तरीकों पर किए जाने वाले कॉल के लिए ज़रूरी है. -
-
पुश नोटिफ़िकेशन की सदस्यता लेने की नई गाइड में, एपीआई को PubSubHubBub की मदद से पुश नोटिफ़िकेशन के लिए नई सुविधा के बारे में बताया गया है. यह एक सर्वर-टू-सर्वर पब्लिश/सदस्यता लें प्रोटोकॉल है, जो वेब ऐक्सेस करने लायक संसाधनों के लिए इस्तेमाल किया जाता है. जब कोई चैनल इनमें से कोई भी काम करता है, तो आपके PubSubHubBub कॉलबैक सर्वर को ऐटम फ़ीड की सूचनाएं मिल सकती हैं:
- कोई वीडियो अपलोड करता है
- वीडियो के टाइटल को अपडेट करता है
- वीडियो के ब्यौरे को अपडेट करता है
-
पुश नोटिफ़िकेशन से जुड़ी नई सुविधाओं के बारे में बताने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड को भी अपडेट किया गया है. हालांकि, v2 API में कई तरह के ऐसे पुश नोटिफ़िकेशन काम करते हैं जो v3 एपीआई में काम नहीं करते. इसलिए, इस गाइड के अब काम नहीं करता सेक्शन में, PubSubHubBub सहायता के बारे में जानकारी मौजूद है.
-
एपीआई का नया
https://www.googleapis.com/auth/youtube.force-ssl
स्कोप, अब ऐसे किसी भी एपीआई तरीके के लिए मान्य स्कोप है जो पहलेhttps://www.googleapis.com/auth/youtube
स्कोप के साथ काम करता था. -
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest (400)
invalidRating
अगर अनुरोध में rating
पैरामीटर के लिए कोई ऐसी वैल्यू शामिल है जिसकी उम्मीद नहीं थी, तोvideos.rate
तरीका गड़बड़ी का यह मैसेज दिखाता है. -
subscriptions.insert
तरीके अबsubscriptionLimitExceeded
गड़बड़ी के साथ काम नहीं करता. इस गड़बड़ी से पता चलता था कि जिस सदस्य ने अनुरोध किया है वह सदस्यता की तय सीमा को पार कर चुका है.
2 अप्रैल, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
नया
captions
संसाधन, YouTube कैप्शन ट्रैक को दिखाता है. कैप्शन ट्रैक, सिर्फ़ एक YouTube वीडियो से जुड़ा होता है.यह एपीआई, कैप्शन ट्रैक को सूची में जोड़ने, शामिल करने, अपडेट करने, डाउनलोड करने, और मिटाने के तरीकों का इस्तेमाल करता है.
-
माइग्रेशन गाइड में भी यह जानकारी दी गई है कि v2 एपीआई में कैप्शन की सुविधा का इस्तेमाल करके, ऐप्लिकेशन को कैसे माइग्रेट किया जा सकता है.
-
एपीआई के नए
https://www.googleapis.com/auth/youtube.force-ssl
स्कोप का इस्तेमाल करने के लिए, एसएसएल कनेक्शन का इस्तेमाल करके एपीआई सर्वर से संपर्क करना ज़रूरी है.इस नए स्कोप से वही ऐक्सेस मिलता है जो
https://www.googleapis.com/auth/youtube
स्कोप के पास है. असल में, ये दोनों स्कोप एक जैसे काम करते हैं, क्योंकि YouTube API सर्वर सिर्फ़ एचटीटीपीएस एंडपॉइंट के ज़रिए उपलब्ध होता है. इस वजह से, भले हीhttps://www.googleapis.com/auth/youtube
स्कोप के लिए एसएसएल कनेक्शन की ज़रूरत न हो, लेकिन एपीआई अनुरोध करने का कोई और तरीका नहीं है.caption
संसाधन के सभी तरीकों पर किए जाने वाले कॉल के लिए, नया दायरा ज़रूरी है.
11 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API (v3) माइग्रेशन गाइड में एक नया टैब शामिल है. इसका नाम v3 API में नया है. इसमें उन सुविधाओं की सूची दी गई है जो v3 API पर काम करती हैं और v2 API पर काम नहीं करतीं. वही सुविधाएं पहले थीं और अब भी गाइड के अन्य टैब में मौजूद हैं. उदाहरण के लिए, किसी चैनल का इन-वीडियो प्रमोशनल कैंपेन डेटा अपडेट करने का तरीका बताने वाली नई सुविधा भी चैनल (प्रोफ़ाइल) टैब में उपलब्ध है.
-
YouTube Data API (v3) माइग्रेशन गाइड को अपडेट करके यह बताया गया है कि v3 API पर, v2 API की यह सुविधा काम करती है:
-
YouTube Data API (v3) माइग्रेशन गाइड में यह जानकारी दी गई है कि v2 API की ये सुविधाएं, v3 API में काम नहीं करेंगी:
-
वीडियो के सुझाव वापस पाना – v3 एपीआई ऐसी सूची को फिर से हासिल नहीं करता जिसमें सिर्फ़ एपीआई के मौजूदा उपयोगकर्ता के लिए सुझाए गए वीडियो शामिल हों. हालांकि, सुझाए गए वीडियो ढूंढने के लिए, v3 API का इस्तेमाल किया जा सकता है. ऐसा करने के लिए,
activities.list
तरीके को कॉल करें औरhome
पैरामीटर की वैल्यू कोtrue
पर सेट करें.अगर
snippet.type
प्रॉपर्टी की वैल्यूrecommendation
है, तो एपीआई से मिले रिस्पॉन्स में, कोई रिसॉर्स सुझाए गए वीडियो से जुड़ा होता है. ऐसे में,contentDetails.recommendation.reason
औरcontentDetails.recommendation.seedResourceId
प्रॉपर्टी में यह जानकारी शामिल होगी कि वीडियो का सुझाव क्यों दिया गया है. ध्यान दें, इस बात की कोई गारंटी नहीं है कि जवाब में, सुझाए गए वीडियो की कोई खास संख्या शामिल की जाएगी. -
नई सदस्यता वाले वीडियो वापस पाना – v3 एपीआई किसी ऐसी सूची को फिर से हासिल नहीं करता जिसमें सिर्फ़ उन चैनलों पर अपलोड किए गए वीडियो हों जिनकी एपीआई उपयोगकर्ता ने सदस्यता ली है. हालांकि, सदस्यता वाले नए वीडियो ढूंढने के लिए, v3 एपीआई का इस्तेमाल किया जा सकता है. इसके लिए,
activities.list
तरीके को कॉल करें औरhome
पैरामीटर की वैल्यू कोtrue
पर सेट करें.अगर
snippet.type
प्रॉपर्टी की वैल्यूupload
है, तो एपीआई से मिले रिस्पॉन्स में यह संसाधन नए सदस्यता वाले वीडियो से जुड़ा होता है. ध्यान दें, इस बात की कोई गारंटी नहीं है कि जवाब में, सदस्यता वाले नए वीडियो की कोई खास संख्या शामिल की जाएगी. -
फ़ीड के अपडेट के लिए पुश नोटिफ़िकेशन – YouTube इस्तेमाल करने वाले लोगों के लिए, उपयोगकर्ता गतिविधि फ़ीड पर नज़र रखने के लिए, सिंपल अपडेट प्रोटोकॉल (एसयूपी) या PubSubHubbub का इस्तेमाल करके, v2 एपीआई पर काम करने वाले पुश नोटिफ़िकेशन का इस्तेमाल किया जाता है. चैनल की नई सदस्यता लेने वालों के लिए सूचनाएं दी जाती थीं. साथ ही, इस बात की भी सूचना दी जाती थी कि वीडियो को रेटिंग कब दी गई, शेयर किया गया, पसंदीदा के तौर पर मार्क किया गया, उन पर टिप्पणी की गई या उन्हें अपलोड किया गया.
v3 एपीआई, PubSubHubbub प्रोटोकॉल का इस्तेमाल करके पुश नोटिफ़िकेशन की सुविधा देगा. हालांकि, सूचनाओं में सिर्फ़ वीडियो अपलोड और वीडियो के टाइटल या वीडियो की जानकारी से जुड़े अपडेट की जानकारी दी जाएगी.
-
चैनल की जगह की जानकारी – v2 API ने
<yt:location>
टैग का इस्तेमाल करके यह पता लगाया कि उपयोगकर्ता की जगह की जानकारी, चैनल की YouTube सार्वजनिक प्रोफ़ाइल में दी गई है या नहीं. कुछ डेवलपर ने इस फ़ील्ड का इस्तेमाल करके, किसी चैनल को किसी देश से जोड़ा है. हालांकि, इस काम के लिए, फ़ील्ड के डेटा का लगातार इस्तेमाल नहीं किया जा सकता. -
डेवलपर टैग सेट करना या वापस पाना – v2 एपीआई की मदद से वीडियो अपलोड करते समय, कीवर्ड या डेवलपर टैग को किसी वीडियो से जोड़ा जा सकता था. डेवलपर टैग, YouTube उपयोगकर्ताओं को नहीं दिखाए जाएंगे. हालांकि, वीडियो के मालिक, किसी खास डेवलपर टैग से मेल खाने वाले वीडियो वापस ला सकते हैं.
v3 एपीआई से मिलती-जुलती सुविधा मिलेगी. हालांकि, यह एक जैसी नहीं होगी. खास तौर पर, डेवलपर अपने ऐप्लिकेशन से अपलोड किए गए वीडियो खोज सकता है. इस सुविधा के लिए, अपलोड किया गया हर वीडियो अपने-आप उस प्रोजेक्ट नंबर से टैग हो जाता है जो Google Developers Console में डेवलपर के ऐप्लिकेशन से जुड़ा होता है. इसके बाद, वीडियो खोजने के लिए डेवलपर उसी प्रोजेक्ट नंबर का इस्तेमाल करता है.
-
पब्लिश करने की तारीख, देखे जाने की संख्या या रेटिंग के हिसाब से वीडियो की सूची बनाएं – v2 API में
orderby
पैरामीटर से, किसी प्लेलिस्ट में वीडियो को जगह, अवधि, पब्लिकेशन की तारीख, टाइटल, और अन्य कई वैल्यू के हिसाब से क्रम में लगाया जा सकता है. v3 एपीआई में, प्लेलिस्ट में मौजूद आइटम को आम तौर पर बढ़ते क्रम में लगाया जाता है. साथ ही, उन्हें क्रम से लगाने के दूसरे विकल्प उपलब्ध नहीं होते.इसके कुछ अपवाद हैं. इस तरह की प्लेलिस्ट के लिए, पहले आइटम (
snippet.position
=0
) के तौर पर नया अपलोड, पसंदीदा वीडियो, पसंद किया गया वीडियो या हाल ही में देखा गया वीडियो अपने-आप जुड़ जाता है. इसलिए, इनमें से हर एक सूची सबसे नए से सबसे पुराने के क्रम में सही तरीके से क्रम में लगी होती है. यह क्रम उस आइटम को सूची में जोड़े जाने के समय के आधार पर किया जाता है.- उपयोगकर्ता के अपलोड
- पसंदीदा वीडियो
- पसंद किए गए वीडियो
- देखने का इतिहास
हालांकि, ध्यान रखें कि "बाद में देखें" प्लेलिस्ट में एक नया आइटम जोड़ा गया है प्लेलिस्ट को उस सूची के आखिरी आइटम के तौर पर जोड़ा जाता है, ताकि वह सूची सबसे पुराने से सबसे नए आइटम के क्रम में असरदार तरीके से दिखे.
-
बैच प्रोसेसिंग – v3 API, बैच प्रोसेसिंग के इस्तेमाल के उन उदाहरणों में से एक के साथ काम करता है जो v2 API के साथ काम करता था. v3 एपीआई के
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
, औरvideos.list
तरीके,id
पैरामीटर के साथ काम करते हैं. इसका इस्तेमाल आईडी (वीडियो आईडी, चैनल आईडी वगैरह) की कॉमा-डीलिमिटेड सूची बनाने के लिए किया जा सकता है. उन तरीकों का इस्तेमाल करके, एक ही अनुरोध से कई रिसॉर्स की सूची को वापस पाया जा सकता है.
इन बदलावों के साथ, यह गाइड अब पुराने (v2) एपीआई में काम करने वाले उन सभी फ़ंक्शन की पहचान करती है जिन्हें मौजूदा एपीआई वर्शन (v3) में बंद कर दिया जाएगा.
-
4 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
अब
channelSections.delete
औरchannelSections.update
तरीके,onBehalfOfContentOwner
पैरामीटर के साथ काम करते हैं, जो पहले से ही कई दूसरे तरीकों के साथ काम करता है. -
इन प्रॉपर्टी और इनकी चाइल्ड प्रॉपर्टी को बंद कर दिया गया है:
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
ध्यान दें: इनमें से किसी भी प्रॉपर्टी पर, एपीआई को बंद करने की नीति लागू नहीं होती.
-
video
संसाधन की नईcontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
प्रॉपर्टी, वीडियो को DJCQT (ब्राज़ील) रेटिंग मिलने की वजहों का पता लगाती है. -
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा notFound (404)
channelNotFound
अगर अनुरोध के id
पैरामीटर में कोई ऐसा चैनल मौजूद है जो नहीं मिल रहा है, तोchannels.update
तरीका गड़बड़ी का मैसेज दिखाता है.badRequest (400)
manualSortRequiredinvalidValue
playlistItems.insert
औरplaylistItems.update
तरीके यह गड़बड़ी तब दिखाते हैं, जब अनुरोध प्लेलिस्ट में मौजूद आइटम की जगह सेट करने की कोशिश करता है, लेकिन प्लेलिस्ट में मैन्युअल तरीके से क्रम में लगाने की सुविधा का इस्तेमाल नहीं किया जाता. उदाहरण के लिए, प्लेलिस्ट में मौजूद आइटम को तारीख या लोकप्रियता के हिसाब से क्रम में लगाया जा सकता है. इस गड़बड़ी को ठीक करने के लिए, अनुरोध के मुख्य हिस्से में भेजे गए संसाधन सेsnippet.position
एलिमेंट को हटाएं. अगर आपको सूची में प्लेलिस्ट में मौजूद आइटम को किसी खास क्रम में लगाना है, तो पहले आपको प्लेलिस्ट की क्रम से जुड़ी सेटिंग को मैन्युअल पर सेट करना होगा. इस सेटिंग को YouTube वीडियो मैनेजर में जाकर बदला जा सकता है.forbidden (403)
channelClosed
अगर अनुरोध के channelId
पैरामीटर में किसी ऐसे चैनल के बारे में बताया गया है जिसे बंद किया गया है, तोplaylists.list
तरीका गड़बड़ी का मैसेज दिखाता है.forbidden (403)
channelSuspended
अगर अनुरोध के channelId
पैरामीटर में किसी निलंबित चैनल की जानकारी दी गई है, तोplaylists.list
तरीका गड़बड़ी का मैसेज दिखाता है.forbidden (403)
playlistForbidden
playlists.list
तरीका यह गड़बड़ी तब दिखाता है, जब अनुरोध काid
पैरामीटर, अनुरोध के साथ काम नहीं करता या अनुरोध को सही तरीके से अनुमति नहीं दी गई है.notFound (404)
channelNotFound
अगर अनुरोध के channelId
पैरामीटर में कोई ऐसा चैनल मौजूद है जो नहीं मिल रहा है, तोplaylists.list
तरीका गड़बड़ी का मैसेज दिखाता है.notFound (404)
playlistNotFound
अगर अनुरोध का id
पैरामीटर किसी ऐसी प्लेलिस्ट के बारे में बताता है जो नहीं मिल सकती, तोplaylists.list
तरीका गड़बड़ी का मैसेज दिखाता है.notFound (404)
videoNotFound
अगर अनुरोध के id
पैरामीटर में किसी ऐसे वीडियो के बारे में बताया गया है जो नहीं मिल सकता, तोvideos.list
तरीका गड़बड़ी का मैसेज दिखाता है.badRequest (400)
invalidRating
अगर अनुरोध में rating
पैरामीटर के लिए कोई ऐसी वैल्यू शामिल है जिसकी उम्मीद नहीं थी, तोvideos.rate
तरीका गड़बड़ी का यह मैसेज दिखाता है.
2 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
तरीका, अबrelevanceLanguage
पैरामीटर के साथ काम करता है. इससे आपको किसी एक भाषा के लिए, सबसे ज़्यादा काम के नतीजों के लिए अनुरोध करने की सुविधा मिलती है.इस नए पैरामीटर को इस्तेमाल करने का तरीका बताने के लिए, YouTube Data API (v3) माइग्रेशन गाइड को भी अपडेट किया गया है. यह पैरामीटर, एपीआई के मौजूदा वर्शन (v3) और पिछले वर्शन (v2) में पहले से मौजूद सुविधा के अंतर को ठीक करता है. इसे पहले ही बंद कर दिया गया है.
-
YouTube Data API (v3) माइग्रेशन गाइड को भी अपडेट किया गया है. इसका मकसद, उन स्पेशल फ़ीड और मेटाडेटा फ़ील्ड के इस्तेमाल को बंद करना है जो v2 API ने फ़िल्मों, ट्रेलर, टेलीविज़न शो, टेलीविज़न सीज़न, और टेलीविज़न एपिसोड का ब्यौरा देने के लिए उपलब्ध कराया था.
14 जनवरी, 2015
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API (v3) माइग्रेशन गाइड को अपडेट कर दिया गया है. इसमें JavaScript का इस्तेमाल करके वीडियो अपलोड करने के लिए, v3 API का इस्तेमाल करने का तरीका बताया गया है. (ज़्यादा जानकारी के लिए, वीडियो अपलोड करें सेक्शन देखें.) यह सुविधा, ब्राउज़र पर आधारित अपलोड करने की उस सुविधा से मिलती-जुलती है जो v2 API पर काम करती है. ध्यान दें कि डेटा को दूसरी जगह भेजने से जुड़ी गाइड में किए गए इस बदलाव से, एपीआई में हुए असल बदलाव के बारे में नहीं पता चलता. इसकी जगह, क्लाइंट-साइड JavaScript का इस्तेमाल करके वीडियो अपलोड करने के लिए नए सैंपल कोड की उपलब्धता दिखती है.
JavaScript क्लाइंट लाइब्रेरी और सीओआरएस की मदद से वीडियो अपलोड करने की सुविधा को ध्यान में रखते हुए, माइग्रेशन गाइड में अब ब्राउज़र पर आधारित अपलोड करने की सुविधा के तौर पर ऐसी सुविधा की जानकारी नहीं दी गई है जिसे v3 एपीआई से बंद किया जा सकता है.
-
ऊपर बताए गए नए JavaScript कोड के नमूने को शामिल करने के लिए,
videos.insert
तरीके से जुड़े दस्तावेज़ अपडेट कर दिए गए हैं. YouTube Data API (v3) के लिए, JavaScript कोड सैंपल की सूची भी अपडेट कर दी गई है.
11 नवंबर, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
तरीके को किए गए कॉल के कोटा की लागत को बदलकर 100 यूनिट कर दिया गया है.अहम जानकारी: कई मामलों में, कम कोटे में जानकारी पाने के लिए, एपीआई के अन्य तरीकों का इस्तेमाल किया जा सकता है. उदाहरण के लिए, GoogleDevelopers चैनल पर अपलोड किए गए वीडियो ढूंढने के इन दो तरीकों पर विचार करें.
-
कोटा की लागत: 100 यूनिट
search.list
तरीके को कॉल करें औरGoogleDevelopers
खोजें. -
कोटा की लागत: 6 यूनिट
सही चैनल आईडी पाने के लिए,
channels.list
तरीके को कॉल करें.forUsername
पैरामीटर कोGoogleDevelopers
औरpart
पैरामीटर कोcontentDetails
पर सेट करें. एपीआई से मिले रिस्पॉन्स में,contentDetails.relatedPlaylists.uploads
प्रॉपर्टी, चैनल के अपलोड किए गए वीडियो के प्लेलिस्ट आईडी के बारे में बताती है.इसके बाद,
playlistItems.list
तरीके को कॉल करें औरplaylistId
पैरामीटर को कैप्चर किए गए आईडी पर औरpart
पैरामीटर कोsnippet
पर सेट करें.
-
8 अक्टूबर, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन में दो नई प्रॉपर्टी शामिल हैं:-
status.longUploadsStatus
प्रॉपर्टी से पता चलता है कि चैनल 15 मिनट से ज़्यादा समय वाले वीडियो अपलोड कर सकता है या नहीं. यह प्रॉपर्टी सिर्फ़ तब दिखती है, जब चैनल के मालिक ने एपीआई अनुरोध की अनुमति दी हो. प्रॉपर्टी की मान्य वैल्यू ये हैं:allowed
– चैनल पर 15 मिनट से ज़्यादा के वीडियो अपलोड किए जा सकते हैं.eligible
– चैनल पर 15 मिनट से ज़्यादा के वीडियो अपलोड किए जा सकते हैं. हालांकि, इसके लिए पहले उन्हें यह सुविधा चालू करनी होगी.disallowed
– चैनल पर 15 मिनट से ज़्यादा के वीडियो अपलोड नहीं किए जा सकते या अपलोड करने की ज़रूरी शर्तें पूरी नहीं की जा सकतीं.
इन वैल्यू के बारे में ज़्यादा जानने के लिए, प्रॉपर्टी की परिभाषा देखें. इस सुविधा के बारे में ज़्यादा जानने के लिए, YouTube के सहायता केंद्र पर जाएं.
-
invideoPromotion.useSmartTiming
प्रॉपर्टी से पता चलता है कि चैनल का प्रमोशन कैंपेन "स्मार्ट टाइमिंग" का इस्तेमाल करता है या नहीं. यह सुविधा, वीडियो में प्रमोशन को ऐसे समय पर दिखाने की कोशिश करती है जब उन पर क्लिक किए जाने और वीडियो देखने के अनुभव में रुकावट आने की संभावना कम हो. इस सुविधा से, हर वीडियो पर दिखाने के लिए एक प्रमोशन भी चुना जा सकता है.
-
-
video
संसाधन कीsnippet.title
औरsnippet.categoryId
प्रॉपर्टी की परिभाषाएं अपडेट कर दी गई हैं. इसका मकसद यह बताना है कि एपीआई,videos.update
तरीके में कॉल को कैसे हैंडल करता है. अगरvideo
रिसॉर्स केsnippet
वाले हिस्से को अपडेट करने के लिए उस तरीके को कॉल किया जाता है, तो आपको उन दोनों प्रॉपर्टी के लिए वैल्यू सेट करनी होगी.अगर
video
रिसॉर्स केsnippet
वाले हिस्से को अपडेट करने की कोशिश की जाती है और इन दोनों प्रॉपर्टी के लिए वैल्यू सेट नहीं की जाती है, तो एपीआईinvalidRequest
गड़बड़ी दिखाता है. उस गड़बड़ी के ब्यौरे को भी अपडेट कर दिया गया है. -
video
संसाधन कीcontentDetails.contentRating.oflcRating
प्रॉपर्टी, न्यूज़ीलैंड के ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन से किसी वीडियो की रेटिंग की पहचान करती है. अब इस प्रॉपर्टी को दो नई रेटिंग के साथ इस्तेमाल किया जा सकता है:oflcRp13
औरoflcRp16
. ये क्रम के हिसाब सेRP13
औरRP16
रेटिंग के मुताबिक हैं. -
channelBanners.insert
तरीके अब इस गड़बड़ी के साथ काम करता है:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
bannerAlbumFull
चैनल के मालिक के YouTube चैनल आर्ट एल्बम में बहुत ज़्यादा इमेज हैं. चैनल के मालिक को http://photos.google.com पर जाकर एल्बम पेज पर जाना होगा. इसके बाद, उस एल्बम से कुछ इमेज हटानी होंगी.
12 सितंबर, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
तरीके से किए जाने वाले कॉल का कोटा, 1 यूनिट से बदलकर 2 यूनिट कर दिया गया है. यह तय रिसॉर्स पार्ट्स की लागत के अलावा है.
13 अगस्त, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
subscriptions.insert
तरीके अब इस गड़बड़ी के साथ काम करता है:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
subscriptionLimitExceeded
जिस सदस्य ने अनुरोध किया है वह सदस्यता की तय सीमा से ज़्यादा का है. कुछ घंटों में और सदस्यताएं लेने की कोशिश की जा सकती है.
12 अगस्त, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
अपने ऐप्लिकेशन को YouTube Data API (v3) पर माइग्रेट करना टाइटल वाली एक नई गाइड में बताया गया है कि YouTube Data API (v2) में उपलब्ध सुविधाएं देने के लिए, YouTube Data API (v3) का इस्तेमाल कैसे किया जा सकता है. 4 मार्च, 2014 से पुराने एपीआई को आधिकारिक तौर पर बंद कर दिया गया था. इस गाइड का मकसद, v2 API का इस्तेमाल करके अब भी इस्तेमाल किए जा रहे ऐप्लिकेशन को एपीआई के सबसे नए वर्शन पर माइग्रेट करना है.
8 जुलाई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
playlists.insert
तरीके अब इस गड़बड़ी के साथ काम करता है:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
maxPlaylistExceeded
यह गड़बड़ी तब होती है, जब प्लेलिस्ट नहीं बनाई जा सकती, क्योंकि चैनल में पहले से ही प्लेलिस्ट की सबसे ज़्यादा संख्या मौजूद होती है.
18 जून, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई के हर तरीके की जानकारी अपडेट कर दी गई है. ऐसा इसलिए किया गया है, ताकि उस तरीके को कॉल करने पर लगने वाला कोटा शामिल किया जा सके. इसी तरह, एपीआई कॉल में हासिल किए जा सकने वाले हर हिस्से का कोटा कॉस्ट बताने के लिए,
part
पैरामीटर की परिभाषाएं अपडेट कर दी गई हैं. उदाहरण के लिए,subscriptions.insert
तरीके को किए गए कॉल का कोटा करीब 50 यूनिट है.subscription
संसाधन में तीन हिस्से (snippet
,contentDetails
, औरsubscriberSnippet
) भी होते हैं और हर एक की कीमत दो यूनिट होती है.कृपया याद रखें कि कोटा की लागतें बिना किसी चेतावनी के बदल सकती हैं.
-
video
संसाधन, अब 43 नए कॉन्टेंट रेटिंग सिस्टम के साथ काम करता है. ये सिस्टम, अलग-अलग राष्ट्रीय रेटिंग एजेंसियों से वीडियो को मिली रेटिंग की पहचान करते हैं. इन रेटिंग सिस्टम के नए रेटिंग सिस्टम, अर्जेंटीना, ऑस्ट्रेलिया, ऑस्ट्र, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेल टेलीविज़न, बेल्जियम, बेल्जियम, और बुल्गारिया, चिली (टेलीविज़न), चिली (फ़िल्म) (टेलीविज़न, (टेलीविज़न), चिली (फ़िल्म</11}, चेक गणराज्य हों, चेक गणराज्य,
28 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
search.list
तरीका, अबlocation
औरlocationRadius
पैरामीटर के साथ काम करता है. इनकी मदद से, किसी जगह से जुड़े वीडियो खोजे जा सकते हैं. जगह के हिसाब से नतीजे पाने के लिए, अनुरोध में दोनों पैरामीटर के लिए एक वैल्यू तय होनी चाहिए. अगर किसी अनुरोध में इन दोनों में से सिर्फ़ एक पैरामीटर शामिल है, तो एपीआई गड़बड़ी दिखाएगा.-
location
पैरामीटर, गोल आकार वाले भौगोलिक क्षेत्र के बीच में अक्षांश/देशांतर निर्देशांक बताता है. -
locationRadius
पैरामीटर वह ज़्यादा से ज़्यादा दूरी तय करता है जो वीडियो के साथ जुड़ी जगह, वीडियो के बीच वाले हिस्से से हो सकती है, ताकि वीडियो को खोज नतीजों में अब भी शामिल किया जा सके.
-
13 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन कीinvideoPromotion.items[]
प्रॉपर्टी अपडेट की गई है. इस अपडेट के बाद, चैनल पर आम तौर पर, प्रमोट किया गया सिर्फ़ एक आइटम सेट किया जा सकता है. अगर प्रमोट किए गए बहुत ज़्यादा आइटम डालने की कोशिश की जाती है, तो एपीआईtooManyPromotedItems
गड़बड़ी दिखाएगा. इसमें एचटीटीपी400
स्टेटस कोड होगा. -
channelSection
संसाधन में अब कुछ नई तरह के चुनिंदा कॉन्टेंट के बारे में जानकारी शामिल की जा सकती है.channelSection
संसाधन कीsnippet.type
प्रॉपर्टी अब इन वैल्यू के साथ काम करती है:postedPlaylists
- ऐसी प्लेलिस्ट जिन्हें चैनल के मालिक ने चैनल के गतिविधि फ़ीड में पोस्ट किया हैpostedVideos
- ऐसे वीडियो जिन्हें चैनल के मालिक ने चैनल के गतिविधि फ़ीड में पोस्ट किया हैsubscriptions
- वे चैनल जिनकी सदस्यता चैनल के मालिक ने ली है
-
video
संसाधन की नईcontentDetails.contentRating.ifcoRating
प्रॉपर्टी, उस रेटिंग की पहचान करती है जो किसी वीडियो को आयरिश फ़िल्म क्लासिफ़िकेशन ऑफ़िस से मिली है. -
watermark
संसाधन कीposition.cornerPosition
प्रॉपर्टी की परिभाषा अपडेट कर दी गई है. इसमें यह जानकारी दी गई है कि वॉटरमार्क हमेशा प्लेयर के सबसे ऊपर दाएं कोने में दिखता है. -
search.list
तरीके के लिएq
पैरामीटर की परिभाषा को अपडेट कर दिया गया है. इससे यह पता चला है कि खोज के लिए इस्तेमाल किए गए किसी शब्द से जुड़े वीडियो को हटाने के लिए, क्वेरी शब्द में बूलियन NOT (-
) ऑपरेटर का इस्तेमाल किया जा सकता है. यह वैल्यू, खोज के लिए इस्तेमाल हुए कई शब्दों में से किसी एक से जुड़े वीडियो ढूंढने के लिए, बूलियन OR (|
) ऑपरेटर का इस्तेमाल भी कर सकती है. -
search.list
कॉल के लिए एपीआई के रिस्पॉन्स में दिखाई जाने वालीpageInfo.totalResults
प्रॉपर्टी की परिभाषा को इस तरह अपडेट किया गया है कि यह वैल्यू अनुमान के मुताबिक है और हो सकता है कि यह सटीक वैल्यू न दिखाए. इसके अतिरिक्त, अधिकतम मान 1,000,000 है. पेजों को क्रम में लगाने वाले लिंक बनाने के लिए आपको इस वैल्यू का इस्तेमाल नहीं करना चाहिए. इसके बजाय,nextPageToken
औरprevPageToken
प्रॉपर्टी वैल्यू का इस्तेमाल करके यह तय करें कि पेज पर नंबर डालने वाले लिंक दिखाने हैं या नहीं. -
watermarks.set
औरwatermarks.unset
तरीकों को अपडेट किया गया है, ताकि यह बताया जा सके कि एपीआई उन तरीकों के लिए किए गए अनुरोधों के जवाब में, एचटीटीपी204
रिस्पॉन्स कोड दिखाता है.
2 मई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
नया
i18nLanguage
संसाधन एक ऐसी ऐप्लिकेशन भाषा की पहचान करता है, जो YouTube वेबसाइट पर काम करती है. ऐप्लिकेशन की भाषा को यूज़र इंटरफ़ेस (यूआई) की भाषा के रूप में भी देखा जा सकता है. YouTube वेबसाइट के लिए, Google खाते की सेटिंग, ब्राउज़र की भाषा या आईपी लोकेशन के आधार पर, ऐप्लिकेशन की भाषा अपने-आप चुनी जा सकती है. साथ ही, YouTube के साइट फ़ुटर से, उपयोगकर्ता मैन्युअल तरीके से भी अपनी पसंदीदा यूज़र इंटरफ़ेस (यूआई) भाषा चुन सकता है.एपीआई, ऐप्लिकेशन के लिए इस्तेमाल की जा सकने वाली भाषाओं की सूची तैयार करने का एक तरीका उपलब्ध कराता है.
videoCategories.list
औरguideCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय, उन भाषाओं का इस्तेमाल किया जा सकता है जिनमेंhl
पैरामीटर की वैल्यू हो. -
नया
i18nRegion
संसाधन उस भौगोलिक इलाके की पहचान करता है जिसे YouTube इस्तेमाल करने वाला व्यक्ति, अपनी पसंद के कॉन्टेंट क्षेत्र के रूप में चुन सकता है. कॉन्टेंट क्षेत्र को कॉन्टेंट स्थान-भाषा भी कहा जा सकता है. YouTube वेबसाइट के लिए, YouTube डोमेन या उपयोगकर्ता के आईपी पते जैसे अनुभव के आधार पर कॉन्टेंट का इलाका अपने-आप चुना जा सकता है. साथ ही, उपयोगकर्ता YouTube साइट के फ़ुटर से, मैन्युअल तरीके से भी अपनी पसंद का कॉन्टेंट चुन सकता है.एपीआई, इस्तेमाल किए जा सकने वाले कॉन्टेंट क्षेत्रों की सूची तैयार करने का तरीका उपलब्ध कराता है.
search.list
,videos.list
,activities.list
, औरvideoCategories.list
जैसे एपीआई के तरीकों को कॉल करते समय, इस्तेमाल किए जा सकने वाले रीजन कोड का इस्तेमाल,regionCode
पैरामीटर की वैल्यू के तौर पर किया जा सकता है.
7 अप्रैल, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
नए
channelSection
संसाधन में वीडियो के उस सेट के बारे में जानकारी होती है जिसे किसी चैनल ने दिखाने के लिए चुना है. उदाहरण के लिए, किसी सेक्शन में चैनल के हाल ही में अपलोड किए गए वीडियो, सबसे लोकप्रिय वीडियो या एक या एक से ज़्यादा प्लेलिस्ट के वीडियो दिखाए जा सकते हैं.यह एपीआई, चैनल के सेक्शन को सूची में शामिल करने, शामिल करने, अपडेट करने या मिटाने के तरीकों का इस्तेमाल करता है. किसी खास चैनल आईडी की जानकारी देकर या यूनीक चैनल सेक्शन आईडी की सूची बताकर, पुष्टि किए गए उपयोगकर्ता के चैनल के चैनल सेक्शन की सूची फिर से हासिल की जा सकती है.
गड़बड़ी के उन मैसेज की जानकारी देने के लिए गड़बड़ी से जुड़े दस्तावेज़ को भी अपडेट कर दिया गया है जो एपीआई, इन नए तरीकों के लिए खास तौर पर काम करता है.
-
video
संसाधन केfileDetails
ऑब्जेक्ट की परिभाषा को अपडेट कर दिया गया है. इससे यह पता चलेगा कि वीडियो कीprocessingDetails.fileDetailsAvailability
प्रॉपर्टी की वैल्यूavailable
होने पर ही, ऑब्जेक्ट को दिखाया जाएगा.इसी तरह,
video
संसाधन केsuggestions
ऑब्जेक्ट की परिभाषा को यह बताने के लिए अपडेट किया गया है कि ऑब्जेक्ट को सिर्फ़ तब दिखाया जाएगा, जब वीडियो कीprocessingDetails.tagSuggestionsAvailability
प्रॉपर्टी या उसकीprocessingDetails.editorSuggestionsAvailability
प्रॉपर्टी की वैल्यूavailable
हो. -
videos.insert
औरvideos.update
के तरीकों के दस्तावेज़ अपडेट कर दिए गए हैं. इससे यह जानकारी मिलेगी कि इन तरीकों को कॉल करते समय,status.publishAt
प्रॉपर्टी को सेट किया जा सकता है. -
channel
संसाधन केinvideoPromotion
ऑब्जेक्ट की परिभाषा को अपडेट कर दिया गया है, ताकि यह बताया जा सके कि ऑब्जेक्ट को सिर्फ़ चैनल का मालिक ही वापस ला सकता है. -
videos.rate
तरीके की पैरामीटर सूची को अपडेट कर दिया गया है. इससे यह जानकारी मिलेगी कि यह तरीका असल मेंonBehalfOfContentOwner
पैरामीटर के साथ काम नहीं करता. यह दस्तावेज़ में एक गड़बड़ी थी, क्योंकि इस पैरामीटर को सेट करने वालेvideos.rate
अनुरोध में500
गड़बड़ी दिखती है.
31 मार्च, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
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
channels.update
तरीका यह गड़बड़ी तब दिखाता है, जबinvideoPromotion.items[].id.websiteUrl
प्रॉपर्टी ऐसा यूआरएल तय करती है जिसकी अनुमति नहीं है.required (400)
requiredTimingType
channels.update
तरीका, गड़बड़ी का यह मैसेज तब दिखाता है, जब किसी अनुरोध में YouTube को प्रमोट किया गया आइटम दिखाने के समय की डिफ़ॉल्ट सेटिंग तय न की गई हो.required (400)
requiredTiming
प्रमोट किए गए हर आइटम के लिए, channels.update
तरीके में एकinvideoPromotion.items[].timing
ऑब्जेक्ट देना ज़रूरी है.required (400)
requiredWebsiteUrl
प्रमोट किए गए हर आइटम के लिए, channels.update
वाले तरीके मेंinvideoPromotion.items[].id.websiteUrl
प्रॉपर्टी की जानकारी देना ज़रूरी है.badRequest (400)
invalidPublishAt
अगर अनुरोध के मेटाडेटा में शेड्यूल पब्लिश करने का गलत समय दिया गया है, तो videos.insert
तरीका गड़बड़ी का यह मैसेज दिखाता है.
4 मार्च, 2014
इस अपडेट में ये बदलाव शामिल हैं:
-
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
(वीएपी) – बच्चों के साथ वयस्क होना चाहिए.mibacVm6
(V.M.6) – 6 साल और इससे ज़्यादा उम्र के लोगों के लिए.mibacVm12
(V.M.12) – 12 साल और उससे ज़्यादा उम्र के लोगों के लिए.
-
channel
रिसॉर्स की नईinvideoPromotion.items[].promotedByContentOwner
प्रॉपर्टी से पता चलता है कि प्रमोशन को दिखाते समय कॉन्टेंट के मालिक का नाम दिखाया जाएगा या नहीं. इस फ़ील्ड को सिर्फ़ तब सेट किया जा सकता है, जब वैल्यू सेट करने वाला एपीआई अनुरोध, कॉन्टेंट के मालिक की ओर से किया जा रहा हो. ज़्यादा जानकारी के लिए,onBehalfOfContentOwner
पैरामीटर देखें.
1 अक्टूबर, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन के नएauditDetails
ऑब्जेक्ट में, चैनल का डेटा होता है. कई चैनलों का नेटवर्क (एमसीएन), इसका आकलन करके यह तय करता है कि किसी चैनल को स्वीकार करना है या अस्वीकार करना है. ध्यान दें कि रिसॉर्स के इस हिस्से को फिर से हासिल करने वाले एपीआई अनुरोध के लिए, अनुमति वाला एक टोकन देना होगा, जिसमेंhttps://www.googleapis.com/auth/youtubepartner-channel-audit
स्कोप शामिल हो. इसके अलावा, जब एमसीएन किसी चैनल को स्वीकार या अस्वीकार करने का फ़ैसला लेता है, तो उस दायरे का इस्तेमाल करने वाले किसी भी टोकन को रद्द करना ज़रूरी है. इसके अलावा, टोकन जारी करने की तारीख से दो हफ़्ते के अंदर ऐसा करना ज़रूरी है. -
channel
संसाधन कीinvideoPromotion.items[].id.type
प्रॉपर्टी में अबrecentUpload
वैल्यू काम करती है. इससे पता चलता है कि प्रमोट किया गया आइटम, किसी खास चैनल से हाल ही में अपलोड किया गया वीडियो है.डिफ़ॉल्ट रूप से, चैनल वही होता है जिसके लिए वीडियो में प्रमोशन का डेटा सेट किया गया है. हालांकि, किसी दूसरे चैनल के हाल ही में अपलोड किए गए वीडियो का प्रमोशन किया जा सकता है. इसके लिए, आपको उस चैनल के चैनल आईडी पर नई
invideoPromotion.items[].id.recentlyUploadedBy
प्रॉपर्टी की वैल्यू सेट करनी होगी. -
channel
संसाधन में तीन नई प्रॉपर्टी शामिल हैं –brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
,brandingSettings.image.bannerTvHighImageUrl
– जो टेलीविज़न ऐप्लिकेशन में चैनल पेज पर दिखने वाली बैनर इमेज के यूआरएल तय करती हैं. -
खोज के नतीजों में नई
snippet.liveBroadcastContent
प्रॉपर्टी से पता चलता है कि किसी वीडियो या चैनल के संसाधन में लाइव ब्रॉडकास्ट कॉन्टेंट मौजूद है या नहीं. प्रॉपर्टी की मान्य वैल्यूupcoming
,active
, औरnone
हैं.video
संसाधन के लिए,upcoming
वैल्यू का मतलब है कि वीडियो एक लाइव ब्रॉडकास्ट है, जो अभी तक शुरू नहीं हुआ है. वहीं,active
वैल्यू का मतलब है कि वीडियो पर अभी लाइव ब्रॉडकास्ट चल रहा है.channel
संसाधन के लिए,upcoming
वैल्यू का मतलब है कि चैनल में एक शेड्यूल किया गया ब्रॉडकास्ट है, जो अभी तक शुरू नहीं हुआ है. वहीं,acive
वैल्यू का मतलब है कि चैनल पर कोई लाइव ब्रॉडकास्ट चल रहा है.
-
watermark
संसाधन में,targetChannelId
प्रॉपर्टी को एक ऑब्जेक्ट से स्ट्रिंग में बदल दिया गया है. वॉटरमार्क इमेज से लिंक किए गए चैनल के YouTube चैनल आईडी के बारे में बताने वाली चाइल्ड प्रॉपर्टी,targetChannelId
प्रॉपर्टी में खुद वैल्यू के बारे में नहीं बताती. इसलिए, संसाधन कीtargetChannelId.value
प्रॉपर्टी हटा दी गई है. -
अब
thumbnails.set
तरीका,onBehalfOfContentOwner
पैरामीटर के साथ काम करता है, जो पहले से ही कई अन्य तरीकों के लिए इस्तेमाल किया जा सकता है. -
अब
search.list
तरीका,eventType
पैरामीटर के साथ काम करता है. इस पैरामीटर से खोज करने पर सिर्फ़ चालू, आने वाले या पूरे हो चुके ब्रॉडकास्ट इवेंट में से कोई इवेंट दिखाया जाता है. -
contentDetails.contentRating.mibacRating
की नई प्रॉपर्टी, उस वीडियो को मिली रेटिंग की पहचान करती है जो इटली के मिनिस्टरो dei Beni e delle Attivita Culturali e del Turismo से मिला है. -
एपीआई अब नीचे दी गई गड़बड़ियों के साथ काम करता है:
गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
invalidImage
अगर दी गई इमेज का कॉन्टेंट अमान्य है, तो thumbnails.set
तरीका यह गड़बड़ी दिखाता है.forbidden
videoRatingDisabled
videos.rate
तरीका यह गड़बड़ी तब दिखाता है, जब रेट किए जा रहे वीडियो के मालिक ने उस वीडियो की रेटिंग बंद कर दी हों.
27 अगस्त, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
नया
watermark
संसाधन, उस इमेज की पहचान करता है जो किसी चैनल के वीडियो को चलाने के दौरान दिखती है. आपके पास टारगेट किए गए उस चैनल को भी तय करने का विकल्प है जिसमें इमेज लिंक होगी. साथ ही, वीडियो चलाने के समय की जानकारी भी दी जा सकती है, जिससे यह तय होता है कि वीडियो चलाने के दौरान वॉटरमार्क कब दिखेगा और कितनी देर तक दिखेगा.watermarks.set
तरीका, चैनल की वॉटरमार्क इमेज अपलोड और सेट करता है.watermarks.unset
तरीका, चैनल की वॉटरमार्क इमेज को मिटाता है.गड़बड़ी के दस्तावेज़ में गड़बड़ी के उन मैसेज की जानकारी दी गई है जो एपीआई, खास तौर पर
watermarks.set
औरwatermarks.unset
तरीकों के लिए काम करता है. -
channel
रिसॉर्स की नईstatistics.hiddenSubscriberCount
प्रॉपर्टी में, एक बूलियन वैल्यू है. इससे पता चलता है कि चैनल के सदस्यों की संख्या छिपी हुई है या नहीं. इसलिए, अगर चैनल के सदस्यों की संख्या सार्वजनिक तौर पर दिखती है, तो प्रॉपर्टी की वैल्यूfalse
होगी. -
playlists.list
तरीका अबonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करता है. दोनों पैरामीटर, पहले से ही कई और तरीकों के साथ काम करते हैं. -
videos.list
तरीका, अबregionCode
पैरामीटर के साथ काम करता है. यह पैरामीटर उस कॉन्टेंट एरिया की पहचान करता है जिसके लिए चार्ट को फिर से हासिल किया जाना चाहिए. इस पैरामीटर का इस्तेमाल, सिर्फ़chart
पैरामीटर के साथ किया जा सकता है. पैरामीटर की वैल्यू, देश का एक ISO 3166-1 ऐल्फ़ा-2 कोड है. -
error documentation
में अनुरोध से जुड़ी नीचे दी गई नई सामान्य गड़बड़ी के बारे में बताया गया है, जो एपीआई के एक से ज़्यादा तरीकों में हो सकती है:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा forbidden
insufficientPermissions
अनुरोध के लिए दिए गए OAuth 2.0 टोकन से जुड़े दायरे, अनुरोध किए गए डेटा को ऐक्सेस करने के लिए काफ़ी नहीं हैं.
15 अगस्त, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channel
संसाधन केinvideoPromotion
ऑब्जेक्ट में, ये नई और अपडेट की गई प्रॉपर्टी शामिल हैं:-
अब एपीआई की मदद से किसी वेबसाइट को प्रमोट किए गए आइटम के तौर पर मार्क किया जा सकता है. ऐसा करने के लिए,
invideoPromotion.items[].id.type
प्रॉपर्टी की वैल्यू कोwebsite
पर सेट करें. साथ ही, यूआरएल बताने के लिए,invideoPromotion.items[].id.websiteUrl
की नई प्रॉपर्टी का इस्तेमाल करें. साथ ही, प्रमोशन में दिखाने के लिए कस्टम मैसेज तय करने के लिए, नईinvideoPromotion.items[].customMessage
प्रॉपर्टी का इस्तेमाल करें.लिंक, जुड़ी हुई वेबसाइटों, व्यापारी/कंपनी की साइटों या सोशल नेटवर्किंग साइटों के हो सकते हैं. अपने कॉन्टेंट के लिए लिंक चालू करने के बारे में ज़्यादा जानने के लिए, YouTube के सहायता केंद्र पर जाकर जुड़ी वेबसाइटों और कारोबारी या कंपनी की साइटों के लिए दिए गए निर्देश देखें.
प्रमोशन के लिंक जोड़कर, आप इस बात से सहमत हैं कि उन लिंक का इस्तेमाल, ट्रैफ़िक को बिना अनुमति वाली साइटों पर रीडायरेक्ट करने के लिए नहीं किया जाएगा. साथ ही, ये लिंक YouTube की AdWords नीतियों, YouTube की विज्ञापन नीतियों, YouTube के कम्यूनिटी दिशा-निर्देशों, और YouTube की सेवा की शर्तों के मुताबिक होने चाहिए.
-
वीडियो चलाने के दौरान प्रमोट किए गए आइटम दिखाने की समय सेटिंग से जुड़ी प्रॉपर्टी को फिर से बनाया गया है:
-
invideoPromotion.timing
ऑब्जेक्ट कोinvideoPromotion.items[].timing
में ले जाया गया. इस ऑब्जेक्ट की मदद से, अबinvideoPromotion.items[]
सूची में प्रमोट किए गए हर आइटम के लिए, समय से जुड़े डेटा को अपनी पसंद के मुताबिक बनाया जा सकता है. -
नया
invideoPromotion.defaultTiming
ऑब्जेक्ट, आपके प्रमोशन के लिए समय की डिफ़ॉल्ट सेटिंग तय करता है. इन सेटिंग से यह तय होता है कि आपके चैनल के किसी वीडियो को चलाने के दौरान, प्रमोट किया गया आइटम कब दिखेगा.invideoPromotion.items[].timing
ऑब्जेक्ट का इस्तेमाल करके, प्रमोट किए गए किसी भी आइटम के लिए डिफ़ॉल्ट समय को बदला जा सकता है. -
नई
invideoPromotion.items[].timing.durationMs
प्रॉपर्टी में, प्रमोशन दिखाने में लगने वाले समय की जानकारी मिलीसेकंड में दी जाती है.invideoPromotion.defaultTiming
ऑब्जेक्ट मेंdurationMs
फ़ील्ड भी होता है. इससे यह पता चलता है कि प्रमोट किया गया आइटम कब दिखेगा.
-
-
invideoPromotion.items[].type
औरinvideoPromotion.items[].videoId
प्रॉपर्टी, दोनों कोinvideoPromotion.items[].id
ऑब्जेक्ट में ले जाया गया है.
-
-
subscriptions.list
तरीका अबonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर के साथ काम करता है. दोनों पैरामीटर, पहले से ही कई और तरीकों के साथ काम करते हैं. -
thumbnails.set
के अनुरोध के एपीआई के रिस्पॉन्स में,kind
प्रॉपर्टी की वैल्यूyoutube#thumbnailListResponse
से बदलकरyoutube#thumbnailSetResponse
हो गई है. -
इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(फ़िलिपीन पेसो)videos.list
(फ़िलिपीन पेसो)videos.rate
(Python)videos.update
(Java, PHP, Python)
ध्यान दें कि
playlistItems.insert
तरीके के लिए Python के उदाहरण को भी हटा दिया गया है, क्योंकि इसमें दिखाई गई सुविधा को अबvideos.rate
तरीके से मैनेज किया जा रहा है. -
error documentation
में अनुरोध के कॉन्टेक्स्ट से जुड़ी यहां दी गई नई गड़बड़ी के बारे में बताया गया है. यह गड़बड़ी,mine
अनुरोध पैरामीटर के साथ काम करने वाले किसी भी एपीआई तरीके से हो सकती है:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
invalidMine
mine
पैरामीटर का इस्तेमाल उन अनुरोधों में नहीं किया जा सकता है, जहां पुष्टि किया गया उपयोगकर्ता YouTube पार्टनर है. आपकोmine
पैरामीटर को हटा देना चाहिए,onBehalfOfContentOwner
पैरामीटर को हटाकर, YouTube उपयोगकर्ता के तौर पर पुष्टि करनी चाहिए. इसके अलावा, अगर कॉल किए गए तरीके के लिए उपलब्ध हो, तोonBehalfOfContentOwnerChannel
पैरामीटर देकर, पार्टनर के एक चैनल के तौर पर काम करना चाहिए.
8 अगस्त, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Data API का इस्तेमाल शुरू करना गाइड के कोटा का इस्तेमाल सेक्शन अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि वीडियो अपलोड करने की कोटा लागत को करीब 16,000 यूनिट से बदलकर करीब 1600 यूनिट कर दिया गया हो.
30 जुलाई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
channelBanner
संसाधन में,kind
प्रॉपर्टी की वैल्यू कोyoutube#channelBannerInsertResponse
से बदलकरyoutube#channelBannerResource
कर दिया गया है. यह संसाधनchannelBanners.insert
के अनुरोध के जवाब में मिलता है. -
channel
संसाधन की नईbrandingSettings.channel.profileColor
प्रॉपर्टी, चैनल के कॉन्टेंट को बेहतर तरीके से दिखाने वाले रंग के बारे में बताती है. प्रॉपर्टी की वैल्यू, पाउंड का निशान (#
) होती है. इसके बाद, छह वर्णों की हेक्साडेसिमल स्ट्रिंग होती है, जैसे कि#2793e6
. -
एपीआई अब यह तय करने की सुविधा देता है कि सदस्यता, चैनल की सभी गतिविधियों के लिए है या सिर्फ़ नए वीडियो के लिए.
subscription
संसाधन की नईcontentDetails.activityType
प्रॉपर्टी, अलग-अलग तरह की उन गतिविधियों की पहचान करती है जिनके बारे में सदस्य को सूचना दी जाती है. प्रॉपर्टी की मान्य वैल्यूall
औरuploads
हैं. -
videos.list
तरीका, YouTube पर सबसे ज़्यादा लोकप्रिय वीडियो का चार्ट पाने के लिए, नए पैरामीटर के साथ काम करता है:chart
पैरामीटर उस चार्ट की पहचान करता है जिसे आपको वापस लाना है. फ़िलहाल,mostPopular
वैल्यू ही इस्तेमाल की जा सकती हैं. ध्यान दें किchart
पैरामीटर एक फ़िल्टर पैरामीटर है. इसका मतलब है कि इसे अन्य फ़िल्टर पैरामीटर (id
औरmyRating
) की तरह उसी अनुरोध में इस्तेमाल नहीं किया जा सकता.videoCategoryId
पैरामीटर उस वीडियो कैटगरी की पहचान करता है जिसके लिए चार्ट को फिर से हासिल किया जाना चाहिए. इस पैरामीटर का इस्तेमाल, सिर्फ़chart
पैरामीटर के साथ किया जा सकता है. डिफ़ॉल्ट रूप से, चार्ट किसी खास कैटगरी के लिए सीमित नहीं होते.
-
video
संसाधन की नईtopicDetails.relevantTopicIds[]
प्रॉपर्टी, Freebase के ऐसे विषय आईडी की सूची देती है जो वीडियो या उसके कॉन्टेंट के हिसाब से सही हैं. इन विषयों के विषय वीडियो में दिखाए जा सकते हैं या दिखाए जा सकते हैं. -
video
रिसॉर्स कीrecordingDetails.location.elevation
प्रॉपर्टी का नाम बदलकर,recordingDetails.location.altitude
कर दिया गया है. साथ ही, इसकीfileDetails.recordingLocation.location.elevation
प्रॉपर्टी का नाम बदलकरfileDetails.recordingLocation.location.altitude
कर दिया गया है. -
video
संसाधन काcontentDetails.contentRating
ऑब्जेक्ट, किसी वीडियो को अलग-अलग रेटिंग स्कीम के तहत मिलने वाली रेटिंग के बारे में बताता है. इनमें MPAA रेटिंग, TVPG रेटिंग वगैरह शामिल हैं. हर रेटिंग सिस्टम के लिए, एपीआई अब रेटिंग की एक वैल्यू का इस्तेमाल करता है. इससे पता चलता है कि वीडियो को रेटिंग नहीं दी गई है. ध्यान दें कि 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 के उन एपीआई की सूची देते हैं जो बंद होने की नीति के दायरे में आते हैं.
8 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
चैनल के संसाधन अब
inVideoPromotion
ऑब्जेक्ट के साथ काम करते हैं. इसमें चैनल से जुड़े प्रमोशन कैंपेन की जानकारी शामिल होती है. कोई चैनल इन-वीडियो प्रमोशन कैंपेन का इस्तेमाल करके, वीडियो प्लेयर में प्रमोट किए गए वीडियो की थंबनेल इमेज दिखा सकता है. ऐसा, चैनल के वीडियो चलाने के दौरान किया जा सकता है.channels.list
अनुरोध में,part
पैरामीटर की वैल्यू मेंinvideoPromotion
को शामिल करके, यह डेटा वापस पाया जा सकता है. -
channels.update
के नए तरीके का इस्तेमाल, चैनल के इन-वीडियो प्रमोशनल कैंपेन डेटा को अपडेट करने के लिए किया जा सकता है. ध्यान दें कि यह तरीका सिर्फ़channel
संसाधन केinvideoPromotion
हिस्से के लिए अपडेट के साथ काम करता है. फ़िलहाल, इस संसाधन के दूसरे हिस्सों के अपडेट के लिए, इस तरीके का इस्तेमाल नहीं किया जा सकता.
2 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
चैनल संसाधन अब
status.isLinked
प्रॉपर्टी के साथ काम करते हैं. इससे पता चलता है कि चैनल का डेटा, पहले से किसी YouTube उपयोगकर्ता नाम या Google+ खाते से जुड़े उपयोगकर्ता की पहचान करता है या नहीं. जिस उपयोगकर्ता के पास इनमें से कोई एक लिंक है उसकी YouTube पर सार्वजनिक पहचान पहले से ही है. यह कई कार्रवाइयों के लिए एक ज़रूरी शर्त है, जैसे कि वीडियो अपलोड करना. -
सदस्यता के संसाधन अब
subscriberSnippet
वाले हिस्से के साथ काम करते हैं. उस ऑब्जेक्ट में सदस्य के चैनल का स्निपेट डेटा शामिल होता है. -
यह एपीआई अब
videos.getRating
तरीके के साथ काम करता है. इससे उन रेटिंग का पता चलता है जो प्रमाणित उपयोगकर्ता ने एक या एक से ज़्यादा वीडियो की सूची को दी थीं. -
videos.list
तरीके के नएmyRating
पैरामीटर की मदद से, ऐसे वीडियो की सूची वापस पाई जा सकती है जिन्हें पुष्टि किए गए उपयोगकर्ता नेlike
याdislike
रेटिंग से रेटिंग दी है.myRating
पैरामीटर औरid
पैरामीटर, दोनों को अब फ़िल्टर पैरामीटर माना जाता है. इसका मतलब है कि एपीआई अनुरोध में सिर्फ़ एक पैरामीटर होना चाहिए. (पहले, इस तरीके के लिएid
पैरामीटर ज़रूरी पैरामीटर था.)यह तरीका, ऐसे अनुरोधों के लिए
forbidden
गड़बड़ी दिखाता है जो वीडियो रेटिंग की जानकारी पाने की कोशिश करते हैं, लेकिन उन्हें ऐसा करने की अनुमति नहीं है. -
myRating
पैरामीटर की शुरुआत के साथ ही, खोज नतीजों को पेजों में बांटने के लिएvideos.list
तरीके को भी अपडेट किया गया है. हालांकि, ध्यान दें कि पेजिंग पैरामीटर सिर्फ़myRating
पैरामीटर का इस्तेमाल करने वाले अनुरोधों के लिए काम करते हैं. (id
पैरामीटर का इस्तेमाल करने वाले अनुरोधों के लिए, पेजिंग पैरामीटर और जानकारी काम नहीं करती.)-
maxResults
पैरामीटर से पता चलता है कि एपीआई, खोज नतीजों के सेट में ज़्यादा से ज़्यादा कितने वीडियो दिखा सकता है. वहीं,pageToken
पैरामीटर, खोज नतीजों के सेट से उस पेज की पहचान करता है जिसे आपको वापस लाना है. -
youtube#videoListResponse
संसाधन कोvideos.list
के अनुरोध के जवाब में दिखाया जाता है. इसमें अबpageInfo
ऑब्जेक्ट शामिल है. इसमें, मौजूदा नतीजों के सेट में शामिल नतीजों की कुल संख्या और नतीजों की संख्या जैसी जानकारी होती है.youtube#videoListResponse
संसाधन मेंnextPageToken
औरprevPageToken
प्रॉपर्टी भी शामिल हो सकती हैं. इनमें से हर प्रॉपर्टी एक टोकन देती है. इसका इस्तेमाल, खोज नतीजों के सेट से किसी खास पेज को वापस पाने के लिए किया जा सकता है.
-
-
videos.insert
वाला तरीका, इन नए पैरामीटर के साथ काम करता है:autoLevels
– इस पैरामीटर वैल्यू कोtrue
पर सेट करें, ताकि YouTube को वीडियो की रोशनी और रंग को अपने-आप बेहतर बनाने का निर्देश मिल सके.stabilize
– इस पैरामीटर वैल्यू कोtrue
पर सेट करें, ताकि YouTube को वीडियो अडजस्ट करने का निर्देश दिया जा सके. इसके लिए, कैमरे की मोशन से आने वाली हलचल को हटाना होगा.
-
इन संसाधनों के लिए,
channelTitle
प्रॉपर्टी कोsnippet
में जोड़ा गया है:playlistItem
– प्रॉपर्टी उस चैनल का नाम बताती है जिसने प्लेलिस्ट में आइटम जोड़ा है.playlist
– प्रॉपर्टी, प्लेलिस्ट बनाने वाले चैनल का नाम बताती है.subscription
– प्रॉपर्टी, उस चैनल का नाम बताती है जिसकी सदस्यता ली गई है.
-
इन तरीकों के लिए कोड सैंपल जोड़े गए हैं:
activities.insert
(रूबी)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, Ruby)
-
subscriptions.list
तरीके के नएmySubscribers
पैरामीटर की मदद से, पुष्टि किए गए मौजूदा उपयोगकर्ता के सदस्यों की सूची वापस पाई जा सकती है. इस पैरामीटर का इस्तेमाल, सिर्फ़ ऐसे अनुरोध में किया जा सकता है जिसे अनुमति मिली हो.ध्यान दें: इस सुविधा का मकसद,
channels.list
तरीके के साथ काम करने वालेmySubscribers
पैरामीटर को बदलना है. वह पैरामीटर बहिष्कृत कर दिया जाएगा. -
video
संसाधन में, यहां दी गई प्रॉपर्टी के लिएunspecified
प्रॉपर्टी की वैल्यू का इस्तेमाल नहीं किया जा सकता: -
ऐसे एपीआई अनुरोधों में जिनमें अनचाहा पैरामीटर शामिल होता है, अब
badRequest
गड़बड़ी दिखाते हैं. गड़बड़ी की रिपोर्ट की गई वजहunexpectedParameter
है. -
प्लेलिस्ट में अनुमति वाले ज़्यादा से ज़्यादा आइटम पहले से ही मौजूद होने पर,
playlistItems.insert
तरीके से गड़बड़ी मिलने वाली गड़बड़ी को अपडेट कर दिया गया है. इस गड़बड़ी को अबforbidden
गड़बड़ी के तौर पर रिपोर्ट किया गया है और इसकी वजहplaylistContainsMaximumNumberOfVideos
है.
19 अप्रैल, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
videos.rate
वाले नए तरीके से, उपयोगकर्ता किसी वीडियो के लिएlike
याdislike
रेटिंग सेट कर सकता है. इसके अलावा, उस वीडियो से रेटिंग भी हटा सकता है.गड़बड़ी से जुड़े दस्तावेज़ में उन गड़बड़ियों की सूची भी अपडेट कर दी गई है जो
videos.rate
तरीके से किए गए कॉल के जवाब में एपीआई को दिख सकती हैं. -
थंबनेल इमेज की पहचान अब एपीआई दस्तावेज़ में एक अलग संसाधन के तौर पर की गई है.
thumbnails.set
वाले नए तरीके की मदद से, YouTube पर कस्टम वीडियो थंबनेल अपलोड किया जा सकता है और उसे वीडियो के लिए सेट किया जा सकता है.गड़बड़ी से जुड़े दस्तावेज़ में उन गड़बड़ियों की सूची भी अपडेट कर दी गई है जो
thumbnails.set
तरीके से किए गए कॉल के जवाब में एपीआई को दिख सकती हैं.ध्यान दें कि इस बदलाव से, थंबनेल इमेज दिखाने वाले मौजूदा संसाधनों पर कोई असर नहीं पड़ेगा. थंबनेल इमेज को पहले की तरह ही उन रिसॉर्स में दिखाया जाता है. हालांकि, दस्तावेज़ में अब उन अलग-अलग साइज़ के थंबनेल के नाम दिए गए हैं जिन्हें एपीआई की मदद से दिखाया जा सकता है.
-
channel
संसाधन का नयाbrandingSettings
हिस्सा, चैनल के चैनल पेज और वीडियो के वॉच पेज की सेटिंग, टेक्स्ट, और इमेज की पहचान करता है. -
playlistItem
संसाधन में ये नई प्रॉपर्टी शामिल हैं:-
नए
status
ऑब्जेक्ट में, प्लेलिस्ट के आइटम की स्थिति की जानकारी शामिल होती है. साथ ही,status.privacyStatus
प्रॉपर्टी, प्लेलिस्ट के आइटम की निजता स्थिति की पहचान करती है.
-
-
video
संसाधन में ये नई प्रॉपर्टी शामिल हैं:-
status.publicStatsViewable
प्रॉपर्टी से पता चलता है कि वॉच पेज पर बड़े किए गए वीडियो से जुड़े आंकड़े सार्वजनिक तौर पर देखे जा सकते हैं या नहीं. डिफ़ॉल्ट रूप से, ये आंकड़े देखे जा सकते हैं. साथ ही, इस प्रॉपर्टी की वैल्यूfalse
पर सेट होने पर भी, वीडियो को देखे जाने की संख्या और रेटिंग जैसे आंकड़े सार्वजनिक तौर पर दिखते रहेंगे.videos.insert
याvideos.update
तरीके को कॉल करते समय, इस प्रॉपर्टी की वैल्यू सेट की जा सकती है. -
contentDetails.contentRating
ऑब्जेक्ट, उन रेटिंग को इकट्ठा करता है जो वीडियो को अलग-अलग रेटिंग स्कीम के तहत मिली हैं. नीचे दी गई सूची इस्तेमाल किए जा सकने वाले रेटिंग सिस्टम की पहचान करती है. साथ ही, हर रेटिंग सिस्टम से जुड़ी प्रॉपर्टी का लिंक भी देती है. प्रॉपर्टी की डेफ़िनिशन, हर सिस्टम के लिए इस्तेमाल की जा सकने वाली रेटिंग की वैल्यू की पहचान करती हैं.देश रेटिंग सिस्टम प्रॉपर्टी अमेरिका मोशन पिक्चर असोसिएशन ऑफ़ अमेरिका (एमपीएए) contentDetails.contentRating.mpaaRating
अमेरिका माता-पिता के लिए टीवी से जुड़े दिशा-निर्देश contentDetails.contentRating.tvpgRating
ऑस्ट्रेलिया ऑस्ट्रेलियन क्लासिफ़िकेशन बोर्ड (एसीबी) contentDetails.contentRating.acbRating
ब्राज़ील Deparamento de Justiça, Classificação, Qualificação e Títules के साथ contentDetails.contentRating.djctqRating
कनाडा कैनेडियन होम वीडियो रेटिंग सिस्टम (सीएचवीआरएस) contentDetails.contentRating.chvrsRating
फ़्रांस Center National du cinéma et de l'image animée (फ़्रेंच मिनिस्ट्री ऑफ़ कल्चर) contentDetails.contentRating.fmocRating
जर्मनी फ़्रीविलेज सेल्बस्टकोंट्रोल डे फ़िल्मवर्टसाफ़्ट (एफ़एसके) contentDetails.contentRating.fskRating
ग्रेट ब्रिटेन ब्रिटिश बोर्ड ऑफ़ फ़िल्म क्लासिफ़िकेशन (बीबीएफ़सी) contentDetails.contentRating.bbfcRating
भारत केंद्रीय फ़िल्म सर्टिफ़िकेशन बोर्ड (सीबीएफ़सी) contentDetails.contentRating.cbfcRating
जापान 映倫管理委員会 (ईआईआरआईएन) contentDetails.contentRating.eirinRating
कोरिया 영상물등위원 बांटे (केएमआरबी) contentDetails.contentRating.kmrbRating
मेक्सिको जनरल डायरेक्ट्रेट ऑफ़ रेडियो, टेलीविज़न ऐंड सिनेमैटोग्राफ़ी (आरटीसी) contentDetails.contentRating.rtcRating
न्यूज़ीलैंड ऑफ़िस ऑफ़ फ़िल्म ऐंड लिटरेचर क्लासिफ़िकेशन contentDetails.contentRating.oflcRating
रूस नैशनल फ़िल्म रजिस्ट्री ऑफ़ द रशियन फ़ेडरेशन contentDetails.contentRating.russiaRating
स्पेन इंस्तितूतो दे ला सिनेमेतोग्राफ़िया ई दे लास आर्तेस ऑडियोविज़ुअलेज़ (आईसीएए) contentDetails.contentRating.icaaRating
-
-
playlistItems.update
तरीके के दस्तावेज़ को अपडेट कर दिया गया है, ताकि यह बताया जा सके किsnippet.resourceId
प्रॉपर्टी को, अनुरोध के मुख्य हिस्से के तौर पर भेजे गए संसाधन में बताया जाना चाहिए. -
search.list
तरीका अब इन फ़ंक्शन के साथ काम करता है:-
नया
forMine
पैरामीटर, खोज करने पर सिर्फ़ उस उपयोगकर्ता के वीडियो को वापस लाने से रोकता है जिसकी पुष्टि हो चुकी है. -
अब
order
पैरामीटर की मदद से, नतीजों को टाइटल (order=title
) या वीडियो की गिनती को घटते क्रम (order=videoCount
) के हिसाब से, अंग्रेज़ी वर्णमाला के क्रम में लगाया जा सकता है. -
नए
safeSearch
पैरामीटर से पता चलता है कि खोज के नतीजों में प्रतिबंधित कॉन्टेंट होना चाहिए या नहीं.
-
-
videos.insert
तरीके में, कई नई गड़बड़ियां लागू की जा सकती हैं. ये गड़बड़ियां नीचे टेबल में दी गई हैं:गड़बड़ी का टाइप गड़बड़ी विवरण ब्यौरा badRequest
invalidCategoryId
snippet.categoryId
प्रॉपर्टी में एक अमान्य कैटगरी आईडी दिया गया है. इस्तेमाल की जा सकने वाली कैटगरी को वापस पाने के लिए,videoCategories.list
तरीके का इस्तेमाल करें.badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
अनुरोध के मेटाडेटा में वीडियो गेम की गलत रेटिंग दी गई है. badRequest
invalidVideoMetadata
अनुरोध का मेटाडेटा अमान्य है. -
videos.update
औरvideos.delete
तरीकों के लिए इस्तेमाल किए जा सकने वाले पैरामीटर की सूची से,onBehalfOfContentOwner
पैरामीटर को हटा दिया गया है.
12 मार्च, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
इन संसाधनों के लिए,
channelTitle
प्रॉपर्टी कोsnippet
में जोड़ा गया है: -
search.list
वाला तरीका, इन नए पैरामीटर के साथ काम करता है:-
channelType
पैरामीटर की मदद से, सभी चैनलों या सिर्फ़ शो को वापस पाने के लिए, चैनलों की खोज को सीमित किया जा सकता है. -
videoType
पैरामीटर की मदद से, सभी वीडियो को वापस लाने या सिर्फ़ फ़िल्में या शो के एपिसोड पाने के लिए, वीडियो खोजने पर पाबंदी लगाई जा सकती है.
-
-
video
संसाधन केrecordingDetails
वाले हिस्से की परिभाषा को इस तरह अपडेट किया गया है कि वीडियो के लिए ऑब्जेक्ट को तभी दिखाया जाएगा, जब वीडियो की भौगोलिक जगह का डेटा या रिकॉर्डिंग का समय सेट किया गया हो. -
playlistItems.update
तरीका अबinvalidSnippet
गड़बड़ी दिखाता है. यह गड़बड़ी तब दिखती है, जब एपीआई अनुरोध में किसी मान्य स्निपेट की जानकारी नहीं होती. -
एपीआई के कई तरीके, ऐसे नए पैरामीटर के साथ काम करते हैं जो खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए बने हैं. YouTube कॉन्टेंट पार्टनर में फ़िल्म और टेलीविज़न स्टूडियो, रिकॉर्ड लेबल, और ऐसे दूसरे कॉन्टेंट क्रिएटर शामिल हैं जो YouTube पर अपना कॉन्टेंट उपलब्ध कराते हैं.
-
onBehalfOfContentOwner
पैरामीटर से पता चलता है कि अनुरोध की अनुमति के क्रेडेंशियल, YouTube कॉन्टेंट मैनेजमेंट सिस्टम के ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर की वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. उपयोगकर्ता जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से पुष्टि करता है उसे YouTube कॉन्टेंट के बताए गए मालिक से लिंक होना चाहिए.यह पैरामीटर उन कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इस पैरामीटर की मदद से, पार्टनर एक बार पुष्टि कर पाते हैं और उन्हें अपने वीडियो और चैनल के सभी डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल की पुष्टि करने से जुड़े क्रेडेंशियल देने की ज़रूरत नहीं होती.
channels.list
,search.list
,videos.delete
,videos.list
, औरvideos.update
तरीके इस पैरामीटर के साथ काम करते हैं. -
channels.list
तरीके के साथ काम करने वालाmanagedByMe
पैरामीटर, एपीआई को कॉन्टेंट के मालिक के मालिकाना हक वाले उन सभी चैनलों को वापस करने के निर्देश देता है जिनके बारे मेंonBehalfOfContentOwner
पैरामीटर ने बताया है. -
search.list
तरीके के साथ काम करने वालाforContentOwner
पैरामीटर, एपीआई को यह निर्देश देता है कि वह खोज के नतीजों में सिर्फ़ ऐसे रिसॉर्स शामिल करे जिनका मालिकाना हकonBehalfOfContentOwner
पैरामीटर से पता चलता है.
-
25 फ़रवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
एपीआई,
video
संसाधनों के लिए कई नए पार्ट और प्रॉपर्टी के साथ काम करता है:-
नए
fileDetails
,processingDetails
, औरsuggestions
हिस्से, वीडियो के मालिकों को उनके अपलोड किए गए वीडियो की जानकारी देते हैं. यह डेटा उन ऐप्लिकेशन के लिए बहुत काम का है जो वीडियो अपलोड करने की सुविधा देते हैं. इसमें ये चीज़ें शामिल होती हैं:- प्रोसेसिंग की स्थिति और प्रोग्रेस
- वीडियो प्रोसेस करते समय आई गड़बड़ी या अन्य समस्याएं
- थंबनेल इमेज की उपलब्धता
- वीडियो या मेटाडेटा की क्वालिटी को बेहतर बनाने के लिए सुझाव
- YouTube पर अपलोड की गई ओरिजनल फ़ाइल के बारे में जानकारी
ये सभी हिस्से सिर्फ़ वीडियो का मालिक ही वापस पा सकता है. नीचे दी गई सूची में, नए हिस्सों के बारे में जानकारी दी गई है. साथ ही,
video
संसाधन के दस्तावेज़ में उन सभी प्रॉपर्टी के बारे में बताया गया है जो हर हिस्से में हैं.-
fileDetails
ऑब्जेक्ट में, YouTube पर अपलोड की गई वीडियो फ़ाइल की जानकारी होती है. इसमें फ़ाइल का रिज़ॉल्यूशन, अवधि, ऑडियो और वीडियो कोडेक, स्ट्रीम बिटरेट वगैरह शामिल है. -
processingProgress
ऑब्जेक्ट में, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने में YouTube की प्रोग्रेस की जानकारी होती है. ऑब्जेक्ट की प्रॉपर्टी, प्रोसेसिंग की मौजूदा स्थिति की पहचान करती हैं और यह अनुमान लगाती हैं कि YouTube, वीडियो की प्रोसेसिंग पूरी होने में कितना समय लगेगा. इससे यह भी पता चलता है कि वीडियो के लिए अलग-अलग तरह का डेटा या कॉन्टेंट उपलब्ध है या नहीं. जैसे, फ़ाइल की जानकारी या थंबनेल इमेज.इस ऑब्जेक्ट को पोल करने के लिए डिज़ाइन किया गया है, ताकि वीडियो अपलोड करने वाला व्यक्ति, अपलोड की गई वीडियो फ़ाइल को प्रोसेस करने में YouTube की प्रोग्रेस को ट्रैक कर सके.
-
suggestions
ऑब्जेक्ट में ऐसे सुझाव होते हैं जो अपलोड किए गए वीडियो के मेटाडेटा या वीडियो क्वालिटी को बेहतर बनाने के अवसरों की पहचान करते हैं.
-
contentDetails
वाले हिस्से में चार नई प्रॉपर्टी होती हैं. इन प्रॉपर्टी को बिना पुष्टि वाले अनुरोधों से वापस लाया जा सकता है.dimension
– इससे पता चलता है कि वीडियो 2D में उपलब्ध है या 3D में.definition
– इससे पता चलता है कि वीडियो स्टैंडर्ड या हाई डेफ़िनिशन में उपलब्ध है.caption
– इससे पता चलता है कि वीडियो के लिए कैप्शन उपलब्ध हैं या नहीं.licensedContent
– इससे पता चलता है कि वीडियो में ऐसा कॉन्टेंट है या नहीं जिस पर YouTube के किसी कॉन्टेंट पार्टनर ने दावा किया है.
-
status
वाले हिस्से में दो नई प्रॉपर्टी होती हैं. कोई वीडियो डालते या अपडेट करते समय वीडियो के मालिक, दोनों प्रॉपर्टी के लिए वैल्यू सेट कर सकते हैं. इन प्रॉपर्टी के लिए, पुष्टि न किए गए अनुरोध भी वापस लाए जा सकते हैं.embeddable
– इससे पता चलता है कि वीडियो को किसी दूसरी वेबसाइट पर एम्बेड किया जा सकता है या नहीं.license
– वीडियो के लाइसेंस के बारे में बताता है. मान्य वैल्यू,creativeCommon
औरyoutube
हैं.
-
-
videos.list
,videos.insert
, औरvideos.update
तरीकों के लिएpart
पैरामीटर की परिभाषा को अपडेट कर दिया गया है, ताकि ऊपर बताए गए नए हिस्सों के साथ-साथrecordingDetails
पार्ट को भी लिस्ट में शामिल किया जा सके. यह हिस्सा अनजाने में हट गया था. -
channel
संसाधन की नईcontentDetails.googlePlusUserId
प्रॉपर्टी, चैनल से जुड़े Google+ प्रोफ़ाइल आईडी के बारे में बताती है. इस मान का उपयोग Google+ प्रोफ़ाइल का लिंक जनरेट करने के लिए किया जा सकता है. -
हर थंबनेल इमेज ऑब्जेक्ट अब इमेज की चौड़ाई और ऊंचाई तय करता है. फ़िलहाल, थंबनेल इमेज
activity
,channel
,playlist
,playlistItem
,search result
,subscription
, औरvideo
संसाधनों में दिखती हैं. -
playlistItems.list
अबvideoId
पैरामीटर के साथ काम करता है, जिसका इस्तेमालplaylistId
पैरामीटर के साथ किया जा सकता है. इससे सिर्फ़ उस प्लेलिस्ट आइटम को वापस लाया जा सकता है जो बताए गए वीडियो पर काम करता है.अगर पैरामीटर की पहचान करने वाला वीडियो, प्लेलिस्ट में नहीं मिलता, तो एपीआई
notFound
गड़बड़ी दिखाता है. -
गड़बड़ी के दस्तावेज़ में एक नई
forbidden
गड़बड़ी के बारे में बताया गया है. इसका मतलब है कि किसी अनुरोध को, अनुरोध की गई कार्रवाई के लिए सही तरीके से मंज़ूरी नहीं दी गई है. -
channel
संसाधन कीsnippet.channelId
प्रॉपर्टी हटा दी गई है. संसाधन कीid
प्रॉपर्टी एक जैसी वैल्यू देती है.
30 जनवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
नए गड़बड़ी वाले पेज में ऐसी गड़बड़ियों की सूची होती है जो एपीआई से मिल सकती हैं. पेज में सामान्य गड़बड़ियां शामिल हैं, जो एपीआई के अलग-अलग तरीकों के साथ-साथ किसी खास तरीके से जुड़ी गड़बड़ियां होने पर भी हो सकती हैं.
16 जनवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
-
अब नीचे दी गई सूची में दिखाई गई विधियों और भाषाओं के लिए कोड सैंपल उपलब्ध हैं:
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 तरीके का इस्तेमाल करें.