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

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

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

किसी खास चैनल की जानकारी पाने के लिए channels.list के तरीके को कॉल करें. चैनल की पहचान करने के कुछ तरीके:

• mine पैरामीटर की वैल्यू को true पर सेट करें, ताकि इस चैनल पर पुष्टि किए गए मौजूदा उपयोगकर्ता के YouTube चैनल की जानकारी फिर से मिल सके. आपके अनुरोध को 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"
      }
    }
  }

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

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

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

एपीआई, channelSections.list, channelSection.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 का इस्तेमाल करने से चैनल की वॉटरमार्क इमेज मिट जाती है.

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