Captions: update

कैप्शन ट्रैक को अपडेट करता है. कैप्शन ट्रैक को अपडेट करते समय, ट्रैक का ड्राफ़्ट का स्टेटस बदला जा सकता है, ट्रैक के लिए नई कैप्शन फ़ाइल अपलोड की जा सकती है या ये दोनों काम किए जा सकते हैं.

इस तरीके से, मीडिया अपलोड किया जा सकता है. अपलोड की गई फ़ाइलें इन सीमाओं के अनुरूप होनी चाहिए:

  • फ़ाइल का ज़्यादा से ज़्यादा साइज़: 100 एमबी
  • स्वीकार किए गए मीडिया के MIME टाइप: text/xml, application/octet-stream, */*

कोटा पर असर: इस तरीके का इस्तेमाल करने पर 450 यूनिट का कोटा शुल्क होगा.

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

अनुरोध

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

PUT https://www.googleapis.com/upload/youtube/v3/captions

अनुमति

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

स्कोप
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
part string
इस कार्रवाई में part पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने के दौरान सेट किया जाएगा. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जो एपीआई के रिस्पॉन्स में शामिल होंगी. अगर ट्रैक का ड्राफ़्ट का स्टेटस अपडेट किया जा रहा है, तो प्रॉपर्टी की वैल्यू को snippet पर सेट करें. अगर ऐसा नहीं है, तो प्रॉपर्टी की वैल्यू को id पर सेट करें.

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

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

sync पैरामीटर से पता चलता है कि YouTube को कैप्शन फ़ाइल को, वीडियो के ऑडियो ट्रैक के साथ अपने-आप सिंक करना चाहिए या नहीं. अगर आपने वैल्यू को true पर सेट किया है, तो YouTube कैप्शन ट्रैक को ऑडियो ट्रैक के साथ अपने-आप सिंक कर देगा.

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

अनुरोध के मुख्य हिस्से में, कैप्शन के संसाधन की जानकारी दें. इस संसाधन के लिए:

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

    • id

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

    • snippet.isDraft

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

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) contentRequired अनुरोध में, अपडेट की गई कैप्शन फ़ाइल अपलोड नहीं की गई थी. अगर sync पैरामीटर को true पर सेट किया गया है, तो ट्रैक का असल कॉन्टेंट डालना ज़रूरी है.
forbidden (403) forbidden कैप्शन ट्रैक को अपडेट करने के लिए, अनुरोध से जुड़ी अनुमतियां काफ़ी नहीं हैं. हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो.
notFound (404) captionNotFound बताया गया कैप्शन ट्रैक नहीं मिला. अनुरोध की id प्रॉपर्टी की वैल्यू की जांच करके पक्का करें कि वह सही है.

इसे आज़माएं!

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