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