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 संसाधन प्रॉपर्टी की ऐसी सूची के बारे में बताता है जिसे कॉमा लगाकर अलग किया गया है. यह सूची, एपीआई के रिस्पॉन्स में शामिल होती है. पैरामीटर वैल्यू में शामिल किए जा सकने वाले part नाम, id, snippet, contentDetails, और status हैं.
वैकल्पिक पैरामीटर
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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.