YouTube ब्रॉडकास्ट को स्ट्रीम से बाइंड करता है या ब्रॉडकास्ट और स्ट्रीम के बीच मौजूद बाइंडिंग को हटाता है. ब्रॉडकास्ट को सिर्फ़ एक वीडियो स्ट्रीम से जोड़ा जा सकता है. हालांकि, एक वीडियो स्ट्रीम एक से ज़्यादा ब्रॉडकास्ट से भी जुड़ी हो सकती है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/bind
अनुमति दें
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.
दायरा |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
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 चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इसकी मदद से कॉन्टेंट के मालिक एक बार में पुष्टि कर सकते हैं. साथ ही, पैरामीटर की वैल्यू में बताए गए चैनल की तरफ़ से कार्रवाई कर सकते हैं. इसके लिए, हर अलग चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. |
|
streamId |
string streamId पैरामीटर उस वीडियो स्ट्रीम का यूनीक आईडी बताता है जिसे ब्रॉडकास्ट से जोड़ा जा सकता है. अगर यह पैरामीटर मौजूद नहीं है, तो एपीआई, ब्रॉडकास्ट और वीडियो स्ट्रीम के बीच की सभी बाइंडिंग हटा देगा. |
अनुरोध का मुख्य भाग
इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.
जवाब
अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में LiveBroadcast रिसॉर्स मिलता है.
गड़बड़ियां
इस टेबल में उन गड़बड़ी के मैसेज के बारे में बताया गया है जो इस तरीके से कॉल करने पर एपीआई मिल सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | ब्यौरा |
---|---|---|
backendError |
internalError |
बाइंडिंग के दौरान सिस्टम में कोई गड़बड़ी हुई. |
forbidden (403) |
liveBroadcastBindingNotAllowed |
लाइव ब्रॉडकास्ट की मौजूदा स्थिति की वजह से, किसी स्ट्रीम के लिए यह सुविधा उपलब्ध नहीं है. |
insufficientPermissions |
insufficientLivePermissions |
अनुरोध को बताए गए लाइव प्रसारण को पाने की अनुमति नहीं है. ज़्यादा जानकारी के लिए, OAuth2 पुष्टि को लागू करना देखें. |
insufficientPermissions |
liveStreamingNotEnabled |
जिस उपयोगकर्ता ने अनुरोध की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. उपयोगकर्ता https://www.youtube.com/features पर ज़्यादा जानकारी पा सकते हैं. |
notFound (404) |
liveBroadcastNotFound |
id पैरामीटर से तय किया गया ब्रॉडकास्ट मौजूद नहीं है. |
notFound (404) |
liveStreamNotFound |
streamId पैरामीटर से जुड़ी स्ट्रीम मौजूद नहीं है. |
rateLimitExceeded |
userRequestsExceedRateLimit |
उपयोगकर्ता ने एक तय समयसीमा में बहुत ज़्यादा अनुरोध भेजे हैं. |
required (400) |
idRequired |
बाइंड करने के लिए, ज़रूरी id पैरामीटर ब्रॉडकास्ट की पहचान कर सकता है. |
इसे आज़माएं!
इस एपीआई को कॉल करने और एपीआई का अनुरोध और जवाब देखने के लिए, APIs Explorer का इस्तेमाल करें.