Playlists

playlist संसाधन, YouTube प्लेलिस्ट के बारे में बताता है. प्लेलिस्ट, उन वीडियो का एक संग्रह है जिन्हें एक क्रम में देखा जा सकता है और दूसरे उपयोगकर्ताओं के साथ शेयर किया जा सकता है. डिफ़ॉल्ट रूप से, प्लेलिस्ट दूसरे लोगों को दिखती हैं. हालांकि, प्लेलिस्ट सार्वजनिक या निजी हो सकती हैं.

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,     "podcastStatus": enum   },   "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 मान्य मुख्य वैल्यू ये हैं:
  • default – डिफ़ॉल्ट थंबनेल इमेज. किसी वीडियो के लिए डिफ़ॉल्ट थंबनेल - 120 पिक्सल चौड़ा और 90 पिक्सल लंबा होता है. इसके अलावा, वीडियो के बारे में जानकारी देने वाले संसाधन (जैसे, प्लेलिस्ट में शामिल कोई आइटम या खोज नतीजा) भी डिफ़ॉल्ट तौर पर सेट होते हैं. चैनल के लिए डिफ़ॉल्ट थंबनेल की चौड़ाई 88 पिक्सल और लंबाई 88 पिक्सल होती है.
  • medium – थंबनेल इमेज का बेहतर रिज़ॉल्यूशन वाला वर्शन. वीडियो (या वीडियो के बारे में बताने वाले संसाधन) के लिए, इस इमेज की चौड़ाई 320 पिक्सल और ऊंचाई 180 पिक्सल है. चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल ऊंची है.
  • high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन. वीडियो (या वीडियो के बारे में बताने वाले संसाधन) के लिए, इस इमेज की चौड़ाई 480 पिक्सल और ऊंचाई 360 पिक्सल है. चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल लंबी है.
  • standard – high रिज़ॉल्यूशन वाली इमेज के मुकाबले थंबनेल इमेज का ज़्यादा रिज़ॉल्यूशन वाला वर्शन. यह इमेज, प्लेलिस्ट में मौजूद आइटम या खोज के नतीजों जैसे कुछ वीडियो और उनसे जुड़े अन्य संसाधनों के लिए उपलब्ध है. इस इमेज की चौड़ाई 640 पिक्सल और ऊंचाई 480 पिक्सल है.
  • maxres – थंबनेल इमेज का सबसे ज़्यादा रिज़ॉल्यूशन वाला वर्शन. इमेज का यह साइज़, कुछ वीडियो और उन दूसरे संसाधनों के लिए उपलब्ध है जो वीडियो से जुड़े होते हैं. जैसे, प्लेलिस्ट में दिखने वाले आइटम या खोज के नतीजे. इस इमेज की चौड़ाई 1280 पिक्सल और ऊंचाई 720 पिक्सल है.
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 ऑब्जेक्ट में, प्लेलिस्ट का टाइटल और जानकारी स्थानीय भाषा में होती है या प्लेलिस्ट के मेटाडेटा के लिए, डिफ़ॉल्ट भाषा में टाइटल होता है.
  • स्थानीय जगह के अनुसार टेक्स्ट, रिसॉर्स स्निपेट में तब दिखता है, जब playlists.list अनुरोध ने hl पैरामीटर का इस्तेमाल करके ऐसी भाषा तय की हो जिसके लिए स्थानीय भाषा में लिखा गया टेक्स्ट दिखाना है और स्थानीय भाषा में लिखा गया टेक्स्ट उस भाषा में उपलब्ध है.
  • अगर hl पैरामीटर की वैल्यू नहीं बताई गई है या कोई वैल्यू दी गई है, लेकिन बताई गई भाषा के लिए स्थानीय भाषा में मेटाडेटा उपलब्ध नहीं है, तो डिफ़ॉल्ट भाषा का मेटाडेटा दिखाया जाता है.
प्रॉपर्टी में ऐसी वैल्यू होती है जिसे सिर्फ़ पढ़ा जा सकता है. स्थानीय भाषा के मुताबिक टाइटल जोड़ने, अपडेट करने या मिटाने के लिए, localizations ऑब्जेक्ट का इस्तेमाल करें.
snippet.localized.title
string स्थानीय जगह के अनुसार प्लेलिस्ट का टाइटल.
snippet.localized.description
string स्थानीय जगह के अनुसार प्लेलिस्ट का ब्यौरा.
status
object status ऑब्जेक्ट में प्लेलिस्ट की स्थिति की जानकारी होती है.
status.privacyStatus
string प्लेलिस्ट की निजता स्थिति.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • private
  • public
  • unlisted
status.podcastStatus
string प्लेलिस्ट की स्थिति. अगर वैल्यू enabled है, तो प्लेलिस्ट को पॉडकास्ट शो के तौर पर मार्क किया जाता है. प्लेलिस्ट के पॉडकास्ट की स्थिति को enabled पर सेट करने के लिए, प्लेलिस्ट में एक प्लेलिस्ट की इमेज होनी चाहिए.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • enabled
  • disabled
  • unspecified
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 स्थानीय जगह के अनुसार प्लेलिस्ट का ब्यौरा.