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 पिक्सल लंबी है.
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 तरीके का इस्तेमाल करके, इस वैल्यू को सेट कर सकता है.