LiveBroadcasts: transition

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

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

अनुरोध

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

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

अनुमति देना

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

दायरा
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 CMS के उस उपयोगकर्ता की पहचान होती है जो पैरामीटर वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube कॉन्टेंट पार्टनर के लिए है. इनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और वे उन्हें मैनेज करते हैं. इसकी मदद से, कॉन्टेंट के मालिक एक बार पुष्टि करके अपने सभी वीडियो और चैनल का डेटा ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस सीएमएस खाते से पुष्टि करता है वह YouTube कॉन्टेंट के मालिक से लिंक होना चाहिए.
onBehalfOfContentOwnerChannel string
इस पैरामीटर का इस्तेमाल सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है.

ध्यान दें: यह पैरामीटर सिर्फ़ YouTube कॉन्टेंट पार्टनर के लिए है.

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

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

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

इस तरीके को कॉल करते समय, अनुरोध बॉडी न दें.

जवाब

अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में liveBroadcast रिसॉर्स दिखाता है.

गड़बड़ियां

नीचे दी गई टेबल में, गड़बड़ी के ऐसे मैसेज की जानकारी दी गई है जो इस तरीके के कॉल के जवाब में एपीआई दिखा सकता है. ज़्यादा जानकारी के लिए, YouTube Live Streaming API - गड़बड़ियां देखें.

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

इसे आज़माएं!

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