Captions: insert

कैप्शन ट्रैक अपलोड करता है.

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

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

कोटा असर: इस तरीके को कॉल करने पर कोटा लागत 400 इकाइयां हो जाती हैं.

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

अनुरोध करें

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

POST 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 पैरामीटर में caption संसाधन वाले उन हिस्सों के बारे में बताया गया है जो एपीआई रिस्पॉन्स में शामिल होंगे. पैरामीटर वैल्यू को snippet पर सेट करें.

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

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

अगर आप कोई ऐसी ट्रांसक्रिप्ट अपलोड कर रहे हैं जिसमें कोई समय कोड नहीं है या अगर आपको लगता है कि आपकी फ़ाइल में समय कोड गलत हैं और आप चाहते हैं कि YouTube उन्हें ठीक करने की कोशिश करे, तो आपको sync पैरामीटर सेट करना चाहिए.

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

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

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

    • snippet.videoId
    • snippet.language
    • snippet.name

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

    • snippet.videoId
    • snippet.language
    • snippet.name
    • snippet.isDraft

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) contentRequired अनुरोध में कैप्शन ट्रैक सामग्री शामिल नहीं है.
conflict (409) captionExists इस वीडियो में पहले से ही snippet.language और snippet.name के साथ एक कैप्शन ट्रैक है. एक वीडियो के लिए एक ही भाषा के कई ट्रैक हो सकते हैं, लेकिन हर ट्रैक का नाम अलग होना चाहिए.

गड़बड़ी को ठीक करने के कई तरीके हैं. सम्मिलित करने से पहले आप मौजूदा ट्रैक को हटा सकते हैं और फिर नया ट्रैक सम्मिलित कर सकते हैं या नए ट्रैक का नाम बदल सकते हैं.
forbidden (403) forbidden अनुरोध से जुड़ी अनुमतियां कैप्शन ट्रैक को अपलोड करने के लिए काफ़ी नहीं हैं. हो सकता है कि अनुरोध को सही तरीके से अनुमति न दी गई हो.
invalidValue (400) invalidMetadata अनुरोध में अमान्य मेटाडेटा मान शामिल हैं, जो ट्रैक को बनने से रोकते हैं. पुष्टि करें कि अनुरोध से snippet.language, snippet.name, और snippet.videoId प्रॉपर्टी के लिए सही वैल्यू का पता चलता है. snippet.isDraft प्रॉपर्टी को भी शामिल किया जा सकता है, लेकिन यह ज़रूरी नहीं है.
notFound (404) videoNotFound videoId पैरामीटर से पहचाना गया वीडियो नहीं मिला.

इसे आज़माएं!

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