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