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 पैरामीटर को true पर सेट करना चाहिए.

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

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

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

    • 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 पैरामीटर से पहचाना गया वीडियो नहीं मिला.
invalidValue (400) nameTooLong अनुरोध में दर्ज snippet.name बहुत लंबा है. ज़्यादा से ज़्यादा 150 वर्ण इस्तेमाल किए जा सकते हैं.

इसे आज़माएं!

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