Captions: list

নির্দিষ্ট ভিডিওর সাথে যুক্ত ক্যাপশন ট্র্যাকের তালিকা দেখায়। মনে রাখবেন যে API রেসপন্সে আসল ক্যাপশন থাকে না এবং captions.download পদ্ধতি ক্যাপশন ট্র্যাক ফিরিয়ে আনার সুবিধা প্রদান করে।

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

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

অনুরোধ করুন

HTTP অনুরোধ

GET https://www.googleapis.com/youtube/v3/captions

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন (যাচাইকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন)।

সুযোগ
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

প্যারামিটারগুলি

এই কোয়েরি যেসব প্যারামিটার ব্যবহার করতে পারে, তা নিম্নলিখিত সারণীতে উল্লেখ করা হয়েছে। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part string
part প্যারামিটার caption রিসোর্স পার্ট নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে।

নিচের তালিকায় part নাম আছে যা আপনি প্যারামিটার ভ্যালুতে অন্তর্ভুক্ত করতে পারবেন:
  • id
  • snippet
videoId string
videoId প্যারামিটারটি সেই ভিডিওর YouTube ভিডিও আইডি নির্দিষ্ট করে যার জন্য API-কে ক্যাপশন ট্র্যাক রিটার্ন করতে হবে।
ঐচ্ছিক প্যারামিটার
id string
id প্যারামিটার কমা দিয়ে আলাদা করা আইডির তালিকা নির্দিষ্ট করে যা caption রিসোর্স শনাক্ত করে, যা ফিরিয়ে আনা উচিত। প্রতিটি আইডিকে অবশ্যই নির্দিষ্ট ভিডিওর সাথে যুক্ত ক্যাপশন ট্র্যাক শনাক্ত করতে হবে।
onBehalfOfContentOwner string
এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে।

onBehalfOfContentOwner প্যারামিটারটি ইঙ্গিত করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একটি YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাই করিয়ে নিয়ে তাদের সব ভিডিও ও চ্যানেল ডেটা অ্যাক্সেস করতে দেয়। এর জন্য প্রতিটি আলাদা আলাদা চ্যানেলের জন্য যাচাইকরণের ক্রেডেনশিয়াল দিতে হয় না। ব্যবহারকারী যে আসল CMS অ্যাকাউন্ট দিয়ে যাচাই করেন সেটি নির্দিষ্ট YouTube কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।

অনুরোধের বডি

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

রেসপন্স

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত স্ট্রাকচার সহ একটি রেসপন্স বডি প্রদান করে:

{
  "kind": "youtube#captionListResponse",
  "etag": etag,
  "items": [
    caption Resource
  ]
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind string
API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#captionListResponse হবে।
etag etag
এই রিসোর্সের Etag.
items[] list
অনুরোধের মাপকাঠির সাথে মেলে এমন ক্যাপশনের তালিকা।

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
forbidden (403) forbidden এক বা একাধিক ক্যাপশন ট্র্যাক পাওয়া যায়নি কারণ অনুরোধের সাথে যুক্ত অনুমতি, অনুরোধ করা রিসোর্স পাওয়ার জন্য যথেষ্ট নয়। অনুরোধটি সঠিকভাবে অনুমোদিত নাও হতে পারে।
notFound (404) captionNotFound নির্দিষ্ট করা এক বা একাধিক ক্যাপশন ট্র্যাক খুঁজে পাওয়া যায়নি। videoId প্যারামিটার কোনও আসল ভিডিও শনাক্ত করলে, কিন্তু id প্যারামিটার এমন ক্যাপশন ট্র্যাক আইডি শনাক্ত করলে যা নেই অথবা এমন ট্র্যাক আইডি শনাক্ত করলে যা অন্য ভিডিওর সাথে যুক্ত, তাহলে এই সমস্যাটি হয়। অনুরোধের id এবং videoId প্যারামিটারের ভ্যালু সঠিক আছে কিনা তা নিশ্চিত করুন।
notFound (404) videoNotFound videoId প্যারামিটার দ্বারা শনাক্ত করা ভিডিওটি খুঁজে পাওয়া যায়নি।

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

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