LiveStreams: delete

वीडियो स्ट्रीम मिटाता है.

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

अनुरोध

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

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

अनुमति देना

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

दायरा
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
id	string id पैरामीटर, मिटाए जा रहे संसाधन के लिए YouTube लाइव स्ट्रीम का आईडी तय करता है.
वैकल्पिक पैरामीटर
onBehalfOfContentOwner	string इस पैरामीटर का इस्तेमाल, सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर, सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. The onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की अनुमति देने वाले क्रेडेंशियल, YouTube सीएमएस के किसी ऐसे उपयोगकर्ता की पहचान करते हैं जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube के उन कॉन्टेंट पार्टनर के लिए है जो YouTube के कई अलग-अलग चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इससे, कॉन्टेंट के मालिक एक बार पुष्टि करके, अपने सभी वीडियो और चैनल के डेटा का ऐक्सेस पा सकते हैं. इसके लिए, उन्हें हर चैनल के लिए अनुमति देने वाले क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस CMS खाते से पुष्टि करता है वह, बताए गए YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए.
onBehalfOfContentOwnerChannel	string इस पैरामीटर का इस्तेमाल, सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर, सिर्फ़ YouTube के कॉन्टेंट पार्टनर के लिए है. The onBehalfOfContentOwnerChannel पैरामीटर, उस चैनल का YouTube चैनल आईडी तय करता है जिसमें कोई वीडियो जोड़ा जा रहा है. इस पैरामीटर का इस्तेमाल तब करना ज़रूरी है, जब किसी अनुरोध में onBehalfOfContentOwner पैरामीटर के लिए कोई वैल्यू तय की गई हो. इसका इस्तेमाल, सिर्फ़ उस पैरामीटर के साथ किया जा सकता है. इसके अलावा, अनुरोध को अनुमति देने के लिए, CMS के किसी ऐसे खाते का इस्तेमाल करना होगा जो उस कॉन्टेंट के मालिक से लिंक हो जिसे onBehalfOfContentOwner पैरामीटर तय करता है. आखिर में, onBehalfOfContentOwnerChannel पैरामीटर वैल्यू में तय किया गया YouTube चैनल, उस कॉन्टेंट के मालिक से लिंक होना चाहिए जिसे onBehalfOfContentOwner पैरामीटर तय करता है. यह पैरामीटर, YouTube के उन कॉन्टेंट पार्टनर के लिए है जो YouTube के कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें मैनेज करते हैं. इससे, कॉन्टेंट के मालिक एक बार पुष्टि करके, पैरामीटर वैल्यू में तय किए गए चैनल की ओर से कार्रवाइयां कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए अनुमति देने वाले क्रेडेंशियल देने की ज़रूरत नहीं होती.

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

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

जवाब

अगर यह तरीका काम करता है, तो जवाब के मुख्य भाग में liveStream संसाधन दिखता है.

गड़बड़ियां

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

गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
forbidden (403)	liveStreamDeletionNotAllowed	तय की गई लाइव स्ट्रीम को मिटाया नहीं जा सकता, क्योंकि यह किसी ऐसे ब्रॉडकास्ट से जुड़ी है जो अब तक पूरा नहीं हुआ है.
insufficientPermissions	insufficientLivePermissions	तय की गई लाइव स्ट्रीम को मिटाने के लिए, अनुरोध को अनुमति नहीं मिली है. ज़्यादा जानकारी के लिए, OAuth2 प्रमाणीकरण लागू करना लेख पढ़ें.
insufficientPermissions	liveStreamingNotEnabled	जिस उपयोगकर्ता ने अनुरोध को अनुमति दी है उसके पास, YouTube पर लाइव वीडियो स्ट्रीम करने की अनुमति नहीं है. ज़्यादा जानकारी के लिए, सुविधा इस्तेमाल करने की ज़रूरी शर्तें देखें.
notFound (404)	liveStreamNotFound	तय की गई लाइव स्ट्रीम मौजूद नहीं है.

इसे आज़माएं!

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