PlaylistItems

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

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

तरीके

playlistItems संसाधनों के लिए, एपीआई नीचे दिए गए तरीकों के साथ काम करता है:

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

संसाधन दिखाना

यहां दिया गया 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
इस संसाधन का ईटैग.
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 तरीके का इस्तेमाल करके यह वैल्यू सेट कर सकता है.