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 मान्य मुख्य वैल्यू ये हैं:
|
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 वाले तरीके का इस्तेमाल करके सेट कर सकता है. |