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 होना चाहिए जिस पर ब्रॉडकास्ट लागू होगा.इन वैल्यू को स्वीकार किया जाता है:
|
|
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 का इस्तेमाल करें.