Playlists

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

YouTube, किसी चैनल के लिए वीडियो के खास कलेक्शन की पहचान करने के लिए भी प्लेलिस्ट का इस्तेमाल करता है. जैसे:

  • अपलोड किए गए वीडियो
  • पसंद किए गए वीडियो
ज़्यादा जानकारी के लिए बता दें कि ये सूचियां किसी चैनल से जुड़ी होती हैं. चैनल, किसी व्यक्ति, ग्रुप या कंपनी के वीडियो, प्लेलिस्ट, और YouTube पर मौजूद अन्य जानकारी का कलेक्शन होता है. किसी चैनल के लिए, इन सूचियों में से हर सूची के प्लेलिस्ट आईडी को channel resource से वापस पाया जा सकता है.

इसके बाद, इनमें से किसी भी सूची को वापस पाने के लिए, playlistItems.list तरीके का इस्तेमाल किया जा सकता है. playlistItems.insert और playlistItems.delete तरीकों का इस्तेमाल करके, उन सूचियों में आइटम जोड़े या हटाए भी जा सकते हैं.

तरीके

एपीआई, playlists संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

list
यह एपीआई अनुरोध के पैरामीटर से मेल खाने वाली प्लेलिस्ट का कलेक्शन दिखाता है. उदाहरण के लिए, पुष्टि किए गए उपयोगकर्ता के मालिकाना हक वाली सभी प्लेलिस्ट वापस पाई जा सकती हैं. इसके अलावा, एक या उससे ज़्यादा प्लेलिस्ट को उनके यूनीक आईडी के हिसाब से वापस पाया जा सकता है. इसे अभी आज़माएं.
insert
प्लेलिस्ट बनाता है. इसे अभी आज़माएं.
अपडेट करें
किसी प्लेलिस्ट में बदलाव करता है. उदाहरण के लिए, किसी प्लेलिस्ट का टाइटल, ब्यौरा या निजता की स्थिति बदली जा सकती है. इसे अभी आज़माएं.
मिटाएं
इस तरीके का इस्तेमाल करके, किसी प्लेलिस्ट को मिटाया जा सकता है. इसे अभी आज़माएं.

संसाधन का रेप्रज़ेंटेशन

यहां दिए गए 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
इस संसाधन का 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
प्लेलिस्ट के ब्यौरे का अनुवाद.