LiveBroadcasts: transition

YouTube लाइव ब्रॉडकास्ट की स्थिति बदलता है और नई स्थिति से जुड़ी सभी प्रोसेस शुरू करता है. उदाहरण के लिए, जब आप ब्रॉडकास्ट का स्टेटस testing पर स्विच करते हैं, तो YouTube उस ब्रॉडकास्ट की मॉनिटर स्ट्रीम पर वीडियो शेयर करना शुरू कर देता है. इस तरीके को कॉल करने से पहले, आपको इस बात की पुष्टि कर लेनी चाहिए कि आपके ब्रॉडकास्ट की बाइंड स्ट्रीम के लिए status.streamStatus प्रॉपर्टी की वैल्यू active है.

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

अनुरोध करें

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

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition

अनुमति दें

इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.

दायरा
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
broadcastStatus string
broadcastStatus पैरामीटर से उस स्थिति का पता चलता है जिसमें ब्रॉडकास्ट बदला जा रहा है. ध्यान दें कि ब्रॉडकास्ट को testing या live में से किसी एक पर स्विच करने के लिए, status.streamStatus को उस स्ट्रीम के लिए active होना चाहिए जिस पर ब्रॉडकास्ट लागू होगा.

इन वैल्यू को स्वीकार किया जाता है:
  • complete – ब्रॉडकास्ट हो गया है. YouTube, वीडियो को ट्रांसमिट करना बंद कर देता है.
  • live – ब्रॉडकास्ट अपने दर्शकों को दिखता है. YouTube, वीडियो को ब्रॉडकास्ट की निगरानी स्ट्रीम और उसकी ब्रॉडकास्ट स्ट्रीम में भेजता है.
  • testing – ब्रॉडकास्ट को शुरू करना. YouTube, वीडियो को ब्रॉडकास्ट की निगरानी स्ट्रीम पर भेजता है. ध्यान दें कि आप किसी प्रसारण को केवल testing स्थिति में तब ही ट्रांज़िशन कर सकते हैं, जब उसकी contentDetails.monitorStream.enableMonitorStream प्रॉपर्टी true पर सेट हो.
id string
id पैरामीटर, ब्रॉडकास्ट के उस यूनीक आईडी के बारे में बताता है जो किसी दूसरी स्थिति में जा रहा है.
part string
part पैरामीटर में, liveBroadcast संसाधन प्रॉपर्टी की ऐसी कॉमा-सेपरेटेड लिस्ट होती है जिसमें एपीआई से रिस्पॉन्स शामिल होता है. id, snippet, contentDetails, और status को part वैल्यू में शामिल किया जा सकता है.
ज़रूरी पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है.

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

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

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

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

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में LiveBroadcast रिसॉर्स मिलता है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
backendError errorExecutingTransition ब्रॉडकास्ट की स्थिति बदलते समय कोई गड़बड़ी हुई.
forbidden (403) errorStreamInactive ब्रॉडकास्ट के लिए ज़रूरी स्ट्रीम के बंद होने पर, अनुरोध नहीं किया जा सकता.
forbidden (403) invalidTransition लाइव ब्रॉडकास्ट का स्टेटस, मौजूदा स्थिति से अनुरोध की गई स्थिति में नहीं जा सकता.
forbidden (403) redundantTransition लाइव प्रसारण पहले से ही अनुरोध की गई स्थिति में है या अनुरोध की गई स्थिति पर प्रोसेस किया जा रहा है.
insufficientPermissions insufficientLivePermissions इस अनुरोध को लाइव ब्रॉडकास्ट में बदलाव करने की अनुमति नहीं है.
insufficientPermissions livePermissionBlocked जिस उपयोगकर्ता ने अनुरोध किया है वह फ़िलहाल YouTube पर लाइव वीडियो नहीं चला सकता. https://www.youtube.com/features पर उपयोगकर्ता के चैनल की सेटिंग में जाकर, यह जानकारी दी जा सकती है कि उपयोगकर्ता क्यों लाइव वीडियो स्ट्रीम नहीं कर सकते.
insufficientPermissions liveStreamingNotEnabled जिस उपयोगकर्ता ने अनुरोध की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. उपयोगकर्ता https://www.youtube.com/features पर ज़्यादा जानकारी पा सकते हैं.
notFound (404) liveBroadcastNotFound id पैरामीटर से तय किया गया ब्रॉडकास्ट मौजूद नहीं है.
rateLimitExceeded (403) userRequestsExceedRateLimit उपयोगकर्ता ने एक तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं.
required (400) idRequired ज़रूरी id पैरामीटर को उस ब्रॉडकास्ट की पहचान करनी होगी जिसकी स्थिति आपको बदलनी है.
required (400) statusRequired एपीआई अनुरोध में status पैरामीटर के लिए एक वैल्यू तय करनी होगी.

इसे आज़माएं!

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