LiveBroadcasts: bind

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