लागू करने का तरीका: चैनल

इस पेज पर, चैनल का डेटा वापस पाने और उसे अपडेट करने से जुड़े फ़ंक्शन परफॉर्म करने के लिए, YouTube Data API (वर्शन 3) का इस्तेमाल करने का तरीका बताया गया है. channel संसाधन में, प्लेलिस्ट आईडी शामिल होते हैं. इनसे किसी चैनल पर अपलोड किए गए और पसंद किए गए वीडियो की पहचान होती है. channels.list तरीके को कॉल करते समय, यह जानकारी फ़ेच करने के लिए, पक्का करें कि part पैरामीटर वैल्यू में, contentDetails संसाधन का हिस्सा शामिल हो.

किसी चैनल के बारे में जानकारी वापस पाना

किसी चैनल के बारे में जानकारी वापस पाने के लिए, channels.list तरीके को कॉल करें. चैनल की पहचान करने के कुछ तरीके यहां दिए गए हैं:

किसी चैनल की ब्रैंडिंग की जानकारी सेट करना

इस उदाहरण में, किसी चैनल के ब्रैंडिंग के विकल्पों को अपडेट किया गया है. इस उदाहरण में दो चरण शामिल हैं:

  • पहला चरण: चैनल की ब्रैंडिंग के विकल्प वापस पाना

    channels.list तरीके को कॉल करें और part पैरामीटर की वैल्यू को brandingSettings पर सेट करें. साथ ही, mine पैरामीटर की वैल्यू को true पर सेट करें.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
            part=brandingSettings
            &mine=true

    आपका ऐप्लिकेशन, वापस पाई गई सेटिंग दिखा सकता है. इससे उपयोगकर्ता, अपडेट करने के लिए सेटिंग में बदलाव कर सकता है.

  • दूसरा चरण: चैनल की ब्रैंडिंग के विकल्प अपडेट करना

    channels.list तरीके को कॉल करें और ये वैल्यू सेट करें:

    • id प्रॉपर्टी को, चैनल के यूनीक YouTube चैनल आईडी पर सेट करें. आईडी को पहले चरण में, एपीआई से मिली जानकारी से एक्सट्रैक्ट किया जा सकता है.
    • part पैरामीटर की वैल्यू को brandingSettings पर सेट करें.

    एपीआई एक्सप्लोरर का नीचे दिया गया लिंक, इन ब्रैंडिंग सेटिंग के साथ channel संसाधन बनाता है:

    {
      "id": "CHANNEL_ID",
      "brandingSettings": {
        "channel": {
          "description": "A great channel to be enjoyed by all.",
          "moderateComments": true,
          "showRelatedChannels": true,
          "showBrowseView": true,
          "featuredChannelsTitle": "Featured Channel Stuff",
          "featuredChannelsUrls": [
            "UC_x5XG1OV2P6uZZ5FSM9Ttw",
            "UCBR8-60-B28hp2BmDPdntcQ",
            "UCK8sQmJBp8GCxrOtXWBpyEA"
          ],
          "profileColor": "#006600"
        }
      }
    }

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

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
            part=brandingSettings
    

चैनल के सेक्शन मैनेज करना

एपीआई, चैनल के सेक्शन मैनेज करने के लिए, channelSections.list, channelSections.insert, channelSections.update, और channelSections.delete तरीकों का इस्तेमाल करता है. चैनल का सेक्शन, वीडियो का एक सेट होता है. इसे किसी चैनल पर दिखाया जाता है. उदाहरण के लिए, किसी सेक्शन में चैनल के हाल ही में अपलोड किए गए वीडियो, सबसे लोकप्रिय वीडियो या एक या उससे ज़्यादा प्लेलिस्ट के वीडियो शामिल हो सकते हैं.

नीचे दिए गए उदाहरण में, Google के आधिकारिक YouTube चैनल के सेक्शन वापस पाए गए हैं. अनुरोध में, channelSections.list तरीके को कॉल किया गया है और channelId पैरामीटर की वैल्यू को UCK8sQmJBp8GCxrOtXWBpyEA पर सेट किया गया है. यह Google के चैनल का आईडी है.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

अगर channelId पैरामीटर का इस्तेमाल करने के बजाय, mine पैरामीटर की वैल्यू को true पर सेट किया जाता है, तो इस अनुरोध के लिए अनुमति की ज़रूरत होती है. इस पैरामीटर से पता चलता है कि फ़िलहाल, पुष्टि किए गए उपयोगकर्ता के चैनल के सेक्शन वापस पाए जा रहे हैं.

किसी चैनल के लिए वॉटरमार्क वाली इमेज अपलोड करना और सेट करना

वॉटरमार्क वाली इमेज अपलोड करने और उसे किसी चैनल के लिए सेट करने के लिए, watermarks.set तरीके को कॉल किया जा सकता है. इसके बाद, इमेज, बताए गए चैनल के वीडियो के प्लेबैक के दौरान दिखती है. आपके पास, टारगेट चैनल की जानकारी देने का विकल्प भी होता है. इससे इमेज, उस चैनल से लिंक हो जाएगी. इसके अलावा, टाइमिंग की जानकारी भी दी जा सकती है. इससे यह तय होता है कि वॉटरमार्क कब दिखेगा और यह कितने समय तक दिखेगा.

watermarks.unset तरीका, किसी चैनल की वॉटरमार्क वाली इमेज को मिटा देता है.

माफ़ करें, इस क्वेरी को APIs explorer का इस्तेमाल करके टेस्ट नहीं किया जा सकता. इसकी वजह यह है कि APIs explorer, मीडिया फ़ाइलें अपलोड करने की सुविधा के साथ काम नहीं करता. इस तरीके के लिए, यह ज़रूरी है.