YouTube वीडियो को मिटाता है.
कोटा पर असर: इस तरीके का इस्तेमाल करने पर 50 यूनिट का कोटा शुल्क होगा.
इस्तेमाल के सामान्य उदाहरण
अनुरोध
एचटीटीपी अनुरोध
DELETE https://www.googleapis.com/youtube/v3/videos
अनुमति
इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
स्कोप |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में शामिल सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
id |
string id पैरामीटर, मिटाए जा रहे संसाधन के YouTube वीडियो का आईडी बताता है. video संसाधन में, id प्रॉपर्टी वीडियो के आईडी के बारे में बताती है. |
|
वैकल्पिक पैरामीटर | ||
onBehalfOfContentOwner |
string इस पैरामीटर का इस्तेमाल, सिर्फ़ सही तरीके से अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की अनुमति देने वाले क्रेडेंशियल, YouTube सीएमएस के किसी ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और उन्हें मैनेज करने का अधिकार होता है. इससे कॉन्टेंट के मालिकों को एक बार पुष्टि करने के साथ-साथ, अपने वीडियो और चैनल के पूरे डेटा का ऐक्सेस मिल जाता है. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने वाले क्रेडेंशियल देने की ज़रूरत नहीं पड़ती. उपयोगकर्ता जिस असली कॉन्टेंट मैनेजमेंट सिस्टम से पुष्टि करता है उसे, YouTube कॉन्टेंट के उस मालिक से लिंक होना चाहिए. |
अनुरोध का मुख्य भाग
इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.
जवाब
अगर यह तरीका काम करता है, तो यह एचटीटीपी 204
रिस्पॉन्स कोड (No Content
) दिखाता है.
गड़बड़ियां
नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
forbidden (403) |
forbidden |
जिस वीडियो को मिटाने की कोशिश की जा रही है उसे मिटाया नहीं जा सकता. हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो. |
notFound (404) |
videoNotFound |
जिस वीडियो को मिटाने की कोशिश की जा रही है वह नहीं मिला. अनुरोध के id पैरामीटर की वैल्यू की जांच करके पक्का करें कि वह सही है. |
इसे आज़माएं!
इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.