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
    • 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 का इस्तेमाल करें. साथ ही, एपीआई का अनुरोध और रिस्पॉन्स देखें.