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 पिक्सल लंबा होता है. आम तौर पर, वीडियो का रेफ़रंस, जैसे कि प्लेलिस्ट आइटम या खोज के नतीजे के तौर पर इस्तेमाल किया जाता है. चैनल के लिए डिफ़ॉल्ट थंबनेल 88px चौड़ा और 88px लंबा होता है.
  • 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
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
स्थानीय जगह के अनुसार प्लेलिस्ट का ब्यौरा.