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
सेक्शन का टाइटल. चैनल के सिर्फ़ उस सेक्शन का टाइटल सेट किया जा सकता है जिसकी snippet.type वैल्यू multiplePlaylists या multipleChannels है. असल में, आपको चैनल के ऐसे सेक्शन को शामिल या अपडेट करते समय कोई टाइटल बताना होगा. अगर आप चैनल के दूसरे तरह के सेक्शन के लिए शीर्षक तय करते हैं, तो इस मान को नज़रअंदाज़ कर दिया जाएगा.

इस प्रॉपर्टी के मान में ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं. साथ ही, इसमें < और < को छोड़कर बाकी सभी मान्य 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 है, तो आपको चैनल आईडी की एक सूची बतानी होगी. साथ ही, इस प्रॉपर्टी को दूसरी तरह के सेक्शन के लिए नहीं बताया जाना चाहिए. सूची में अपना चैनल शामिल नहीं किया जा सकता.