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