Captions: list

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

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।

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

অনুরোধ

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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।