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