ब्रॉडकास्ट को अपडेट करता है. उदाहरण के लिए, आपके पास 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 फ़ील्ड में बदलाव नहीं किया जा सकता.
यह गड़बड़ी इन वजहों से हो सकती है:
|
forbidden (403) |
enableAutoStartModificationNotAllowed |
contentDetails.enableAutoStart वैल्यू में सिर्फ़ तब बदलाव किया जा सकता है, जब स्ट्रीम बंद हो और ब्रॉडकास्ट created या ready स्थिति में हो. |
forbidden (403) |
enableClosedCaptionsModificationNotAllowed |
contentDetails.enableClosedCaptions वैल्यू को सिर्फ़ तब बदला जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो. |
forbidden (403) |
enableDvrModificationNotAllowed |
contentDetails. वैल्यू में सिर्फ़ तब बदलाव किया जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो. |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
contentDetails. वैल्यू में सिर्फ़ तब बदलाव किया जा सकता है, जब ब्रॉडकास्ट की स्थिति created या ready हो. |
forbidden (403) |
recordFromStartModificationNotAllowed |
contentDetails. वैल्यू में सिर्फ़ तब बदलाव किया जा सकता है, जब ब्रॉडकास्ट की स्थिति 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 प्रॉपर्टी के लिए एक अमान्य वैल्यू मौजूद है.
यह गड़बड़ी इन वजहों से हो सकती है:
|
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. प्रॉपर्टी के बारे में नहीं बताया. |
required (400) |
enableMonitorStreamRequired |
लाइव ब्रॉडकास्ट संसाधन ने contentDetails. प्रॉपर्टी के बारे में नहीं बताया. |
required (400) |
idRequired |
लाइव ब्रॉडकास्ट संसाधन में id प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए. साथ ही, उसके लिए कोई वैल्यू भी तय करनी चाहिए. |
required (400) |
scheduledEndTimeRequired |
लाइव ब्रॉडकास्ट संसाधन ने snippet.scheduledEndTime प्रॉपर्टी के बारे में नहीं बताया. |
required (400) |
scheduledStartTimeRequired |
लाइव ब्रॉडकास्ट संसाधन ने snippet.scheduledStartTime प्रॉपर्टी के बारे में नहीं बताया. |
इसे आज़माएं!
इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.