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 के कई अलग-अलग चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इससे कॉन्टेंट के मालिक, एक बार पुष्टि करके अपने सभी वीडियो और चैनल के डेटा का ऐक्सेस पा सकते हैं. इसके लिए, उन्हें हर चैनल के लिए अनुमति के क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस CMS खाते से पुष्टि करता है वह, बताए गए 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 का इस्तेमाल करें.