LiveStreams: insert

वीडियो स्ट्रीम बनाता है. स्ट्रीम आपको अपना वीडियो YouTube पर भेजने में सक्षम बनाती है, जो फिर आपके दर्शकों को वीडियो का प्रसारण कर सकता है.

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

अनुरोध करें

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

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

अनुमति दें

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

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

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
part कार्रवाई के लिए दो पैरामीटर इस्तेमाल किए जाते हैं. इससे राइट प्रॉपर्टी पर सेट की जाने वाली प्रॉपर्टी के साथ-साथ, एपीआई रिस्पॉन्स में शामिल की जाने वाली प्रॉपर्टी की पहचान की जाती है.

पैरामीटर वैल्यू में जो part प्रॉपर्टी शामिल की जा सकती हैं वे id, snippet, cdn, contentDetails, और status हैं.
ज़रूरी पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है.

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

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

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

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

अनुरोध के मुख्य हिस्से में लाइव स्ट्रीम संसाधन उपलब्ध कराएं. उस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए एक मान तय करना होगा:

    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प है:

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

जवाब

अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में लाइव स्ट्रीम संसाधन दिखेगा.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
insufficientPermissions insufficientLivePermissions अनुरोध के मुताबिक, इस लाइव स्ट्रीम को बनाने की अनुमति नहीं है.
insufficientPermissions livePermissionBlocked जिस उपयोगकर्ता ने अनुरोध किया है वह फ़िलहाल YouTube पर लाइव वीडियो नहीं चला सकता. https://www.youtube.com/features पर उपयोगकर्ता के चैनल की सेटिंग में जाकर, यह जानकारी दी जा सकती है कि उपयोगकर्ता क्यों लाइव वीडियो स्ट्रीम नहीं कर सकते.
insufficientPermissions liveStreamingNotEnabled जिस उपयोगकर्ता ने अनुरोध की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. उपयोगकर्ता https://www.youtube.com/features पर ज़्यादा जानकारी पा सकते हैं.
invalidValue (400) invalidDescription liveStream संसाधन में snippet.description प्रॉपर्टी के मान में ज़्यादा से ज़्यादा 10,000 वर्ण हो सकते हैं.
invalidValue (400) invalidFormat liveStream रिसॉर्स में मौजूद cdn.format प्रॉपर्टी की वैल्यू अमान्य है.
invalidValue (400) invalidFrameRate liveStream संसाधन में cdn.frameRate प्रॉपर्टी का मान अमान्य है.
invalidValue (400) invalidIngestionType liveStream संसाधन में cdn.ingestionType प्रॉपर्टी का मान अमान्य है.
invalidValue (400) invalidResolution liveStream संसाधन में cdn.resolution प्रॉपर्टी का मान अमान्य है.
invalidValue (400) invalidTitle liveStream संसाधन में snippet.title प्रॉपर्टी का मान 1 से 128 वर्णों के बीच होना चाहिए.
rateLimitExceeded userRequestsExceedRateLimit उपयोगकर्ता ने एक तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं.
required (400) cdnRequired liveStream संसाधन में cdn ऑब्जेक्ट होना चाहिए.
required (400) frameRateRequired अगर यह cdn.resolution प्रॉपर्टी के लिए वैल्यू तय करता है, लेकिन cdn.frameRate प्रॉपर्टी के लिए नहीं, तो एपीआई यह गड़बड़ी दिखाता है.
required (400) ingestionTypeRequired liveStream रिसॉर्स में cdn.ingestionType प्रॉपर्टी> के लिए एक वैल्यू होनी चाहिए.
required (400) resolutionRequired अगर यह cdn.frameRate प्रॉपर्टी के लिए वैल्यू तय करता है, लेकिन cdn.resolution प्रॉपर्टी के लिए नहीं, तो एपीआई यह गड़बड़ी दिखाता है.
required (400) titleRequired liveStream संसाधन को snippet.title प्रॉपर्टी के लिए एक मान तय करना होगा.

इसे आज़माएं!

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