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