PlaylistItems: insert

किसी प्लेलिस्ट में संसाधन जोड़ता है.

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 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 नाम शामिल हैं, जिन्हें आप पैरामीटर वैल्यू में शामिल कर सकते हैं:
  • contentDetails
  • id
  • snippet
  • status
ज़रूरी पैरामीटर
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 का इस्तेमाल करें.