Playlists: update

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

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

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

अनुरोध

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

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

अनुमति

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

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

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

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

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

    • id
    • snippet.title

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

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

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

जवाब

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

गड़बड़ियां

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

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

इसे आज़माएं!

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