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