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.moderateComments
    • 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 अनुरोध मेटाडेटा, इन-वीडियोप्रमोशन भाग में एक अमान्य समय ऑफ़सेट के बारे में बताता है.
badRequest (400) invalidTimingOffset अनुरोध मेटाडेटा, वीडियो प्लेयर में प्रचार किए गए आइटम को कब दिखाया जाए, यह तय करने के लिए एक अमान्य टाइमिंग ऑफ़सेट के बारे में बताता है. अनुरोध भेजे गए संसाधन में, invideoPromotion.timing.offsetMs प्रॉपर्टी की वैल्यू देखें.
badRequest (400) invalidTimingType अनुरोध मेटाडेटा, वीडियो प्लेयर में प्रचार किए गए आइटम को कब दिखाया जाए, यह तय करने के अमान्य समय का तरीका बताता है. अनुरोध भेजे गए संसाधन में, invideoPromotion.timing.type प्रॉपर्टी की वैल्यू देखें.
badRequest (400) localizationValidationError स्थानीयकरण ऑब्जेक्ट में किसी एक मान का सत्यापन विफल हुआ. मान्य वैल्यू पाने के लिए, channels.list तरीके का इस्तेमाल करें. साथ ही, चैनल के रिसॉर्स दस्तावेज़ में दिए गए दिशा-निर्देशों का पालन करके, उन्हें अपडेट करें.
badRequest (400) tooManyPromotedItems इनवीडियो प्रचार भाग में प्रचार किए गए अनुमति आइटम की संख्या पार हो गई है.
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 अनुरोध मेटाडेटा को इनवीडियो प्रमोशन भाग में एक आइटम प्रकार तय करना होगा.
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 भाग में एक वेबसाइट url दर्ज होना चाहिए. अनुरोध भेजे जाने वाले संसाधन में, invideoPromotion.items[].id.websiteUrl प्रॉपर्टी की वैल्यू सेट करें.

इसे आज़माएं!

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