Captions: download

ক্যাপশন ট্র্যাক ডাউনলোড করে। অনুরোধে tfmt প্যারামিটারের জন্য কোনও ভ্যালু উল্লেখ না করা থাকলে ক্যাপশন ট্র্যাকটি তার আসল ফর্ম্যাটে এবং অনুরোধে tlang প্যারামিটারের জন্য কোনও ভ্যালু উল্লেখ না করা থাকলে তার আসল ভাষায় ফেরত দেওয়া হয়।

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করলে কোটা খরচ হিসেবে ২০০ ইউনিট খরচ হয়।

এই পদ্ধতির জন্য ব্যবহারকারীর ভিডিও এডিট করার অনুমতি থাকতে হবে।

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

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 CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাই করিয়ে নিয়ে তাদের সব ভিডিও ও চ্যানেল ডেটা অ্যাক্সেস করতে দেয়। এর জন্য প্রতিটি আলাদা আলাদা চ্যানেলের জন্য যাচাইকরণের ক্রেডেনশিয়াল দিতে হয় না। ব্যবহারকারী যে আসল CMS অ্যাকাউন্ট দিয়ে যাচাই করেন সেটি নির্দিষ্ট YouTube কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।
tfmt string
tfmt প্যারামিটার নির্দিষ্ট করে যে ক্যাপশন ট্র্যাক একটি নির্দিষ্ট ফর্ম্যাটে ফেরত দিতে হবে। অনুরোধে প্যারামিটার অন্তর্ভুক্ত না থাকলে, ট্র্যাকটি তার আসল ফর্ম্যাটে ফেরত পাঠানো হয়।

সাপোর্ট করা ভ্যালুগুলি হল:
  • sbv – SubViewer সাবটাইটেল
  • scc – Scenarist ক্লোজড ক্যাপশন ফর্ম্যাট
  • srt – SubRip সাবটাইটেল
  • ttml – টাইমড টেক্সট মার্কআপ ল্যাঙ্গুয়েজ ক্যাপশন
  • vtt – ওয়েব ভিডিও টেক্সট ট্র্যাক ক্যাপশন
tlang string
tlang প্যারামিটার নির্দিষ্ট করে যে API রেসপন্স নির্দিষ্ট ক্যাপশন ট্র্যাকের অনুবাদ ফেরত দেবে। প্যারামিটারের মান হল একটি ISO 639-1 দুই-অক্ষরের ভাষা কোড যা ক্যাপশনের জন্য কাঙ্ক্ষিত ভাষা শনাক্ত করে। Google Translate-এর মতো মেশিন অনুবাদ ব্যবহার করে অনুবাদ তৈরি করা হয়।

অনুরোধের বডি

এই পদ্ধতি কল করার সময় অনুরোধের বডি প্রদান করবেন না।

রেসপন্স

সফল হলে, এই পদ্ধতি একটি বাইনারি ফাইল রিটার্ন করে। উত্তরটির Content-Type হেডার হল application/octet-stream।

সমস্যা

নিচের সারণীটি সেইসব সমস্যার মেসেজ শনাক্ত করে যা এই পদ্ধতিতে কল করার উত্তরে API রিটার্ন করতে পারে। আরও বিবরণের জন্য সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশন দেখুন।

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
forbidden (403) forbidden ক্যাপশন ট্র্যাক ডাউনলোড করার জন্য অনুরোধের সাথে যুক্ত অনুমতি যথেষ্ট নয়। অনুরোধটি হয়ত সঠিকভাবে অনুমোদিত নয়।
invalidValue (400) couldNotConvert ক্যাপশন ট্র্যাক ডেটা অনুরোধ করা ভাষা এবং/অথবা ফর্ম্যাটে কনভার্ট করা যায়নি। অনুরোধ করা tfmt ও tlang ভ্যালু সঠিক কিনা এবং অনুরোধ করা ক্যাপশন ট্র্যাকের snippet.status যেন failed না হয় তা নিশ্চিত করুন।
notFound (404) captionNotFound ক্যাপশন ট্র্যাক খুঁজে পাওয়া যায়নি। অনুরোধের id প্যারামিটারের ভ্যালু সঠিক কিনা তা নিশ্চিত করুন।

এটি ব্যবহার করে দেখুন!

এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।