LiveBroadcasts: control

ध्यान दें: liveBroadcasts.control के इस्तेमाल पर रोक लगा दी गई है और यह 1 अक्टूबर, 2020 से या उसके बाद काम नहीं करेगा. इस तारीख के बाद, इस तरीके का इस्तेमाल करने पर कॉल के लिए 403 गड़बड़ी दिखेगी और बाद में यह तरीका पूरी तरह से हटा दिया जाएगा.

क्लाइंट अब भी YouTube पर डेटा डालने वाले सर्वर पर भेजे गए वीडियो में ओवरले जोड़कर, अपने स्लेट को लागू कर सकते हैं. समर्थन नहीं होने की घोषणा देखें.

इस नीति से ब्रॉडकास्ट स्ट्रीम में दिखाए जा सकने वाले स्लेट की सेटिंग को कंट्रोल किया जाता है.

इस्तेमाल के सामान्य उदाहरण

अनुरोध करें

एचटीटीपी अनुरोध

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/control

अनुमति दें

इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है. पुष्टि करने और अनुमति देने के बारे में ज़्यादा जानें.

दायरा
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

इस टेबल में ऐसे पैरामीटर दिए गए हैं जो क्वेरी के साथ काम करते हैं. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
id	string id पैरामीटर से उस YouTube लाइव ब्रॉडकास्ट आईडी का पता चलता है जो उस ब्रॉडकास्ट की खास तौर पर पहचान करता है जिसमें स्लेट अपडेट किया जा रहा है.
part	string part पैरामीटर में, liveBroadcast संसाधन प्रॉपर्टी की ऐसी कॉमा-सेपरेटेड लिस्ट होती है जिसमें एपीआई से रिस्पॉन्स शामिल होता है. id, snippet, contentDetails, और status को part वैल्यू में शामिल किया जा सकता है.
ज़रूरी पैरामीटर
displaySlate	boolean displaySlate पैरामीटर से पता चलता है कि स्लेट चालू है या बंद.
offsetTimeMs	unsigned long offsetTimeMs पैरामीटर से स्लेट में बदलाव होने पर, पॉज़िटिव टाइम ऑफ़सेट की जानकारी मिलती है. इस मान को ब्रॉडकास्ट की निगरानी वाली स्ट्रीम की शुरुआत से मिलीसेकंड में मापा जाता है. यह वही समय होता है जब ब्रॉडकास्ट के लिए टेस्टिंग का चरण शुरू होता है. भले ही यह मिलीसेकंड में तय किया गया हो, लेकिन वैल्यू असल में एक अनुमान है. YouTube, अनुरोध की गई कार्रवाई को उस समय के लिए जितना हो सके उतना करीब से पूरा करता है. अगर आपने इस पैरामीटर के लिए कोई वैल्यू नहीं दी है, तो YouTube जल्द से जल्द कार्रवाई करेगा. ज़्यादा जानकारी के लिए, शुरू करने का तरीका गाइड देखें. अहम जानकारी: अगर ब्रॉडकास्ट स्ट्रीम देर से करनी है, तो ही आपको इस पैरामीटर की वैल्यू डालनी चाहिए.
onBehalfOfContentOwner	string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए.
onBehalfOfContentOwnerChannel	string इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से किए गए अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है. onBehalfOfContentOwnerChannel पैरामीटर से उस चैनल के YouTube चैनल आईडी का पता चलता है जिसमें वीडियो जोड़ा जा रहा है. यह पैरामीटर तब ज़रूरी होता है, जब कोई अनुरोध onBehalfOfContentOwner पैरामीटर के लिए वैल्यू तय करता है. साथ ही, इसका इस्तेमाल सिर्फ़ उसी पैरामीटर के साथ किया जा सकता है. साथ ही, अनुरोध को ऐसे कॉन्टेंट मैनेजमेंट सिस्टम से लिंक किया जाना चाहिए जो कॉन्टेंट के मालिक से जुड़ा हो और onBehalfOfContentOwner पैरामीटर के बारे में बताता हो. आखिर में, onBehalfOfContentOwnerChannel पैरामीटर की वैल्यू के बारे में बताने वाला चैनल, उस कॉन्टेंट के मालिक से जुड़ा होना चाहिए जिसका onBehalfOfContentOwner पैरामीटर तय करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इसकी मदद से कॉन्टेंट के मालिक एक बार में पुष्टि कर सकते हैं. साथ ही, पैरामीटर की वैल्यू में बताए गए चैनल की तरफ़ से कार्रवाई कर सकते हैं. इसके लिए, हर अलग चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती.
walltime	datetime walltime पैरामीटर, वॉल टाइम की वह समयावधि बताता है जब स्लेट में बदलाव किया जाता है. वैल्यू ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में होती है.

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

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

जवाब

अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में LiveBroadcast रिसॉर्स मिलता है.

गड़बड़ियां

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

गड़बड़ी का टाइप	गड़बड़ी की जानकारी	ब्यौरा
backendError	errorDisplaySlate	अनुरोध की गई कार्रवाई करते समय कोई गड़बड़ी हुई.
forbidden (403)	liveBroadcastControlNotAllowed	अनुरोध की गई कार्रवाई की अनुमति सिर्फ़ तभी दी जा सकती है, जब ब्रॉडकास्ट का स्टेटस live हो.
insufficientPermissions	insufficientLivePermissions	ऐसा हो सकता है कि उपयोगकर्ता के पास अनुरोध की गई कार्रवाई करने की अनुमति न हो. इसकी वजह यह है कि उपयोगकर्ता के पास लाइव स्ट्रीम करने की अनुमति नहीं है.
insufficientPermissions	liveStreamingNotEnabled	जिस उपयोगकर्ता ने अनुरोध की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. उपयोगकर्ता https://www.youtube.com/features पर ज़्यादा जानकारी पा सकते हैं.
invalidValue (400)	conflictingTimeFields	offsetTimeMs और walltime में से सिर्फ़ एक ही तय किया जा सकता है.
invalidValue (400)	invalidOffsetTimeMs	offsetTimeMs पैरामीटर की वैल्यू अमान्य है. पैरामीटर की वैल्यू पॉज़िटिव होनी चाहिए. हालांकि, पैरामीटर को सिर्फ़ तब तय किया जा सकता है, जब ब्रॉडकास्ट की मॉनिटर स्ट्रीम चालू हो.
invalidValue (400)	invalidWalltime	walltime पैरामीटर की वैल्यू अमान्य है.
notFound (404)	liveBroadcastNotFound	id पैरामीटर से तय किया गया ब्रॉडकास्ट मौजूद नहीं है.
required (400)	actionRequired	एपीआई अनुरोध के लिए कम से कम एक कार्रवाई तय करनी होगी. इस समय, स्लेट को सक्षम या अक्षम करने की क्षमता केवल समर्थित है.
required (400)	idRequired	ज़रूरी id पैरामीटर को उस ब्रॉडकास्ट की पहचान करनी होगी जिसे अपडेट किया जा रहा है.

इसे आज़माएं!

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