playlist
संसाधन, YouTube प्लेलिस्ट के बारे में बताता है. प्लेलिस्ट, उन वीडियो का एक कलेक्शन है जिन्हें एक क्रम में देखा जा सकता है और अन्य लोगों के साथ शेयर किया जा सकता है. डिफ़ॉल्ट रूप से, प्लेलिस्ट अन्य लोगों को दिखती हैं. हालांकि, प्लेलिस्ट सार्वजनिक या निजी हो सकती हैं.
YouTube, किसी चैनल के वीडियो के खास संग्रह की पहचान करने के लिए प्लेलिस्ट का भी इस्तेमाल करता है, जैसे:
- अपलोड किए गए वीडियो
- अच्छी रेटिंग वाले (पसंद किए गए) वीडियो
channel resource
से किसी चैनल के लिए वापस पाए जा सकते हैं.इसके बाद, इनमें से किसी भी सूची को वापस पाने के लिए,
playlistItems.list
तरीके का इस्तेमाल किया जा सकता है. playlistItems.insert
और playlistItems.delete
तरीकों का इस्तेमाल करके, इन सूचियों में आइटम जोड़े या हटाए भी जा सकते हैं.
तरीके
playlists
संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:
- list
- एपीआई अनुरोध के पैरामीटर से मेल खाने वाली प्लेलिस्ट का संग्रह दिखाता है. उदाहरण के लिए, उन सभी प्लेलिस्ट को वापस लाया जा सकता है जिनके मालिकाना हक की पुष्टि की गई है. इसके अलावा, यूनीक आईडी के ज़रिए एक या एक से ज़्यादा प्लेलिस्ट भी वापस लाई जा सकती हैं. इसे अभी आज़माएं.
- डालें
- प्लेलिस्ट बनाता है. इसे अभी आज़माएं.
- अपडेट
- प्लेलिस्ट में बदलाव करता है. उदाहरण के लिए, किसी प्लेलिस्ट का टाइटल, ब्यौरा या निजता की स्थिति बदली जा सकती है. इसे अभी आज़माएं.
- मिटाएं
- प्लेलिस्ट को मिटाता है. इसे अभी आज़माएं.
संसाधन दिखाना
यहां दिया गया JSON स्ट्रक्चर, playlists
संसाधन का फ़ॉर्मैट दिखाता है:
{ "kind": "youtube#playlist", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "defaultLanguage": string, "localized": { "title": string, "description": string } }, "status": { "privacyStatus": string }, "contentDetails": { "itemCount": unsigned integer }, "player": { "embedHtml": string }, "localizations": { (key): { "title": string, "description": string } } }
प्रॉपर्टी
यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:
प्रॉपर्टी | |
---|---|
kind |
string इससे पता चलता है कि एपीआई रिसॉर्स किस तरह का है. मान youtube#playlist होगा. |
etag |
etag इस संसाधन का ईटैग. |
id |
string इस आईडी का इस्तेमाल करके, YouTube किसी प्लेलिस्ट की खास तरह से पहचान करता है. |
snippet |
object snippet ऑब्जेक्ट में, प्लेलिस्ट के बारे में बुनियादी जानकारी मौजूद होती है. जैसे, उसका टाइटल और ब्यौरा. |
snippet.publishedAt |
datetime प्लेलिस्ट बनाने की तारीख और समय. यह वैल्यू ISO 8601 फ़ॉर्मैट में होती है. |
snippet.channelId |
string इस आईडी का इस्तेमाल करके, YouTube उस चैनल की पहचान करता है जिसने प्लेलिस्ट पब्लिश की है. |
snippet.title |
string प्लेलिस्ट का टाइटल. |
snippet.description |
string प्लेलिस्ट का ब्यौरा. |
snippet.thumbnails |
object प्लेलिस्ट से जुड़ी थंबनेल इमेज का मैप. मैप में हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है और वैल्यू एक ऑब्जेक्ट होता है, जिसमें थंबनेल के बारे में अन्य जानकारी होती है. |
snippet.thumbnails.(key) |
object कुंजी की मान्य वैल्यू ये हैं:
|
snippet.thumbnails.(key).url |
string इमेज का यूआरएल. |
snippet.thumbnails.(key).width |
unsigned integer इमेज की चौड़ाई. |
snippet.thumbnails.(key).height |
unsigned integer इमेज की ऊंचाई. |
snippet.channelTitle |
string उस चैनल का टाइटल जिससे वीडियो जुड़ा है. |
snippet.tags[] |
list इस प्रॉपर्टी के इस्तेमाल पर रोक लगा दी गई है. प्लेलिस्ट से जुड़े कीवर्ड टैग. |
snippet.defaultLanguage |
string playlist संसाधन की snippet.title और snippet.description प्रॉपर्टी में मौजूद टेक्स्ट की भाषा. |
snippet.localized |
object snippet.localized ऑब्जेक्ट में, प्लेलिस्ट का टाइटल और उसकी स्थानीय भाषा में जानकारी दी गई है. इसके अलावा, प्लेलिस्ट के मेटाडेटा की डिफ़ॉल्ट भाषा में टाइटल मौजूद है.
localizations ऑब्जेक्ट का इस्तेमाल करें. |
snippet.localized.title |
string स्थानीय भाषा में बनाई गई प्लेलिस्ट का टाइटल. |
snippet.localized.description |
string स्थानीय भाषा में लिखी गई प्लेलिस्ट का ब्यौरा. |
status |
object status ऑब्जेक्ट में, प्लेलिस्ट के स्टेटस की जानकारी होती है. |
status.privacyStatus |
string प्लेलिस्ट की निजता की स्थिति. इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
|
contentDetails |
object contentDetails ऑब्जेक्ट में, प्लेलिस्ट के कॉन्टेंट की जानकारी होती है. इसमें, प्लेलिस्ट में मौजूद वीडियो की संख्या भी शामिल होती है. |
contentDetails.itemCount |
unsigned integer प्लेलिस्ट में मौजूद वीडियो की संख्या. |
player |
object player ऑब्जेक्ट में ऐसी जानकारी होती है जिसका इस्तेमाल, एम्बेड किए गए प्लेयर में प्लेलिस्ट चलाने के लिए किया जाएगा. |
player.embedHtml |
string एक <iframe> टैग, जो प्लेलिस्ट चलाने वाले प्लेयर को एम्बेड करता है. |
localizations |
object localizations ऑब्जेक्ट में, प्लेलिस्ट के मेटाडेटा का अनुवाद इकट्ठा किया जाता है. |
localizations.(key) |
object कुंजी की वैल्यू से जुड़े स्थानीय भाषा वाले टेक्स्ट की भाषा. वैल्यू एक ऐसी स्ट्रिंग है जिसमें BCP-47 भाषा कोड है. |
localizations.(key).title |
string स्थानीय भाषा में बनाई गई प्लेलिस्ट का टाइटल. |
localizations.(key).description |
string स्थानीय भाषा में लिखी गई प्लेलिस्ट का ब्यौरा. |