Captions: download

कैप्शन ट्रैक डाउनलोड करता है. कैप्शन ट्रैक को उसके मूल फ़ॉर्मैट में तब तक दिखाया जाता है, जब तक अनुरोध में tfmt पैरामीटर के लिए कोई वैल्यू नहीं दी जाती. साथ ही, उसे उसकी मूल भाषा में तब तक दिखाया जाता है, जब तक अनुरोध में tlang पैरामीटर के लिए कोई वैल्यू नहीं दी जाती.

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

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

अनुरोध

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

GET https://www.googleapis.com/youtube/v3/captions/id

अनुमति देना

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

दायरा
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

पैरामीटर

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

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

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

इस्तेमाल की जा सकने वाली वैल्यू:
  • sbv – SubViewer सबटाइटल
  • scc – Scenarist सबटाइटल फ़ॉर्मैट
  • srt – SubRip सबटाइटल
  • ttml – टाइमड टेक्स्ट मार्कअप लैंग्वेज कैप्शन
  • vtt – वेब वीडियो के टेक्स्ट ट्रैक का कैप्शन
tlang string
tlang पैरामीटर से पता चलता है कि एपीआई रिस्पॉन्स में, बताए गए कैप्शन ट्रैक का अनुवाद होना चाहिए. पैरामीटर की वैल्यू, ISO 639-1 के मुताबिक दो अक्षरों वाला भाषा कोड होती है. इससे कैप्शन की भाषा के बारे में पता चलता है. अनुवाद, Google Translate जैसी मशीन से अनुवाद करने की सुविधा का इस्तेमाल करके जनरेट किया जाता है.

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

इस तरीके को कॉल करते समय, अनुरोध बॉडी न दें.

जवाब

अगर यह तरीका काम करता है, तो यह एक बाइनरी फ़ाइल दिखाता है. रिस्पॉन्स के लिए Content-Type हेडर application/octet-stream है.

गड़बड़ियां

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

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) forbidden कैप्शन ट्रैक डाउनलोड करने के लिए, अनुरोध से जुड़ी अनुमतियां काफ़ी नहीं हैं. ऐसा हो सकता है कि अनुरोध को सही तरीके से अनुमति न मिली हो.
invalidValue (400) couldNotConvert कैप्शन ट्रैक के डेटा को मांगी गई भाषा और/या फ़ॉर्मैट में बदला नहीं जा सका. पक्का करें कि अनुरोध किए गए tfmt और tlang की वैल्यू मान्य हों. साथ ही, अनुरोध किए गए कैप्शन ट्रैक का snippet.status, failed न हो.
notFound (404) captionNotFound कैप्शन ट्रैक नहीं मिला. अनुरोध के id पैरामीटर की वैल्यू की जांच करके, पक्का करें कि वह सही है.

इसे आज़माएं!

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