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

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

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

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

• पुष्टि किए गए मौजूदा उपयोगकर्ता के YouTube चैनल की जानकारी पाने के लिए, mine पैरामीटर की वैल्यू को true पर सेट करें. आपके अनुरोध को OAuth 2.0 का इस्तेमाल करके अनुमति दी जानी चाहिए.

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

• forUsername पैरामीटर को YouTube उपयोगकर्ता नाम पर सेट करें, ताकि उस उपयोगकर्ता नाम से जुड़े चैनल की जानकारी हासिल की जा सके. इस उदाहरण में, Google के आधिकारिक YouTube चैनल की जानकारी पाने के लिए, forUsername पैरामीटर की वैल्यू को Google पर सेट किया गया है.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
          part=snippet,contentDetails
          &forUsername=Google

• id पैरामीटर को उस YouTube चैनल आईडी पर सेट करें जिसकी जानकारी आपको चाहिए. इस उदाहरण में, id पैरामीटर को UCK8sQmJBp8GCxrOtXWBpyEA पर सेट किया गया है. इससे Google के आधिकारिक YouTube चैनल की पहचान भी होती है.

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

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

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

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

  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"
      }
    }
  }

  APIs Explorer में अनुरोध पूरा करने के लिए, आपको 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 तरीके से, चैनल के वॉटरमार्क की इमेज मिटाई जाती है.

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