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 पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने वाली कार्रवाई सेट की जाएगी. साथ ही, उन प्रॉपर्टी की भी पहचान होती है जिनमें एपीआई के रिस्पॉन्स में शामिल होगा.

पैरामीटर की वैल्यू में id, snippet, contentDetails, monetizationDetails, और status जैसी part प्रॉपर्टी शामिल की जा सकती हैं.

ध्यान दें कि इस तरीके से, बदली जा सकने वाली उन सभी प्रॉपर्टी की मौजूदा वैल्यू बदल जाएंगी जो पैरामीटर वैल्यू में मौजूद हैं. उदाहरण के लिए, ब्रॉडकास्ट की निजता की स्थिति 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.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 लाइव ब्रॉडकास्ट संसाधन ने 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) 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 लाइव ब्रॉडकास्ट संसाधन ने निजता की मान्य स्थिति के बारे में नहीं बताया. privacyStatus की मान्य वैल्यू देखें.
invalidValue (400) invalidProjection liveBroadcast संसाधन में contentDetails.projection प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. लगातार होने वाले ब्रॉडकास्ट का प्रोजेक्शन 360 पर सेट नहीं किया जा सकता.
invalidValue (400) invalidScheduledEndTime liveBroadcast संसाधन में snippet.scheduledEndTime प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. शेड्यूल किया गया समाप्ति समय शेड्यूल किए गए प्रारंभ समय के बाद होना चाहिए.
invalidValue (400) invalidScheduledStartTime liveBroadcast संसाधन में snippet.scheduledStartTime प्रॉपर्टी के लिए अमान्य वैल्यू मौजूद थी. शेड्यूल किया गया प्रारंभ समय भविष्य में होना चाहिए.
invalidValue (400) invalidTitle लाइव ब्रॉडकास्ट संसाधन ने snippet.title प्रॉपर्टी के लिए मान्य वैल्यू नहीं बताई. snippet.title, 1 से 100 वर्णों के बीच होना चाहिए.
notFound (404) liveBroadcastNotFound liveBroadcast संसाधन में मौजूद id प्रॉपर्टी ने किसी ब्रॉडकास्ट की पहचान नहीं की.
required (400) broadcastStreamDelayMsRequired लाइव ब्रॉडकास्ट संसाधन ने contentDetails.monitorStream.broadcastStreamDelayMs प्रॉपर्टी के बारे में नहीं बताया.
required (400) enableMonitorStreamRequired लाइव ब्रॉडकास्ट संसाधन ने contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी के बारे में नहीं बताया.
required (400) idRequired लाइव ब्रॉडकास्ट संसाधन में id प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए. साथ ही, उसके लिए कोई वैल्यू भी तय करनी चाहिए.
required (400) scheduledEndTimeRequired लाइव ब्रॉडकास्ट संसाधन ने snippet.scheduledEndTime प्रॉपर्टी के बारे में नहीं बताया.
required (400) scheduledStartTimeRequired लाइव ब्रॉडकास्ट संसाधन ने snippet.scheduledStartTime प्रॉपर्टी के बारे में नहीं बताया.

इसे आज़माएं!

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