LiveBroadcasts: update

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

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

अनुरोध

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

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

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है. प्रमाणीकरण और अनुमति देने के बारे में ज़्यादा जानने के लिए, OAuth 2.0 ऑथराइज़ेशन लागू करना लेख पढ़ें.

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

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

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

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

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

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

    • snippet.title
    • snippet.description
    • snippet.categoryId
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.availabilityConfig
    • monetizationDetails.adsMonetizationStatus
    • monetizationDetails.cuepointSchedule.enabled
    • monetizationDetails.cuepointSchedule.pauseAdsUntil
    • monetizationDetails.cuepointSchedule.ytOptimizedCuepointConfig
    • monetizationDetails.cuepointSchedule.creatorCuepointConfig.scheduleStrategy
    • monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs

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

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
backendError (503) backendError कुछ सेटिंग अभी लागू नहीं की जा सकतीं. ऐसा इसलिए हो सकता है, क्योंकि ब्रॉडकास्ट अभी-अभी बनाया गया है. कृपया कुछ सेकंड बाद फिर से कोशिश करें.
forbidden (403) closedCaptionsTypeModificationNotAllowed contentDetails.closedCaptionsType एट्रिब्यूट की वैल्यू में सिर्फ़ तब बदलाव किया जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो.
forbidden (403) monetizationDetailsModificationNotAllowed जो चैनल YouTube Partner Program (YPP) में शामिल नहीं हैं वे किसी वीडियो के लिए monetizationDetails में बदलाव नहीं कर सकते.
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 पर मिल सकती है.
invalidArgument missingAdsMonetizationStatus ads_monetization_status को ON या OFF के तौर पर तय किया जाना चाहिए.
invalidValue (400) invalidAutoStart liveBroadcast संसाधन में, contentDetails.enableAutoStart प्रॉपर्टी के लिए अमान्य वैल्यू शामिल है. लगातार ब्रॉडकास्ट होने वाले मैसेज के लिए, enableAutoStart सेटिंग में बदलाव नहीं किया जा सकता.
invalidValue (400) invalidAutoStop liveBroadcast संसाधन में contentDetails.enableAutoStop प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. लगातार चलने वाले ब्रॉडकास्ट के लिए, enableAutoStop सेटिंग में बदलाव नहीं किया जा सकता.
invalidValue (400) invalidDescription liveBroadcast संसाधन में, snippet.description प्रॉपर्टी के लिए मान्य वैल्यू नहीं दी गई है. snippet.description में ज़्यादा से ज़्यादा 5,000 वर्ण हो सकते हैं.
invalidValue (400) invalidEmbedSetting liveBroadcast संसाधन में, contentDetails.enable_embed प्रॉपर्टी के लिए अमान्य वैल्यू शामिल है. इस ब्रॉडकास्ट को एम्बेड नहीं किया जा सकता.
invalidValue (400) invalidEnableClosedCaptions liveBroadcast संसाधन में, contentDetails.enableClosedCaptions प्रॉपर्टी की वैल्यू, contentDetails.closedCaptionType सेटिंग की वैल्यू के साथ काम नहीं करती. संसाधन में बदलाव करें, ताकि उसमें दोनों में से सिर्फ़ एक प्रॉपर्टी शामिल हो. इसके बाद, अनुरोध को फिर से सबमिट करें.
invalidValue (400) invalidLatencyPreferenceOptions liveBroadcast संसाधन में, contentDetails.latencyPreference प्रॉपर्टी के लिए अमान्य वैल्यू शामिल है. विलंबता की इस सेटिंग के साथ सभी सेटिंग काम नहीं करती हैं.
invalidValue (400) invalidEligibleForAdsMonetization eligible_for_ads_monetization को सिर्फ़ पढ़ा जा सकता है. इसे monetization_details फ़ील्ड में नहीं डाला जा सकता.
invalidValue (400) invalidCuepointSchedule liveBroadcast संसाधन में monetizationDetails.cuepointSchedule प्रॉपर्टी के लिए अमान्य वैल्यू है. यह गड़बड़ी इन वजहों से हो सकती है:
  • अगर ads_monetization_status की वैल्यू OFF है, तो cuepoint_schedule की वैल्यू नहीं दी जा सकती.
  • अगर ads_monetization_status की वैल्यू ON है, तो cuepoint_schedule की वैल्यू देना ज़रूरी है.
 अगर ads_monetization_status बंद है, तो cuepoint_schedule की वैल्यू नहीं दी जा सकती.
invalidValue (400) invalidEnabled liveBroadcast संसाधन में, monetizationDetails.cuepointSchedule.enabled प्रॉपर्टी के लिए अमान्य या मेल न खाने वाली वैल्यू मौजूद है. यह गड़बड़ी इन वजहों से हो सकती है:
  • enabled को cuepoint_schedule फ़ील्ड में बताना ज़रूरी है.
  • pause_ads_until, yt_optimized_cuepoint_config या creator_cuepoint_config की वैल्यू नहीं दी जा सकती, अगर enabled की वैल्यू 'गलत' पर सेट है.
  • अगर enabled की वैल्यू 'सही है' पर सेट है, तो yt_optimized_cuepoint_config और creator_cuepoint_config में से सिर्फ़ एक को चुना जा सकता है.
invalidValue (400) invalidCreatorCuepointConfig schedule_strategy और repeat_interval_secs, दोनों की जानकारी देना ज़रूरी है.
invalidValue (400) invalidRepeatIntervalSecs repeat_interval_secs प्रॉपर्टी की वैल्यू, [360, 3600] की रेंज में होनी चाहिए.
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 प्रॉपर्टी से, ब्रॉडकास्ट की पहचान नहीं हो पाई.
preconditionFailed (412) videoNotEligibleForAdsMonetization वीडियो पर विज्ञापन दिखाने की सुविधा चालू नहीं की जा सकती. ऐसा तब हो सकता है, जब चैनल कमाई करने की ज़रूरी शर्तें पूरी न करता हो.
required (400) broadcastStreamDelayMsRequired लाइव ब्रॉडकास्ट रिसॉर्स में, contentDetails.monitorStream.broadcastStreamDelayMs प्रॉपर्टी की वैल्यू नहीं दी गई है.
required (400) enableMonitorStreamRequired liveBroadcast संसाधन में, contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी की जानकारी नहीं दी गई है.
required (400) idRequired liveBroadcast संसाधन में, id प्रॉपर्टी की वैल्यू शामिल होनी चाहिए और उसकी जानकारी दी जानी चाहिए.
required (400) scheduledEndTimeRequired लाइव ब्रॉडकास्ट रिसॉर्स में, snippet.scheduledEndTime प्रॉपर्टी की वैल्यू नहीं दी गई है.
required (400) scheduledStartTimeRequired liveBroadcast संसाधन में, snippet.scheduledStartTime प्रॉपर्टी की जानकारी नहीं दी गई है.

इसे आज़माएं!

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