PlaylistItems: delete

प्लेलिस्ट से आइटम को मिटाता है.

कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

DELETE https://www.googleapis.com/youtube/v3/playlistItems

अनुमति

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).

स्कोप
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में शामिल सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
id string
id पैरामीटर, उस प्लेलिस्ट आइटम का YouTube प्लेलिस्ट आइटम आईडी बताता है जिसे मिटाया जा रहा है. playlistItem संसाधन में, id प्रॉपर्टी प्लेलिस्ट आइटम के आईडी की जानकारी देती है.
वैकल्पिक पैरामीटर
onBehalfOfContentOwner string
ध्यान दें: onBehalfOfContentOwner पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. इसका इस्तेमाल सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है.

यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए बनाया गया है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक और उन्हें मैनेज करने का अधिकार होता है. यह कॉन्टेंट के मालिक से जुड़े उपयोगकर्ताओं को एक बार पुष्टि करने के बाद, हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल दिए बिना, कॉन्टेंट के मालिक के सभी वीडियो और चैनल डेटा को ऐक्सेस और मैनेज करने देता है.

पैरामीटर मौजूद होने पर, इसका मान कॉन्टेंट के मालिक की पहचान करता है. साथ ही, अनुरोध की अनुमति से जुड़े क्रेडेंशियल YouTube उपयोगकर्ता की पहचान करते हैं, जिसे उस कॉन्टेंट के मालिक की ओर से कार्रवाई करने की अनुमति दी गई है. उपयोगकर्ता जिस खाते से पुष्टि करता है वह YouTube Creator Studio की सेटिंग में, कॉन्टेंट के मालिक के चुने गए खाते से जुड़ा होना चाहिए.

अनुरोध का मुख्य भाग

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका काम करता है, तो यह एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाता है.

गड़बड़ियां

नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) playlistItemsNotAccessible चुने गए प्लेलिस्ट आइटम को मिटाने के लिए, अनुरोध करने की अनुमति सही नहीं है.
notFound (404) playlistItemNotFound अनुरोध के id पैरामीटर से पहचाना गया प्लेलिस्ट आइटम नहीं मिला.
invalidValue (400) playlistOperationUnsupported एपीआई किसी खास प्लेलिस्ट से वीडियो नहीं मिटा सकता. उदाहरण के लिए, अपलोड की गई वीडियो की प्लेलिस्ट से कोई वीडियो नहीं मिटाया जा सकता.

इसे आज़माएं!

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