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 – सिनेरिस्ट क्लोज़्ड कैप्शन फ़ॉर्मैट
  • 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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.