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 का इस्तेमाल करें.