LiveBroadcasts: update

ब्रॉडकास्ट को अपडेट करता है. उदाहरण के लिए, आपके पास liveBroadcast संसाधन के contentDetails ऑब्जेक्ट में दी गई ब्रॉडकास्ट सेटिंग में बदलाव करने का विकल्प होता है.

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

अनुरोध

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

PUT 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, monetizationDetails, और status हैं.

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

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

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

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

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

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

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

    • id
    • snippet.scheduledStartTime
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs

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

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

    अगर अपडेट का अनुरोध सबमिट किया जा रहा है और आपके अनुरोध में ऐसी प्रॉपर्टी के लिए कोई वैल्यू तय नहीं की गई है जिसकी कोई वैल्यू पहले से मौजूद है, तो उस प्रॉपर्टी की मौजूदा वैल्यू मिटा दी जाएगी.

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) closedCaptionsTypeModificationNotAllowed contentDetails.closedCaptionsType वैल्यू को सिर्फ़ तब बदला जा सकता है, जब ब्रॉडकास्ट created या ready स्थिति में हो.
forbidden (403) enabledModificationNotAllowed enabled फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
forbidden (403) scheduleStrategyModificationNotAllowed scheduleStrategy फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
forbidden (403) repeatIntervalSecsModificationNotAllowed repeatIntervalSecs फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.
forbidden (403) pauseAdsUntilModificationNotAllowed pauseAdsUntil फ़ील्ड में बदलाव नहीं किया जा सकता. यह गड़बड़ी इन वजहों से हो सकती है:
  • monetizationDetails.cuepointSchedule.enabled फ़ील्ड को true पर सेट नहीं किया गया है. इस फ़ील्ड को सिर्फ़ YouTube Studio में सेट किया जा सकता है.
  • प्रसारण लाइव नहीं है.
forbidden (403) enableAutoStartModificationNotAllowed contentDetails.enableAutoStart की वैल्यू में बदलाव सिर्फ़ तब किया जा सकता है, जब स्ट्रीम बंद हो और ब्रॉडकास्ट की स्थिति created या ready में हो.
forbidden (403) enableClosedCaptionsModificationNotAllowed contentDetails.enableClosedCaptions वैल्यू को सिर्फ़ तब बदला जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो.
forbidden (403) enableDvrModificationNotAllowed contentDetails.enableDvr मान को सिर्फ़ तब बदला जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो.
forbidden (403) enableMonitorStreamModificationNotAllowed contentDetails.monitorStream.enableMonitorStream मान को सिर्फ़ तब बदला जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो.
forbidden (403) recordFromStartModificationNotAllowed contentDetails.recordFromStart मान को सिर्फ़ तब बदला जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो.
insufficientPermissions insufficientLivePermissions अनुरोध को बताए गए लाइव प्रसारण को अपडेट करने की अनुमति नहीं है. ज़्यादा जानकारी के लिए, OAuth2 की पुष्टि करने की प्रक्रिया को लागू करना लेख पढ़ें.
insufficientPermissions liveStreamingNotEnabled जिस उपयोगकर्ता ने अनुरोध करने की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. उपयोगकर्ता https://www.youtube.com/features पर ज़्यादा जानकारी पा सकते हैं.
invalidValue (400) invalidAutoStart liveBroadcast रिसॉर्स में contentDetails.enableAutoStart प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. लगातार ब्रॉडकास्ट करने के लिए, enableAutoStart की सेटिंग में बदलाव नहीं किया जा सकता.
invalidValue (400) invalidAutoStop liveBroadcast रिसॉर्स में contentDetails.enableAutoStop प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. लगातार ब्रॉडकास्ट करने के लिए, enableAutoStop की सेटिंग में बदलाव नहीं किया जा सकता.
invalidValue (400) invalidDescription liveBroadcast रिसॉर्स ने snippet.description प्रॉपर्टी के लिए कोई मान्य वैल्यू नहीं बताई है. snippet.description में ज़्यादा से ज़्यादा 5000 वर्ण हो सकते हैं.
invalidValue (400) invalidEmbedSetting liveBroadcast रिसॉर्स में contentDetails.enable_embed प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. आप इस ब्रॉडकास्ट को एम्बेड नहीं कर सकते.
invalidValue (400) invalidEnableClosedCaptions लाइव ब्रॉडकास्ट संसाधन में, contentDetails.enableClosedCaptions प्रॉपर्टी की वैल्यू, contentDetails.closedCaptionType सेटिंग की वैल्यू के साथ काम नहीं करती. संसाधन में बदलाव करके, दोनों में से सिर्फ़ एक प्रॉपर्टी को शामिल करें. इसके बाद, अनुरोध को फिर से सबमिट करें.
invalidValue (400) invalidLatencyPreferenceOptions liveBroadcast रिसॉर्स में contentDetails.latencyPreference प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. इंतज़ार के समय की इस प्राथमिकता के साथ सभी सेटिंग काम नहीं करती हैं.
invalidValue (400) invalidPauseAdsUntil liveBroadcast रिसॉर्स में monetizationDetails.cuepointSchedule.pauseAdsUntil प्रॉपर्टी के लिए एक अमान्य वैल्यू शामिल है. यह गड़बड़ी इन वजहों से हो सकती है:
  • monetizationDetails.cuepointSchedule.pauseAdsUntil की वैल्यू, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में नहीं दी गई है.
  • monetizationDetails.cuepointSchedule.pauseAdsUntil वैल्यू आने वाले समय की नहीं है.
  • monetizationDetails.cuepointSchedule.pauseAdsUntil की वैल्यू, मौजूदा समय से 10 मिनट बाद की है.
