channel
और video
संसाधनों में अब एक प्रॉपर्टी भी शामिल है. इससे चैनल या वीडियो की "बच्चों के लिए बना"
स्थिति की पहचान की जा सकती है. YouTube API सेवाओं की सेवा की शर्तें और डेवलपर के लिए नीतियां भी 10 जनवरी, 2020 को अपडेट की गई थीं. ज़्यादा जानकारी के लिए, कृपया
YouTube Data API सेवा में किए गए बदलावों का इतिहास और
YouTube API की सेवाओं की सेवा की शर्तें देखें.
वीडियो के मेटाडेटा को अपडेट करता है.
कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.
इस्तेमाल के सामान्य उदाहरण
अनुरोध
एचटीटीपी अनुरोध
PUT https://www.googleapis.com/youtube/v3/videos
अनुमति
इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
स्कोप |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में शामिल सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string इस कार्रवाई में part पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने वाली कार्रवाई सेट की जाएगी. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जिनमें एपीआई के रिस्पॉन्स में शामिल होगा.ध्यान दें कि इस तरीके से, बदली जा सकने वाली सभी प्रॉपर्टी की मौजूदा वैल्यू बदल जाएंगी, जो पैरामीटर वैल्यू के किसी भी हिस्से में मौजूद हैं. उदाहरण के लिए, किसी वीडियो की निजता सेटिंग status वाले हिस्से में शामिल होती है. इसलिए, अगर आपका अनुरोध किसी निजी वीडियो को अपडेट किया जा रहा है और अनुरोध के part पैरामीटर की वैल्यू में status वाला हिस्सा शामिल है, तो वीडियो की निजता सेटिंग, अनुरोध के मुख्य हिस्से में तय की गई वैल्यू के हिसाब से अपडेट कर दी जाएगी. अगर अनुरोध के मुख्य हिस्से में कोई वैल्यू नहीं दी जाती है, तो मौजूदा निजता सेटिंग हटा दी जाएगी और वीडियो डिफ़ॉल्ट निजता सेटिंग पर सेट हो जाएगा.इसके अलावा, वीडियो के हर हिस्से में ऐसी प्रॉपर्टी नहीं होती हैं जिन्हें वीडियो को शामिल या अपडेट करते समय सेट किया जा सके. उदाहरण के लिए, statistics ऑब्जेक्ट, उन आंकड़ों को इकट्ठा करता है जिनका हिसाब YouTube किसी वीडियो के लिए लगाता है. इसमें ऐसी वैल्यू शामिल नहीं होतीं जिन्हें सेट किया जा सकता है या जिनमें बदलाव किया जा सकता है. अगर पैरामीटर वैल्यू में ऐसी part है जिसमें बदली जा सकने वाली वैल्यू नहीं है, तो उस part को अब भी एपीआई के रिस्पॉन्स में शामिल किया जाएगा.यहां दी गई सूची में part नाम हैं, जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
|
|
वैकल्पिक पैरामीटर | ||
onBehalfOfContentOwner |
string इस पैरामीटर का इस्तेमाल, सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की अनुमति देने वाले क्रेडेंशियल, YouTube सीएमएस के किसी ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और उन्हें मैनेज करने का अधिकार होता है. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने के साथ-साथ, अपने वीडियो और चैनल के पूरे डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं पड़ती. उपयोगकर्ता जिस असली कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है उसे, YouTube कॉन्टेंट के उस मालिक से लिंक होना चाहिए. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, वीडियो संसाधन दें. इस संसाधन के लिए:
-
आपको इन प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी:
id
snippet.title
– इस प्रॉपर्टी की ज़रूरत सिर्फ़ तब होती है, जब अनुरोध सेvideo
संसाधन कीsnippet
को अपडेट किया जाता है.snippet.categoryId
– इस प्रॉपर्टी की ज़रूरत सिर्फ़ तब होती है, जब अनुरोध सेvideo
संसाधन कीsnippet
को अपडेट किया जाता है.
-
इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:
snippet.categoryId
snippet.defaultLanguage
snippet.description
snippet.tags[]
snippet.title
status.embeddable
status.license
status.privacyStatus
status.publicStatsViewable
status.publishAt
– अगर आपने इस प्रॉपर्टी के लिए कोई वैल्यू सेट की है, तो आपकोstatus.privacyStatus
प्रॉपर्टी को भीprivate
पर सेट करना होगा.status.selfDeclaredMadeForKids
recordingDetails.locationDescription
(अब सेवा में नहीं है)recordingDetails.location.latitude
(अब सेवा में नहीं है)recordingDetails.location.longitude
(अब सेवा में नहीं है)recordingDetails.recordingDate
localizations.(key)
localizations.(key).title
localizations.(key).description
अगर आप अपडेट का अनुरोध सबमिट कर रहे हैं और आपके अनुरोध में किसी ऐसी प्रॉपर्टी के लिए कोई वैल्यू तय नहीं की गई है जिसकी कोई वैल्यू पहले से मौजूद है, तो उस प्रॉपर्टी की मौजूदा वैल्यू मिटा दी जाएगी.
जवाब
अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में वीडियो रिसॉर्स दिखाया जाता है.
गड़बड़ियां
नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
एपीआई अनुरोध, वीडियो की डिफ़ॉल्ट भाषा बताए बिना स्थानीय जगह के हिसाब से वीडियो की जानकारी जोड़ने की कोशिश कर रहा है. |
badRequest (400) |
invalidCategoryId |
snippet.categoryId प्रॉपर्टी में दी गई कैटगरी का आईडी अमान्य है. इस्तेमाल की जा सकने वाली कैटगरी को फिर से पाने के लिए, videoCategories.list तरीके का इस्तेमाल करें. |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
अनुरोध, डिफ़ॉल्ट ब्रॉडकास्ट के लिए अमान्य निजता सेटिंग सेट करने की कोशिश करता है. |
badRequest (400) |
invalidDescription |
अनुरोध के मेटाडेटा में वीडियो की गलत जानकारी दी गई है. |
badRequest (400) |
invalidPublishAt |
अनुरोध मेटाडेटा में, शेड्यूल किए गए वीडियो पब्लिश करने के समय की जानकारी गलत है. |
badRequest (400) |
invalidRecordingDetails |
अनुरोध मेटाडेटा में मौजूद recordingDetails ऑब्जेक्ट, रिकॉर्डिंग की अमान्य जानकारी के बारे में बताता है. |
badRequest (400) |
invalidTags |
अनुरोध मेटाडेटा में अमान्य वीडियो कीवर्ड मौजूद हैं. |
badRequest (400) |
invalidTitle |
अनुरोध मेटाडेटा में वीडियो का टाइटल अमान्य या खाली है. |
badRequest (400) |
invalidVideoMetadata |
अनुरोध का मेटाडेटा अमान्य है. |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenEmbedSetting |
अनुरोध करने पर, वीडियो के लिए एम्बेड करने की अमान्य सेटिंग सेट करने की कोशिश की जाती है. ध्यान दें, हो सकता है कि कुछ चैनलों को लाइव स्ट्रीम के लिए एम्बेड किए गए प्लेयर देने की अनुमति न मिले. ज़्यादा जानकारी के लिए, YouTube के सहायता केंद्र पर जाएं. |
forbidden (403) |
forbiddenLicenseSetting |
अनुरोध में, वीडियो के लिए अमान्य लाइसेंस सेट करने की कोशिश की गई है. |
forbidden (403) |
forbiddenPrivacySetting |
अनुरोध में, वीडियो के लिए अमान्य निजता सेटिंग सेट करने की कोशिश की गई है. |
notFound (404) |
videoNotFound |
जिस वीडियो को अपडेट करने की कोशिश की जा रही है वह नहीं मिला. अनुरोध के मुख्य हिस्से में id फ़ील्ड की वैल्यू की जांच करके पक्का करें कि यह सही है. |
इसे आज़माएं!
इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.