कैप्शन ट्रैक डाउनलोड किया जाता है. कैप्शन ट्रैक तब तक अपने मूल फ़ॉर्मैट में मिलता है, जब तक कि अनुरोध 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 पैरामीटर से यह तय होता है कि कैप्शन ट्रैक को किसी खास फ़ॉर्मैट में दिखाया जाना चाहिए. अगर अनुरोध में पैरामीटर शामिल नहीं है, तो ट्रैक को उसके मूल फ़ॉर्मैट में वापस कर दिया जाता है.मान्य वैल्यू ये हैं:
|
|
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 का इस्तेमाल करें.