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
  },
  "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 अनुरोध में, किसी ऐसी भाषा के बारे में बताया जाता है जिसमें स्थानीय भाषा वाला टेक्स्ट दिखाया जाना चाहिए और उस भाषा में स्थानीय जगह के अनुसार टेक्स्ट उपलब्ध है, तो playlists.list अनुरोध में hl पैरामीटर का इस्तेमाल किया जाता है, तो रिसॉर्स स्निपेट में स्थानीय भाषा के हिसाब से टेक्स्ट दिखाया जाता है.
  • अगर hl पैरामीटर की वैल्यू नहीं दी गई है या, कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट भाषा का मेटाडेटा दिखाया जाता है. हालांकि, किसी खास भाषा के लिए स्थानीय जगह के हिसाब से मेटाडेटा उपलब्ध नहीं होता है.
प्रॉपर्टी में रीड-ओनली वैल्यू शामिल है. स्थानीय भाषा के हिसाब से टाइटल जोड़ने, अपडेट करने या मिटाने के लिए, localizations ऑब्जेक्ट का इस्तेमाल करें.
snippet.localized.title string
स्थानीय भाषा में बनाई गई प्लेलिस्ट का टाइटल.
snippet.localized.description string
स्थानीय भाषा में लिखी गई प्लेलिस्ट का ब्यौरा.
status object
status ऑब्जेक्ट में, प्लेलिस्ट के स्टेटस की जानकारी होती है.
status.privacyStatus string
प्लेलिस्ट की निजता की स्थिति.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • private
  • public
  • unlisted
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
स्थानीय भाषा में लिखी गई प्लेलिस्ट का ब्यौरा.