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 क्रिएटर स्टूडियो की सेटिंग में कॉन्टेंट के मालिक के खाते से जोड़ा जाना चाहिए.

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

अनुरोध के मुख्य हिस्से में 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 का इस्तेमाल करें.