Videos: update

इस एपीआई की मदद से, अब आपके चैनल या वीडियो को "बच्चों के लिए बना" के तौर पर मार्क किया जा सकता है. इसके अलावा, 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 नाम शामिल हैं, जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
ज़रूरी पैरामीटर
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 का इस्तेमाल करें.