ChannelSections

channelSection के संसाधन में उन वीडियो के बारे में जानकारी होती है जिन्हें चैनल ने दिखाने के लिए चुना है. उदाहरण के लिए, किसी सेक्शन में चैनल के हाल ही में अपलोड किए गए वीडियो, सबसे लोकप्रिय अपलोड या एक या एक से ज़्यादा प्लेलिस्ट के वीडियो दिखाए जा सकते हैं.

एक चैनल ज़्यादा से ज़्यादा 10 शेल्फ़ बना सकता है.

तरीके

channelSections संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:

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

संसाधन दिखाना

यहां दिया गया JSON स्ट्रक्चर, channelSections संसाधन का फ़ॉर्मैट दिखाता है:

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
इससे पता चलता है कि एपीआई रिसॉर्स किस तरह का है. मान youtube#channelSection होगा.
etag etag
इस संसाधन का ईटैग.
id string
इस आईडी का इस्तेमाल करके, YouTube किसी चैनल सेक्शन की खास तरह से पहचान करता है.
snippet object
snippet ऑब्जेक्ट में, चैनल सेक्शन के बारे में बुनियादी जानकारी मौजूद होती है. जैसे, चैनल का टाइप और टाइटल.
snippet.type string
चैनल सेक्शन का टाइप.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
इस आईडी का इस्तेमाल करके, YouTube उस चैनल की पहचान करता है जिसने चैनल सेक्शन को पब्लिश किया है.
snippet.title string
सेक्शन का टाइटल. सिर्फ़ ऐसे चैनल सेक्शन का टाइटल सेट किया जा सकता है जिसमें multiplePlaylists या multipleChannels की snippet.type वैल्यू हो. असल में, आपको इन सेक्शन में से किसी एक को जोड़ते या अपडेट करते समय एक टाइटल बताना होगा. अगर आप दूसरी तरह के चैनल सेक्शन के लिए शीर्षक तय करते हैं, तो मान को अनदेखा कर दिया जाएगा.

इस प्रॉपर्टी के मान में < और > को छोड़कर सभी मान्य UTF-8 वर्ण हो सकते हैं.
snippet.position unsigned integer
चैनल पेज पर सेक्शन की जगह. यह प्रॉपर्टी 0-आधारित इंडेक्स का इस्तेमाल करती है. 0 का मान चैनल पर दिखाई देने वाले पहले सेक्शन की पहचान करता है, 1 मान दूसरे सेक्शन की पहचान करता है और इसी तरह आगे भी इसी तरह का एक मान है.

अगर चैनल सेक्शन को जोड़ते समय इस प्रॉपर्टी के लिए कोई वैल्यू तय नहीं की जाती है, तो डिफ़ॉल्ट रूप से नए सेक्शन को आखिर में दिखाया जाता है.
contentDetails object
contentDetails ऑब्जेक्ट में, चैनल सेक्शन के कॉन्टेंट के बारे में जानकारी होती है. जैसे, सेक्शन में दिखाई गई प्लेलिस्ट या चैनलों की सूची.
contentDetails.playlists[] list
चैनल के किसी सेक्शन में दिए गए एक या एक से ज़्यादा प्लेलिस्ट आईडी की सूची. अगर channelSection संसाधन की snippet.type प्रॉपर्टी singlePlaylist या multiplePlaylists है और इस प्रॉपर्टी को अन्य तरह के सेक्शन के लिए नहीं दिया जाना चाहिए, तो आपको प्लेलिस्ट आईडी की सूची देनी होगी. अगर टाइप singlePlaylist है, तो इस सूची में सिर्फ़ एक प्लेलिस्ट आईडी होना चाहिए.
contentDetails.channels[] list
चैनल के किसी सेक्शन में दिखाए गए एक या एक से ज़्यादा चैनल आईडी की सूची. अगर channelSection संसाधन की snippet.type प्रॉपर्टी multipleChannels है, तो आपको चैनल आईडी की सूची देनी होगी. साथ ही, इस प्रॉपर्टी को अन्य तरह के सेक्शन के लिए नहीं दिया जाना चाहिए. आपके पास इस सूची में अपना चैनल शामिल करने का विकल्प नहीं होता है.