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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.