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 का इस्तेमाल करें.