किसी प्लेलिस्ट में संसाधन जोड़ता है.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 50 यूनिट हो जाती है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/youtube/v3/playlistItems
अनुमति दें
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.
दायरा |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part कार्रवाई के लिए दो पैरामीटर इस्तेमाल किए जाते हैं. यह उन प्रॉपर्टी की पहचान करता है जिन्हें राइट ऑपरेशंस सेट करता है. साथ ही, उन प्रॉपर्टी की भी पहचान करता है जिन्हें एपीआई रिस्पॉन्स में शामिल किया जाता है.नीचे दी गई सूची में part नाम शामिल हैं, जिन्हें आप पैरामीटर वैल्यू में शामिल कर सकते हैं:
|
|
ज़रूरी पैरामीटर | ||
onBehalfOfContentOwner |
string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में playlistItem रिसॉर्स उपलब्ध कराएं. उस संसाधन के लिए:
-
आपको इन प्रॉपर्टी के लिए एक मान तय करना होगा:
snippet.playlistId
snippet.resourceId
-
आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प है:
snippet.playlistId
snippet.position
snippet.resourceId
contentDetails.note
contentDetails.startAt
contentDetails.endAt
जवाब
अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य भाग में playlistItem संसाधन दिखता है.
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
प्लेलिस्ट में पहले से ही अधिकतम संख्या में आइटम हैं. |
forbidden (403) |
playlistItemsNotAccessible |
इस प्लेलिस्ट आइटम को जोड़ने के लिए, अनुरोध करने की अनुमति नहीं है. |
invalidValue (400) |
invalidContentDetails |
अनुरोध में मौजूद contentDetails प्रॉपर्टी मान्य नहीं है. इसकी एक संभावित वजह यह हो सकती है कि contentDetails.note फ़ील्ड में, 280 से ज़्यादा वर्ण हों. |
invalidValue (400) |
invalidPlaylistItemPosition |
अनुरोध, प्लेलिस्ट आइटम की स्थिति को किसी अमान्य या असमर्थित मान पर सेट करने का प्रयास करता है. संसाधन के snippet में, position प्रॉपर्टी की वैल्यू देखें. |
invalidValue (400) |
invalidResourceType |
इस कार्रवाई के लिए संसाधन आईडी में बताया गया type काम नहीं करता. संसाधन आईडी, प्लेलिस्ट में जोड़े जा रहे आइटम की पहचान करता है – उदाहरण के लिए, youtube#video . |
invalidValue (400) |
manualSortRequired |
अनुरोध, प्लेलिस्ट आइटम की जगह सेट करने की कोशिश करता है, लेकिन प्लेलिस्ट मैन्युअल तरीके से क्रम में लगाने की सुविधा का इस्तेमाल नहीं करती. (उदाहरण के लिए, प्लेलिस्ट के आइटम को तारीख या लोकप्रियता के हिसाब से क्रम में लगाया जा सकता है.) अनुरोध शामिल किए जा रहे रिसॉर्स से snippet.position एलिमेंट को हटाकर, गड़बड़ी को ठीक किया जा सकता है. अगर आपको सूची में किसी खास आइटम की जगह चाहिए, तो आपको सबसे पहले प्लेलिस्ट की सेटिंग में जाकर, प्लेलिस्ट का ऑर्डर मैन्युअल पर अपडेट करना होगा. इन सेटिंग में YouTube वीडियो मैनेजर से बदलाव किया जा सकता है. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
आप जिस वीडियो को प्लेलिस्ट में जोड़ना चाहते हैं वह पहले से ही सीरीज़ की दूसरी प्लेलिस्ट में मौजूद है. |
notFound (404) |
playlistNotFound |
अनुरोध की, playlistId पैरामीटर से पहचान की गई प्लेलिस्ट नहीं मिली. |
notFound (404) |
videoNotFound |
आपको जो वीडियो प्लेलिस्ट में जोड़ना है वह नहीं मिला. videoId प्रॉपर्टी की वैल्यू की जांच करके, पक्का करें कि वह सही है. |
required (400) |
channelIdRequired |
अनुरोध में channelId प्रॉपर्टी के लिए वैल्यू मौजूद नहीं है. |
required (400) |
playlistIdRequired |
अनुरोध में playlistId प्रॉपर्टी के लिए वैल्यू मौजूद नहीं है. |
required (400) |
resourceIdRequired |
अनुरोध में ऐसा संसाधन शामिल होना चाहिए जिसमें snippet ऑब्जेक्ट, resourceId के बारे में बताता हो. |
invalidValue (400) |
playlistOperationUnsupported |
इस एपीआई की मदद से, बताई गई प्लेलिस्ट में वीडियो नहीं डाले जा सकते. उदाहरण के लिए, अपलोड की गई वीडियो प्लेलिस्ट में वीडियो शामिल नहीं किया जा सकता. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.