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 स्थानीय जगह के अनुसार प्लेलिस्ट का ब्यौरा. |