किसी प्लेलिस्ट में बदलाव करता है. उदाहरण के लिए, आप प्लेलिस्ट का शीर्षक, ब्यौरा या निजता स्थिति बदल सकते हैं.
कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 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 |
स्थानीयकरण ऑब्जेक्ट में किसी एक मान का सत्यापन विफल हुआ. मान्य वैल्यू पाने के लिए, playlist.list तरीके का इस्तेमाल करें. साथ ही, प्लेलिस्ट के संसाधन से जुड़े दस्तावेज़ में दिए गए दिशा-निर्देशों का पालन करके, उन्हें अपडेट करना न भूलें. |
forbidden (403) |
playlistForbidden |
यह कार्रवाई प्रतिबंधित है या अनुरोध को ठीक से अधिकृत नहीं है. |
invalidValue (400) |
invalidPlaylistSnippet |
अनुरोध में एक अमान्य प्लेलिस्ट स्निपेट दिया गया है. |
notFound (404) |
playlistNotFound |
अनुरोध की, id पैरामीटर से पहचान की गई प्लेलिस्ट नहीं मिली. |
required (400) |
playlistTitleRequired |
अनुरोध में प्लेलिस्ट का शीर्षक होना ज़रूरी है. |
invalidValue (400) |
playlistOperationUnsupported |
इस एपीआई के लिए इस प्लेलिस्ट को अपडेट करने की सुविधा उपलब्ध नहीं है. उदाहरण के लिए, आप अपलोड किए गए वीडियो की प्लेलिस्ट की प्रॉपर्टी अपडेट नहीं कर सकते. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.