इस पेज का अनुवाद Cloud Translation API से किया गया है.

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