Channels: update

एपीआई की मदद से, अब अपने चैनल या वीडियो को "बच्चों के लिए बना" के तौर पर मार्क किया जा सकता है. इसके अलावा, channel और video संसाधनों में अब एक प्रॉपर्टी भी शामिल है, जो उस चैनल या वीडियो के "बच्चों के लिए बना" स्टेटस की पहचान करती है. YouTube API की सेवाओं की शर्तें और डेवलपर के लिए बनी नीतियां भी 10 जनवरी, 2020 को अपडेट की गई थीं. ज़्यादा जानकारी के लिए, YouTube Data API सेवा और YouTube API सेवाओं की शर्तों के बदलावों का इतिहास देखें.

चैनल का मेटाडेटा अपडेट करता है. ध्यान दें कि यह तरीका सिर्फ़ channel रिसॉर्स के brandingSettings, invideoPromotion, और localizations ऑब्जेक्ट और उनकी चाइल्ड प्रॉपर्टी में अपडेट करने के लिए काम करता है.

कोटे पर असर: इस तरीके को कॉल करने पर, 50 यूनिट का कोटा शुल्क लगता है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

PUT https://www.googleapis.com/youtube/v3/channels

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का ऑथराइज़ेशन लागू करना लेख पढ़ें.

दायरा
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

यहां दी गई टेबल में उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल इस क्वेरी में किया जा सकता है. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर, इस ऑपरेशन में दो काम करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने की कार्रवाई सेट करेगी. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जिन्हें एपीआई के जवाब में शामिल किया जाएगा.

एपीआई, पैरामीटर की वैल्यू को सिर्फ़ brandingSettings, invideoPromotion या localizations पर सेट करने की अनुमति देता है. (सिर्फ़ एक अनुरोध से, उनमें से किसी एक हिस्से को अपडेट किया जा सकता है.)

ध्यान दें कि यह तरीका, पैरामीटर वैल्यू से तय किए गए हिस्से में मौजूद, बदली जा सकने वाली सभी प्रॉपर्टी की मौजूदा वैल्यू को बदल देता है.
ज़रूरी नहीं पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है.

onBehalfOfContentOwner पैरामीटर से पता चलता है कि पुष्टि किया गया उपयोगकर्ता, पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube कॉन्टेंट पार्टनर के लिए है. इनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और वे उन्हें मैनेज करते हैं. इसकी मदद से, कॉन्टेंट के मालिक एक बार पुष्टि करके अपने सभी वीडियो और चैनल का डेटा ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस असल सीएमएस खाते से पुष्टि करता है उसे YouTube कॉन्टेंट के मालिक से लिंक करना ज़रूरी है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में channel संसाधन दें. उस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए वैल्यू देनी होगी:

    • id

  • इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:

    • brandingSettings.channel.country
    • brandingSettings.channel.description
    • brandingSettings.channel.defaultLanguage
    • brandingSettings.channel.keywords
    • brandingSettings.channel.trackingAnalyticsAccountId
    • brandingSettings.channel.unsubscribedTrailer
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description
    • status.selfDeclaredMadeForKids

    अगर अपडेट का अनुरोध सबमिट किया जा रहा है और आपके अनुरोध में, किसी ऐसी प्रॉपर्टी की वैल्यू नहीं दी गई है जिसकी वैल्यू पहले से मौजूद है, तो प्रॉपर्टी की मौजूदा वैल्यू मिटा दी जाएगी.

जवाब

अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में channel संसाधन दिखाता है.

गड़बड़ियां

