LiveStreams: update

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

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

अनुरोध करें

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

PUT https://www.googleapis.com/youtube/v3/liveStreams

अनुमति दें

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

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

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
part कार्रवाई के लिए दो पैरामीटर इस्तेमाल किए जाते हैं. इससे पता चलता है कि लिखने की कार्रवाई, प्रॉपर्टी के साथ-साथ एपीआई प्रॉपर्टी में शामिल की जाने वाली प्रॉपर्टी की है या नहीं.

पैरामीटर वैल्यू में जो part प्रॉपर्टी शामिल की जा सकती हैं वे id, snippet, cdn, और status हैं.

ध्यान दें कि यह तरीका उन सभी बदली जा सकने वाली प्रॉपर्टी की मौजूदा वैल्यू को बदल देगा जो पैरामीटर वैल्यू में शामिल होती हैं. अगर अनुरोध के मुख्य हिस्से में किसी बदली जा सकने वाली प्रॉपर्टी के लिए मान नहीं दिया गया है, तो उस प्रॉपर्टी के लिए मौजूदा मान को हटा दिया जाएगा.
ज़रूरी पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है.

onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध की पुष्टि के लिए, किसी YouTube कॉन्टेंट मैनेजमेंट सिस्टम के उपयोगकर्ता की पहचान की गई है. यह उपयोगकर्ता, पैरामीटर वैल्यू में तय किए गए कॉन्टेंट के मालिक की तरफ़ से काम करता है. यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जो कई अलग-अलग YouTube चैनलों के मालिक हैं और उन्हें प्रबंधित करते हैं. इसकी मदद से कॉन्टेंट के मालिक एक बार पुष्टि कर सकते हैं. साथ ही, अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल नहीं देने होंगे. जिस कॉन्टेंट मैनेजमेंट सिस्टम खाते से उपयोगकर्ता की पुष्टि होती है उसे YouTube के कॉन्टेंट के मालिक से लिंक होना चाहिए.
onBehalfOfContentOwnerChannel string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से किए गए अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube कॉन्टेंट पार्टनर के लिए है.

onBehalfOfContentOwnerChannel पैरामीटर से उस चैनल के YouTube चैनल आईडी का पता चलता है जिसमें वीडियो जोड़ा जा रहा है. यह पैरामीटर तब ज़रूरी होता है, जब कोई अनुरोध onBehalfOfContentOwner पैरामीटर के लिए वैल्यू तय करता है. साथ ही, इसका इस्तेमाल सिर्फ़ उसी पैरामीटर के साथ किया जा सकता है. साथ ही, अनुरोध को ऐसे कॉन्टेंट मैनेजमेंट सिस्टम से लिंक किया जाना चाहिए जो कॉन्टेंट के मालिक से जुड़ा हो और onBehalfOfContentOwner पैरामीटर के बारे में बताता हो. आखिर में, onBehalfOfContentOwnerChannel पैरामीटर की वैल्यू के बारे में बताने वाला चैनल, उस कॉन्टेंट के मालिक से जुड़ा होना चाहिए जिसका onBehalfOfContentOwner पैरामीटर तय करता है.

यह पैरामीटर उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है. इसकी मदद से कॉन्टेंट के मालिक एक बार में पुष्टि कर सकते हैं. साथ ही, पैरामीटर की वैल्यू में बताए गए चैनल की तरफ़ से कार्रवाई कर सकते हैं. इसके लिए, हर अलग चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती.

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

अनुरोध के मुख्य हिस्से में लाइव स्ट्रीम संसाधन उपलब्ध कराएं. उस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए एक मान तय करना होगा:

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • आपके पास इन प्रॉपर्टी के लिए वैल्यू सेट करने का विकल्प है:

    • snippet.title
    • snippet.description

    अगर अपडेट करने का अनुरोध सबमिट किया जा रहा है और आपके अनुरोध में किसी ऐसी प्रॉपर्टी के लिए वैल्यू मौजूद नहीं है जिसकी वैल्यू पहले से मौजूद है, तो प्रॉपर्टी की मौजूदा वैल्यू मिटा दी जाएगी.

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) liveStreamModificationNotAllowed तय की गई लाइव स्ट्रीम में बदलाव नहीं किया जा सकता. ज़्यादा जानकारी के लिए, ब्रॉडकास्ट की लाइफ़ देखें.
forbidden (403) liveStreamModificationNotAllowed एपीआई आपको स्ट्रीम बनाने के बाद cdn.format, cdn.frameRate, cdn.ingestionType या cdn.resolution फ़ील्ड की वैल्यू बदलने की अनुमति नहीं देता.
forbidden (403) liveStreamModificationNotAllowed एपीआई आपको फिर से इस्तेमाल होने वाली स्ट्रीम को फिर से इस्तेमाल करने या इसके उलट करने की सुविधा नहीं देता. ज़्यादा जानकारी के लिए, ब्रॉडकास्ट और स्ट्रीम को समझना देखें.
insufficientPermissions insufficientLivePermissions अनुरोध के पास, बताई गई लाइव स्ट्रीम को अपडेट करने की अनुमति नहीं है. ज़्यादा जानकारी के लिए, OAuth2 पुष्टि को लागू करना देखें.
insufficientPermissions liveStreamingNotEnabled जिस उपयोगकर्ता ने अनुरोध की अनुमति दी है वह YouTube पर लाइव वीडियो स्ट्रीम नहीं कर सकता. उपयोगकर्ता https://www.youtube.com/features पर ज़्यादा जानकारी पा सकते हैं.
invalidValue (400) invalidDescription लाइव स्ट्रीम संसाधन में, snippet.description प्रॉपर्टी की वैल्यू में ज़्यादा से ज़्यादा 10,000 वर्ण हो सकते हैं.
invalidValue (400) invalidTitle लाइव स्ट्रीम संसाधन में, snippet.title प्रॉपर्टी की वैल्यू 1 से 128 वर्णों के बीच होनी चाहिए.
notFound (404) liveStreamNotFound बताया गया लाइव स्ट्रीम मौजूद नहीं है.
required (400) idRequired लाइव स्ट्रीम रिसॉर्स को id प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.
required (400) ingestionTypeRequired लाइव स्ट्रीम रिसॉर्स को cdn.ingestionType प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.
required (400) titleRequired लाइव स्ट्रीम रिसॉर्स को snippet.title प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.

इसे आज़माएं!

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