invalidValue (400) invalidPrivacyStatus liveBroadcast संसाधन ने मान्य निजता स्थिति के बारे में नहीं बताया. privacyStatus की मान्य वैल्यू देखें.
invalidValue (400) invalidProjection liveBroadcast रिसॉर्स में contentDetails.projection प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. स्थायी ब्रॉडकास्ट का प्रोजेक्शन 360 पर सेट नहीं किया जा सकता.
invalidValue (400) invalidScheduledEndTime liveBroadcast रिसॉर्स में snippet.scheduledEndTime प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. शेड्यूल किया गया खत्म होने का समय, शेड्यूल किए गए शुरू होने के समय के बाद होना चाहिए.
invalidValue (400) invalidScheduledStartTime liveBroadcast रिसॉर्स में snippet.scheduledStartTime प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है. शेड्यूल किया गया प्रारंभ समय भविष्य में होना चाहिए.
invalidValue (400) invalidTitle liveBroadcast रिसॉर्स ने snippet.title प्रॉपर्टी के लिए कोई मान्य वैल्यू नहीं बताई है. snippet.title, 1 से 100 वर्णों का होना चाहिए.
notFound (404) liveBroadcastNotFound liveBroadcast रिसॉर्स में दी गई id प्रॉपर्टी से, किसी ब्रॉडकास्ट की पहचान नहीं हुई.
required (400) broadcastStreamDelayMsRequired liveBroadcast रिसॉर्स ने contentDetails.monitorStream.broadcastStreamDelayMs प्रॉपर्टी के बारे में नहीं बताया है.
required (400) enableMonitorStreamRequired liveBroadcast रिसॉर्स ने contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी के बारे में नहीं बताया है.
required (400) idRequired liveBroadcast रिसॉर्स में id प्रॉपर्टी के लिए वैल्यू शामिल होनी चाहिए. साथ ही, इसके लिए एक वैल्यू भी तय करनी होगी.
required (400) scheduledEndTimeRequired liveBroadcast रिसॉर्स ने snippet.scheduledEndTime प्रॉपर्टी के बारे में नहीं बताया है.
required (400) scheduledStartTimeRequired liveBroadcast रिसॉर्स ने snippet.scheduledStartTime प्रॉपर्टी के बारे में नहीं बताया है.

इसे आज़माएं!

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