Captions: insert

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

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

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

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

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

अनुरोध

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

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

अनुमति देना

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

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

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

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

अनुरोध के मुख्य हिस्से में caption संसाधन दें. उस संसाधन के लिए:

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

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

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

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

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
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 का इस्तेमाल करें.