Captions: download

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

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

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

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 - সাবভিউয়ার সাবটাইটেল
  • scc - দৃশ্যকল্পের ক্লোজড ক্যাপশন বিন্যাস
  • srt – SubRip সাবটাইটেল
  • ttml - টাইমড টেক্সট মার্কআপ ল্যাঙ্গুয়েজ ক্যাপশন
  • vtt – ওয়েব ভিডিও টেক্সট ট্র্যাক ক্যাপশন
tlang string
tlang প্যারামিটার নির্দিষ্ট করে যে API প্রতিক্রিয়া নির্দিষ্ট ক্যাপশন ট্র্যাকের একটি অনুবাদ ফেরত দেবে। প্যারামিটার মান হল একটি ISO 639-1 দুই-অক্ষরের ভাষা কোড যা পছন্দসই ক্যাপশন ভাষা সনাক্ত করে। অনুবাদটি মেশিন অনুবাদ ব্যবহার করে তৈরি করা হয়, যেমন Google অনুবাদ।

শরীরের অনুরোধ

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

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি একটি বাইনারি ফাইল ফেরত দেয়। প্রতিক্রিয়ার জন্য Content-Type শিরোনাম হল application/octet-stream ।

ত্রুটি

নীচের সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যেগুলি API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

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

এটা চেষ্টা করুন!

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