একটি ক্যাপশন ট্র্যাক ডাউনলোড করে৷ ক্যাপশন ট্র্যাকটি তার আসল বিন্যাসে ফেরত দেওয়া হয় যদি না অনুরোধটি 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 প্যারামিটারটি নির্দিষ্ট করে যে ক্যাপশন ট্র্যাকটি একটি নির্দিষ্ট বিন্যাসে ফেরত দেওয়া উচিত। যদি প্যারামিটারটি অনুরোধে অন্তর্ভুক্ত না হয়, ট্র্যাকটি তার আসল বিন্যাসে ফেরত দেওয়া হয়।সমর্থিত মান হল:
| |
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 অনুরোধ এবং প্রতিক্রিয়া দেখুন।