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

अनुमति

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

स्कोप
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 कॉन्टेंट के उस मालिक से लिंक किया जाना चाहिए.

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

अनुरोध के मुख्य हिस्से में, चैनल के संसाधन की जानकारी दें. इस संसाधन के लिए:

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

    • 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

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

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) brandingValidationError brandingSettings ऑब्जेक्ट के किसी एक वैल्यू की पुष्टि नहीं हो सकी. चैनल की मौजूदा सेटिंग वापस पाने के लिए, channels.list तरीके का इस्तेमाल करें. साथ ही, channels के संसाधन दस्तावेज़ में दिए गए दिशा-निर्देशों का पालन करके, प्रॉपर्टी की वैल्यू अपडेट करें.
badRequest (400) channelTitleUpdateForbidden किसी चैनल का brandingSettings part अपडेट करते समय, आपको brandingSettings.channel.title प्रॉपर्टी की वैल्यू को चैनल के मौजूदा टाइटल पर सेट करना होगा या प्रॉपर्टी को हटाना होगा. प्रॉपर्टी की वैल्यू बदलने पर, एपीआई गड़बड़ी वाला मैसेज दिखाता है.
badRequest (400) defaultLanguageNotSetError localizations को अपडेट करने के लिए, defaultLanguage को सेट करना ज़रूरी है.
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 स्थानीय भाषा के अनुसार ऑब्जेक्ट की किसी एक वैल्यू की पुष्टि नहीं हो सकी. मान्य वैल्यू पाने के लिए, 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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.