Playlists: update

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

कोटे पर असर: इस तरीके को कॉल करने पर, 50 यूनिट का कोटा शुल्क लगता है.

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

अनुरोध

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

PUT https://www.googleapis.com/youtube/v3/playlists

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का ऑथराइज़ेशन लागू करना लेख पढ़ें.

दायरा
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

यहां दी गई टेबल में उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल इस क्वेरी में किया जा सकता है. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
part पैरामीटर, इस ऑपरेशन में दो काम करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने की कार्रवाई से सेट किया जाएगा. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जिन्हें एपीआई के जवाब में शामिल किया जाएगा.

ध्यान दें कि यह तरीका, बदली जा सकने वाली उन प्रॉपर्टी की मौजूदा वैल्यू को बदल देगा जो अनुरोध बॉडी में बताए गए किसी भी हिस्से में मौजूद हैं. उदाहरण के लिए, प्लेलिस्ट का ब्यौरा snippet सेक्शन में होता है. इसे अनुरोध बॉडी में शामिल करना ज़रूरी है. अगर अनुरोध में snippet.description प्रॉपर्टी के लिए कोई वैल्यू नहीं दी गई है, तो प्लेलिस्ट का मौजूदा ब्यौरा मिटा दिया जाएगा.

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

ध्यान दें: यह पैरामीटर सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है.

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

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

अनुरोध के मुख्य हिस्से में playlist संसाधन दें.

उस संसाधन के लिए:

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

    • id
    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) defaultLanguageNotSetError defaultLanguage को localizations अपडेट करने के लिए सेट किया जाना चाहिए.
badRequest (400) localizationValidationError localizations ऑब्जेक्ट में मौजूद किसी वैल्यू की पुष्टि नहीं हो सकी. मान्य वैल्यू पाने के लिए, playlists.list तरीके का इस्तेमाल करें. साथ ही, प्लेलिस्ट के रिसॉर्स दस्तावेज़ में दिए गए दिशा-निर्देशों का पालन करके, उन्हें अपडेट करना न भूलें.
forbidden (403) playlistForbidden इस कार्रवाई पर पाबंदी है या अनुरोध को सही तरीके से अनुमति नहीं दी गई है.
invalidValue (400) invalidPlaylistSnippet अनुरोध में प्लेलिस्ट का अमान्य स्निपेट दिया गया है.
notFound (404) playlistNotFound अनुरोध के id पैरामीटर से पहचानी गई प्लेलिस्ट नहीं मिली.
required (400) playlistTitleRequired अनुरोध में प्लेलिस्ट का टाइटल होना चाहिए.
invalidValue (400) playlistOperationUnsupported एपीआई, चुनी गई प्लेलिस्ट को अपडेट करने की सुविधा के साथ काम नहीं करता. उदाहरण के लिए, अपलोड किए गए वीडियो की प्लेलिस्ट की प्रॉपर्टी अपडेट नहीं की जा सकतीं.

इसे आज़माएं!

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