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 के कॉन्टेंट पार्टनर के लिए है.

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

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

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

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

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

जवाब

सही तरीके से काम करने पर, यह तरीका रिस्पॉन्स के मुख्य हिस्से में liveStream संसाधन दिखाता है.

गड़बड़ियां

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

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

इसे आज़माएं!

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