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

इसे आज़माएं!

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