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