LiveStreams: update

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

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

अनुरोध

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

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

अनुमति देना

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

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

गड़बड़ियां

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

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

इसे आज़माएं!

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