PlaylistItems

playlistItem संसाधन, किसी अन्य संसाधन की पहचान करता है. जैसे, प्लेलिस्ट में शामिल किया गया कोई वीडियो. इसके अलावा, playlistItem संसाधन में शामिल किए गए संसाधन के बारे में जानकारी होती है. यह जानकारी खास तौर पर इस बारे में होती है कि उस संसाधन का इस्तेमाल प्लेलिस्ट में कैसे किया जाता है.

YouTube, अपलोड किए गए वीडियो की सूची वाले चैनल की पहचान करने के लिए भी प्लेलिस्ट का इस्तेमाल करता है. इस सूची में मौजूद हर playlistItem, अपलोड किए गए एक वीडियो को दिखाता है. किसी चैनल के लिए, channel रिसॉर्स से उस सूची का प्लेलिस्ट आईडी वापस पाया जा सकता है. इसके बाद, सूची में playlistItems.list तरीके का इस्तेमाल किया जा सकता है.

तरीके

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

list

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

insert

किसी संसाधन को प्लेलिस्ट में जोड़ता है. इसे अभी आज़माएं.

अपडेट करें

किसी प्लेलिस्ट आइटम में बदलाव करता है. उदाहरण के लिए, प्लेलिस्ट में आइटम की जगह अपडेट की जा सकती है. इसे अभी आज़माएं.

मिटाएं

प्लेलिस्ट आइटम मिटाता है. इसे अभी आज़माएं.

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

यहां दिए गए JSON स्ट्रक्चर में, playlistItems रिसॉर्स का फ़ॉर्मैट दिखाया गया है:

{
  "kind": "youtube#playlistItem",
  "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,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

प्रॉपर्टी

यहां दी गई टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind	string इससे एपीआई संसाधन के टाइप की पहचान होती है. वैल्यू youtube#playlistItem होगी.
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 पिक्सल लंबी है. fhd – थंबनेल इमेज का फ़ुल हाई डेफ़िनिशन (1080 पिक्सल) वर्शन. यह इमेज साइज़, कुछ वीडियो के लिए उपलब्ध है. यह इमेज 1920 पिक्सल चौड़ी और 1080 पिक्सल लंबी है. qhd – थंबनेल इमेज का क्वाड हाई डेफ़िनिशन (1440 पिक्सल / 2K) वर्शन. यह इमेज साइज़, कुछ वीडियो के लिए उपलब्ध है. यह इमेज 2560 पिक्सल चौड़ी और 1440 पिक्सल लंबी है. uhd – थंबनेल इमेज का अल्ट्रा-हाई रिज़ॉल्यूशन (4K) वर्शन. यह इमेज साइज़, कुछ वीडियो के लिए उपलब्ध है. यह इमेज 3840 पिक्सल चौड़ी और 2160 पिक्सल लंबी है.
snippet.thumbnails.(key).url	string इमेज का यूआरएल.
snippet.thumbnails.(key).width	unsigned integer इमेज की चौड़ाई.
snippet.thumbnails.(key).height	unsigned integer इमेज की ऊंचाई.
snippet.channelTitle	string यह उस चैनल का टाइटल होता है जिससे प्लेलिस्ट आइटम जुड़ा है.
snippet.videoOwnerChannelTitle	string इस वीडियो को अपलोड करने वाले चैनल का टाइटल.
snippet.videoOwnerChannelId	string इस वीडियो को अपलोड करने वाले चैनल का चैनल आईडी.
snippet.playlistId	string यह वह आईडी है जिसका इस्तेमाल YouTube, उस प्लेलिस्ट की पहचान करने के लिए करता है जिसमें प्लेलिस्ट आइटम मौजूद है.
snippet.position	unsigned integer यह बताता है कि आइटम, प्लेलिस्ट में किस क्रम में दिखता है. इस वैल्यू में ज़ीरो-आधारित इंडेक्स का इस्तेमाल किया जाता है. इसलिए, पहले आइटम की पोज़िशन 0, दूसरे आइटम की पोज़िशन 1 होती है. इसी तरह, आगे भी पोज़िशन तय होती है.
snippet.resourceId	object id ऑब्जेक्ट में ऐसी जानकारी होती है जिसका इस्तेमाल, प्लेलिस्ट में शामिल उस संसाधन की पहचान करने के लिए किया जा सकता है जिसे प्लेलिस्ट आइटम के तौर पर शामिल किया गया है.
snippet.resourceId.kind	string रेफ़र किए गए संसाधन का टाइप.
snippet.resourceId.videoId	string अगर snippet.resourceId.kind प्रॉपर्टी की वैल्यू youtube#video है, तो यह प्रॉपर्टी मौजूद होगी. इसकी वैल्यू में वह आईडी होगा जिसका इस्तेमाल YouTube, प्लेलिस्ट में वीडियो की पहचान करने के लिए करता है.
contentDetails	object अगर शामिल किया गया आइटम कोई YouTube वीडियो है, तो contentDetails ऑब्जेक्ट को संसाधन में शामिल किया जाता है. इस ऑब्जेक्ट में वीडियो के बारे में अतिरिक्त जानकारी होती है.
contentDetails.videoId	string यह आईडी, YouTube पर किसी वीडियो की पहचान करने के लिए इस्तेमाल किया जाता है. video संसाधन को वापस पाने के लिए, एपीआई अनुरोध में id क्वेरी पैरामीटर को इस वैल्यू पर सेट करें.
contentDetails.startAt	string ध्यान दें: इस प्रॉपर्टी को बंद कर दिया गया है. अगर इसे सेट किया जाता है, तो इसकी वैल्यू को अनदेखा कर दिया जाता है. वीडियो शुरू होने के बाद, वह समय जब वीडियो चलना शुरू होना चाहिए. इस समय को सेकंड में मापा जाता है. (प्लेलिस्ट का मालिक यह तय कर सकता है कि प्लेलिस्ट में वीडियो कब शुरू और बंद होना चाहिए.) डिफ़ॉल्ट वैल्यू 0 है.
contentDetails.endAt	string ध्यान दें: इस प्रॉपर्टी को बंद कर दिया गया है. अगर इसे सेट किया जाता है, तो इसकी वैल्यू को अनदेखा कर दिया जाता है. वीडियो शुरू होने के बाद, वह समय जब वीडियो चलना बंद हो जाना चाहिए. इस समय को सेकंड में मापा जाता है. (प्लेलिस्ट का मालिक यह तय कर सकता है कि प्लेलिस्ट में वीडियो कब शुरू और बंद होना चाहिए.) डिफ़ॉल्ट रूप से, मान लें कि video.endTime वीडियो का आखिरी हिस्सा है.
contentDetails.note	string इस आइटम के लिए, उपयोगकर्ता का बनाया गया नोट. प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 280 वर्ण हो सकते हैं.
contentDetails.videoPublishedAt	datetime YouTube पर वीडियो पब्लिश करने की तारीख और समय. वैल्यू को ISO 8601 फ़ॉर्मैट में तय किया जाता है.
status	object status ऑब्जेक्ट में, प्लेलिस्ट आइटम की निजता की स्थिति के बारे में जानकारी होती है.
status.privacyStatus	string प्लेलिस्ट में शामिल आइटम की निजता की स्थिति. प्लेलिस्ट आइटम के तौर पर मौजूद वीडियो को अपलोड करने वाला चैनल, videos.insert या videos.update तरीके का इस्तेमाल करके इस वैल्यू को सेट कर सकता है.