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

अगर अनुरोध की पुष्टि, मैनेज किए जा रहे चैनल पर कार्रवाई करने वाले सीएमएस कॉन्टेंट के मालिक के क्रेडेंशियल से की जाती है, तो यह पैरामीटर देना ज़रूरी है. अगर इसे शामिल नहीं किया जाता है, तो अनुरोध की कार्रवाई, पुष्टि किए गए उपयोगकर्ता के सीधे कॉन्टेक्स्ट में होती है. साथ ही, एचटीटीपी 403 फ़ॉरबिडन गड़बड़ी दिखती है.

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

अनुरोध के मुख्य भाग में, 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 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 localizations ऑब्जेक्ट में मौजूद किसी वैल्यू की पुष्टि नहीं हो पाई. मान्य वैल्यू पाने के लिए, channels.list तरीके का इस्तेमाल करें. साथ ही, पक्का करें कि आपने उन्हें channels संसाधन के दस्तावेज़ में दिए गए दिशा-निर्देशों के मुताबिक अपडेट किया हो.
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 recentlyUploadedBy के लिए बताया गया चैनल आईडी नहीं मिला.
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 का इस्तेमाल करें.