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 पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने वाली कार्रवाई सेट की जाएगी. साथ ही, उन प्रॉपर्टी की भी पहचान होती है जिन्हें एपीआई के रिस्पॉन्स में शामिल किया जाएगा.

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

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

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

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

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

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

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

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

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

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

    • snippet.title
    • snippet.description

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

जवाब

अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में liveStream रिसॉर्स दिखता है.

गड़बड़ियां

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

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