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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.