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

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

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

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

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

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

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
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 उपयोगकर्ता ने तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं.
rateLimitExceeded (403) concurrentBroadcastsExceedLimit चैनल पर एक साथ लाइव ब्रॉडकास्ट करने की तय सीमा पहले ही पूरी हो चुकी है. अगर चैनल पर पहले से ही एक या उससे ज़्यादा ब्रॉडकास्ट लाइव हैं, तो उन्हें बंद करना होगा. इसके बाद ही, चैनल पर कोई दूसरा ब्रॉडकास्ट शुरू किया जा सकता है.
rateLimitExceeded (403) sharedIngestionBroadcastsExceedLimit चैनल पर पहले से ही, लाइव ब्रॉडकास्ट की तय सीमा पूरी हो चुकी है. अनुरोध की गई ब्रॉडकास्टिंग शुरू करने के लिए, इनमें से एक या उससे ज़्यादा ब्रॉडकास्टिंग बंद करनी होंगी.
required (400) idRequired ज़रूरी id पैरामीटर से उस ब्रॉडकास्ट की पहचान होनी चाहिए जिसकी स्थिति को आपको बदलना है.
required (400) statusRequired एपीआई अनुरोध में, status पैरामीटर के लिए कोई वैल्यू तय करना ज़रूरी है.

इसे आज़माएं!

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