PlaylistItems: delete

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

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

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

अनुरोध

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

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

अनुमति देना

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

दायरा
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 स्टेटस कोड दिखाता है.

गड़बड़ियां

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

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

इसे आज़माएं!

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