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