LiveBroadcasts: insert

एपीआई की मदद से अब आपके लाइव ब्रॉडकास्ट को "बच्चों के लिए बना" के तौर पर मार्क किया जा सकता है. साथ ही, liveBroadcast संसाधन में अब एक प्रॉपर्टी शामिल है जिससे उस लाइव ब्रॉडकास्ट की "बच्चों के लिए बना" स्थिति के बारे में पता चलता है. YouTube API की सेवाओं की शर्तें और डेवलपर के लिए नीतियां भी 10 जनवरी, 2020 को अपडेट की गई थीं. ज़्यादा जानकारी के लिए, कृपया YouTube Live Streaming API सेवा और YouTube API सेवाओं की सेवा की शर्तों के बदलावों का इतिहास देखें.

ब्रॉडकास्ट बनाता है.

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

अनुरोध

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

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

अनुमति

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

स्कोप
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

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

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

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

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

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

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

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

अनुरोध के मुख्य हिस्से में, liveBroadcast संसाधन दें. इस संसाधन के लिए:

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

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

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

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart

    ध्यान दें: प्रॉपर्टी टेबल में ऐसी सभी डिफ़ॉल्ट वैल्यू दिखती हैं जो ऊपर दी गई प्रॉपर्टी के लिए सेट की गई हैं. डिफ़ॉल्ट वैल्यू, इनमें से किसी भी स्थिति में असाइन की जाएंगी:
    • आप उन प्रॉपर्टी के लिए मान तय नहीं करते हैं.
    • आपके अनुरोध में मौजूद part पैरामीटर की वैल्यू, उन प्रॉपर्टी वाले हिस्से के बारे में नहीं बताती.

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
insufficientPermissions insufficientLivePermissions अनुरोध को लाइव ब्रॉडकास्ट बनाने की अनुमति नहीं है.
insufficientPermissions livePermissionBlocked जिस उपयोगकर्ता ने अनुरोध करने की अनुमति दी है, वह इस समय YouTube पर लाइव वीडियो स्ट्रीम नहीं कर पा रहा है. उपयोगकर्ता के चैनल की सेटिंग में https://www.youtube.com/features पर जाकर यह जानकारी दी जा सकती है कि वह लाइव वीडियो क्यों स्ट्रीम नहीं कर सकता.
insufficientPermissions liveStreamingNotEnabled जिस उपयोगकर्ता ने अनुरोध करने की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. इस बारे में ज़्यादा जानकारी पाने के लिए, https://www.youtube.com/features पर जाएं.
invalidValue (400) invalidAutoStart liveBroadcast संसाधन में contentDetails.enableAutoStart प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. यह सेटिंग सभी ब्रॉडकास्ट पर काम नहीं करती.
invalidValue (400) invalidAutoStop liveBroadcast संसाधन में contentDetails.enableAutoStop प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. लगातार ब्रॉडकास्ट करने के लिए, enableAutoStop की सेटिंग में बदलाव नहीं किया जा सकता.
invalidValue (400) invalidDescription लाइव ब्रॉडकास्ट संसाधन ने snippet.description प्रॉपर्टी के लिए मान्य वैल्यू नहीं बताई. प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 5,000 वर्ण हो सकते हैं.
invalidValue (400) invalidEmbedSetting liveBroadcast संसाधन में contentDetails.enable_embed प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. आप इस ब्रॉडकास्ट को एम्बेड नहीं कर सकते.
invalidValue (400) invalidLatencyPreferenceOptions liveBroadcast संसाधन में contentDetails.latencyPreference प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. इंतज़ार के समय की इस प्राथमिकता के साथ सभी सेटिंग काम नहीं करती हैं.
invalidValue (400) invalidPrivacyStatus liveBroadcast संसाधन में status.privacy_status प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी.
invalidValue (400) invalidProjection liveBroadcast संसाधन में contentDetails.projection प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. डिफ़ॉल्ट ब्रॉडकास्ट का प्रोजेक्शन 360 पर सेट नहीं किया जा सकता.
invalidValue (400) invalidScheduledEndTime liveBroadcast संसाधन में snippet.scheduledEndTime प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. शेड्यूल किया गया समाप्ति समय शेड्यूल किए गए प्रारंभ समय के बाद होना चाहिए.
invalidValue (400) invalidScheduledStartTime liveBroadcast संसाधन में snippet.scheduledStartTime प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. शेड्यूल किया गया प्रारंभ समय भविष्य में होना चाहिए और उस वर्तमान तारीख के काफ़ी करीब होना चाहिए जब कोई प्रसारण उस समय पर विश्वसनीय रूप से शेड्यूल किया जा सकता हो.
invalidValue (400) invalidTitle लाइव ब्रॉडकास्ट संसाधन ने snippet.title प्रॉपर्टी के लिए मान्य वैल्यू नहीं बताई. प्रॉपर्टी की वैल्यू 1 से 100 वर्णों के बीच होनी चाहिए.
limitExceeded userBroadcastsExceedLimit उपयोगकर्ता ने कई लाइव या शेड्यूल किए गए ब्रॉडकास्ट बनाए हैं. इसलिए, उन्हें कुछ ब्रॉडकास्ट बंद करने होंगे या उन्हें मिटाना होगा.
rateLimitExceeded userRequestsExceedRateLimit उपयोगकर्ता ने दी गई समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं.
required (400) privacyStatusRequired लाइव ब्रॉडकास्ट संसाधन को निजता की स्थिति के बारे में बताना ज़रूरी है. privacyStatus की मान्य वैल्यू देखें.
required (400) scheduledEndTimeRequired liveBroadcast संसाधन में snippet.scheduledEndTime प्रॉपर्टी के बारे में जानकारी होनी चाहिए.
required (400) scheduledStartTimeRequired liveBroadcast संसाधन में snippet.scheduledStartTime प्रॉपर्टी के बारे में जानकारी होनी चाहिए.
required (400) titleRequired liveBroadcast संसाधन में snippet.title प्रॉपर्टी के बारे में जानकारी होनी चाहिए.

इसे आज़माएं!

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