नीचे दी गई टेबल में, गड़बड़ी के उन मैसेज के बारे में बताया गया है जो इस तरीके के कॉल के जवाब में एपीआई दिखा सकता है. ज़्यादा जानकारी के लिए, YouTube Data API - गड़बड़ियां देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) brandingValidationError brandingSettings ऑब्जेक्ट की एक वैल्यू की पुष्टि नहीं हो सकी. चैनल की मौजूदा सेटिंग वापस पाने के लिए, channels.list तरीके का इस्तेमाल करें. साथ ही, channels संसाधन दस्तावेज़ में दिए गए दिशा-निर्देशों का पालन करके, प्रॉपर्टी की वैल्यू अपडेट करें.
badRequest (400) channelTitleUpdateForbidden किसी चैनल के brandingSettings part को अपडेट करते समय, आपको brandingSettings.channel.title प्रॉपर्टी की वैल्यू को चैनल के मौजूदा टाइटल पर सेट करना होगा या प्रॉपर्टी को हटाना होगा. प्रॉपर्टी की वैल्यू बदलने पर, एपीआई गड़बड़ी का मैसेज दिखाता है.
badRequest (400) defaultLanguageNotSetError defaultLanguage को localizations अपडेट करने के लिए सेट किया जाना चाहिए.
badRequest (400) invalidBrandingOption आपने ब्रैंडिंग के लिए जो सेटिंग चुनी है उनमें से एक मौजूद नहीं है. मान्य वैल्यू पाने के लिए, channels.list तरीके का इस्तेमाल करें. साथ ही, channels संसाधन दस्तावेज़ में दिए गए दिशा-निर्देशों के मुताबिक, उन्हें अपडेट करना न भूलें.
badRequest (400) invalidCustomMessage अनुरोध मेटाडेटा में, अमान्य कस्टम मैसेज दिया गया है. उस रिसॉर्स में invideoPromotion.items[].customMessage प्रॉपर्टी की वैल्यू देखें जिसके लिए अनुरोध भेजा गया था.
badRequest (400) invalidDuration अनुरोध मेटाडेटा में, invideoPromotion सेक्शन में अवधि की अमान्य वैल्यू दी गई है.
badRequest (400) invalidDuration अनुरोध मेटाडेटा में, पोज़िशन का अमान्य टाइप बताया गया है. इससे यह तय होता है कि प्रमोशन वाले आइटम को वीडियो प्लेयर में कैसे दिखाया जाए. उस रिसॉर्स में invideoPromotion.position.type प्रॉपर्टी की वैल्यू देखें जिसके लिए अनुरोध भेजा गया था.
badRequest (400) invalidRecentlyUploadedBy अनुरोध के मेटाडेटा में अमान्य चैनल आईडी दिया गया है. उस रिसॉर्स में invideoPromotion.items[].id.recentlyUploadedBy प्रॉपर्टी की वैल्यू देखें जिसके लिए अनुरोध भेजा गया था.
badRequest (400) invalidTimingOffset अनुरोध मेटाडेटा में, invideoPromotion सेक्शन में टाइमिंग ऑफ़सेट की वैल्यू अमान्य है.
badRequest (400) invalidTimingOffset अनुरोध मेटाडेटा में, वीडियो प्लेयर में प्रमोशन वाले आइटम को कब दिखाना है, यह तय करने के लिए अमान्य टाइमिंग ऑफ़सेट दिया गया है. उस रिसॉर्स में invideoPromotion.timing.offsetMs प्रॉपर्टी की वैल्यू देखें जिसके लिए अनुरोध भेजा गया था.
badRequest (400) invalidTimingType अनुरोध मेटाडेटा में, वीडियो प्लेयर में प्रमोशन वाले आइटम को दिखाने के लिए, समय तय करने का अमान्य तरीका बताया गया है. उस रिसॉर्स में invideoPromotion.timing.type प्रॉपर्टी की वैल्यू देखें जिसके लिए अनुरोध भेजा गया था.
badRequest (400) localizationValidationError localizations ऑब्जेक्ट में मौजूद किसी वैल्यू की पुष्टि नहीं हो सकी. मान्य वैल्यू पाने के लिए, channels.list तरीके का इस्तेमाल करें. साथ ही, चैनल के संसाधन दस्तावेज़ में दिए गए दिशा-निर्देशों के मुताबिक, उन्हें अपडेट करना न भूलें.
badRequest (400) tooManyPromotedItems invideoPromotion सेक्शन में, प्रमोशन के लिए अनुमति वाले आइटम की संख्या तय सीमा से ज़्यादा है.
forbidden (403) channelForbidden id पैरामीटर में बताया गया चैनल, अनुरोध के साथ काम नहीं करता या अनुरोध को सही तरीके से अनुमति नहीं दी गई है.
forbidden (403) promotedVideoNotAllowed एपीआई अनुरोध में जिस चैनल को अपडेट करने की कोशिश की जा रही है वह नहीं मिला. अनुरोध भेजे गए channel संसाधन में id प्रॉपर्टी की वैल्यू देखें. इससे यह पक्का किया जा सकता है कि चैनल आईडी सही है.
forbidden (403) websiteLinkNotAllowed वेबसाइट के दिए गए यूआरएल की अनुमति नहीं है.
notFound (404) channelNotFound id पैरामीटर में दिया गया चैनल नहीं मिला.
notFound (404) channelNotFound id पैरामीटर से चुना गया चैनल नहीं मिला या उसमें ब्रैंडिंग के विकल्प नहीं हैं.
notFound (404) unknownChannelId बताया गया चैनल आईडी नहीं मिला.
notFound (404) unknownChannelId हाल ही में अपलोड करने वाले व्यक्ति का जो चैनल आईडी बताया गया था वह नहीं मिला.
notFound (404) unknownVideoId प्रमोशन वाले आइटम के तौर पर बताया गया वीडियो आईडी नहीं मिला.
required (400) requiredItemIdType अनुरोध मेटाडेटा में, invideoPromotion सेक्शन में आइटम टाइप की जानकारी होनी चाहिए.
required (400) requiredItemId अनुरोध के मेटाडेटा में, invideoPromotion सेक्शन में आइटम आईडी होना चाहिए.
required (400) requiredTimingOffset अनुरोध मेटाडेटा में, डिफ़ॉल्ट टाइमिंग ऑफ़सेट की जानकारी होनी चाहिए, ताकि YouTube यह तय कर सके कि प्रमोशन वाले आइटम को कब दिखाना है. अनुरोध भेजने वाले संसाधन में invideoPromotion.defaultTiming.offsetMs प्रॉपर्टी की वैल्यू सेट करें.
required (400) requiredTimingOffset अनुरोध मेटाडेटा में टाइमिंग ऑफ़सेट की जानकारी होनी चाहिए, ताकि YouTube यह तय कर सके कि प्रमोशन वाले आइटम को कब दिखाना है. अनुरोध भेजने वाले संसाधन में invideoPromotion.timing.offsetMs प्रॉपर्टी की वैल्यू सेट करें.
required (400) requiredTimingType अनुरोध मेटाडेटा में, समय तय करने का तरीका बताना ज़रूरी है, ताकि YouTube यह तय कर सके कि प्रमोशन वाले आइटम को कब दिखाना है. अनुरोध भेजने वाले संसाधन में invideoPromotion.defaultTiming.type प्रॉपर्टी की वैल्यू सेट करें.
required (400) requiredTimingType अनुरोध मेटाडेटा में, समय तय करने का तरीका बताना ज़रूरी है, ताकि YouTube यह तय कर सके कि प्रमोशन वाले आइटम को कब दिखाना है. अनुरोध भेजने वाले संसाधन में invideoPromotion.timing.type प्रॉपर्टी की वैल्यू सेट करें.
required (400) requiredTiming अनुरोध के मेटाडेटा में, invideoPromotion सेक्शन में मौजूद हर आइटम के लिए समय की जानकारी होनी चाहिए.
required (400) requiredVideoId प्रमोशन किए जा रहे आइटम की पहचान करने के लिए, अनुरोध के मेटाडेटा में वीडियो आईडी होना चाहिए.
required (400) requiredWebsiteUrl अनुरोध के मेटाडेटा में, invideoPromotion सेक्शन में वेबसाइट का यूआरएल होना चाहिए. अनुरोध भेजने वाले संसाधन में invideoPromotion.items[].id.websiteUrl प्रॉपर्टी की वैल्यू सेट करें.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई का अनुरोध और रिस्पॉन्स देखने के लिए, APIs Explorer का इस्तेमाल करें.