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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.