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 के नाम शामिल हैं जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
  • brandPartner
  • 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 पर सेट करना होगा. इस प्रॉपर्टी को सिर्फ़ तब सेट किया जा सकता है, जब वीडियो की निजता सेटिंग 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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.