PlaylistItems: update

किसी प्लेलिस्ट आइटम में बदलाव करता है. उदाहरण के लिए, प्लेलिस्ट में आइटम की जगह अपडेट की जा सकती है.

कोटे पर असर: इस तरीके को कॉल करने पर, कोटे की 50 यूनिट खर्च होती हैं.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

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

यहां दी गई सूची में, part के उन नामों की जानकारी दी गई है जिन्हें पैरामीटर वैल्यू में शामिल किया जा सकता है:
  • contentDetails
  • id
  • snippet
  • status
वैकल्पिक पैरामीटर
onBehalfOfContentOwner string
ध्यान दें: onBehalfOfContentOwner पैरामीटर, सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. इसका इस्तेमाल, अनुमति वाले अनुरोध में ही किया जा सकता है.

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

जब पैरामीटर मौजूद होता है, तो उसकी वैल्यू से कॉन्टेंट के मालिक की पहचान होती है. साथ ही, अनुरोध की अनुमति से जुड़ी क्रेडेंशियल से, YouTube के उस उपयोगकर्ता की पहचान होती है जिसे कॉन्टेंट के मालिक की ओर से कार्रवाई करने की अनुमति मिली है. जिस खाते से उपयोगकर्ता पुष्टि करता है उसे YouTube Creator Studio की सेटिंग में, बताए गए कॉन्टेंट के मालिक से लिंक होना चाहिए.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, playlistItem संसाधन की जानकारी दें. उस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए वैल्यू तय करनी होगी:

    • id
    • snippet.playlistId
    • snippet.resourceId

  • इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:

    • snippet.position
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

    अगर अपडेट करने का अनुरोध सबमिट किया जा रहा है और आपके अनुरोध में किसी ऐसी प्रॉपर्टी के लिए वैल्यू नहीं बताई गई है जिसकी पहले से कोई वैल्यू है, तो प्रॉपर्टी की मौजूदा वैल्यू मिटा दी जाएगी.

जवाब

अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में playlistItem संसाधन की जानकारी मिलती है.

गड़बड़ियां

यहां दी गई टेबल में, गड़बड़ी के उन मैसेज की जानकारी दी गई है जो इस तरीके को कॉल करने पर, एपीआई के जवाब में दिख सकते हैं. ज़्यादा जानकारी के लिए, गड़बड़ी के मैसेज से जुड़ा दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) playlistItemsNotAccessible अनुरोध के पास, बताई गई प्लेलिस्ट आइटम को अपडेट करने की अनुमति नहीं है.
invalidValue (400) invalidPlaylistItemPosition अनुरोध में, प्लेलिस्ट आइटम की जगह के लिए अमान्य या काम न करने वाली वैल्यू सेट करने की कोशिश की गई है. संसाधन के snippet में, position प्रॉपर्टी की वैल्यू देखें.
invalidValue (400) invalidResourceType संसाधन आईडी के लिए बताया गया type, इस कार्रवाई के लिए काम नहीं करता. संसाधन आईडी से, प्लेलिस्ट में जोड़े जा रहे आइटम की पहचान होती है. जैसे, youtube#video.
invalidValue (400) invalidSnippet अनुरोध में, snippet प्रॉपर्टी के लिए मान्य वैल्यू नहीं बताई गई है.
invalidValue (400) manualSortRequired अनुरोध में, प्लेलिस्ट आइटम की जगह सेट करने की कोशिश की गई है, लेकिन प्लेलिस्ट में मैन्युअल तरीके से क्रम में लगाने की सुविधा का इस्तेमाल नहीं किया जाता. (उदाहरण के लिए, प्लेलिस्ट आइटम को तारीख या लोकप्रियता के हिसाब से क्रम में लगाया जा सकता है.) गड़बड़ी को ठीक करने के लिए, अनुरोध में जोड़े जा रहे संसाधन से snippet.position एलिमेंट हटाएं. अगर आपको प्लेलिस्ट आइटम को सूची में किसी खास जगह पर रखना है, तो प्लेलिस्ट की सेटिंग में जाकर, क्रम में लगाने के विकल्प को मैन्युअल पर अपडेट करें. YouTube के वीडियो मैनेजर में, इस सेटिंग को बदला जा सकता है.
notFound (404) playlistItemNotFound अनुरोध की id प्रॉपर्टी से पहचाना गया प्लेलिस्ट आइटम नहीं मिला.
notFound (404) playlistNotFound अनुरोध के playlistId पैरामीटर से पहचानी गई प्लेलिस्ट नहीं मिली.
required (400) channelIdRequired अनुरोध में, ज़रूरी channelId प्रॉपर्टी के लिए वैल्यू नहीं बताई गई है.
required (400) playlistIdRequired अनुरोध में, ज़रूरी playlistId प्रॉपर्टी के लिए वैल्यू नहीं बताई गई है.
required (400) playlistItemIdRequired अनुरोध में बताए गए प्लेलिस्ट आइटम संसाधन में, अपडेट किए जा रहे प्लेलिस्ट आइटम की पहचान करने के लिए, id प्रॉपर्टी का इस्तेमाल करना ज़रूरी है.
invalidValue (400) playlistOperationUnsupported एपीआई में, बताई गई प्लेलिस्ट में वीडियो अपडेट करने की सुविधा काम नहीं करती. उदाहरण के लिए, अपलोड किए गए वीडियो की प्लेलिस्ट में किसी वीडियो को अपडेट नहीं किया जा सकता.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई अनुरोध और जवाब को देखने के लिए, APIs Explorer का इस्तेमाल करें.