LiveStreams: insert

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