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

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

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

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

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

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

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

जवाब

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

गड़बड़ियां

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

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