Videos: list

API অনুরোধের প্যারামিটারের সাথে মেলে এমন ভিডিওর তালিকা দেখায়।

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

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

অনুরোধ করুন

HTTP অনুরোধ

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

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটার এক বা একাধিক video রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত করা হবে। প্যারামিটারটি যদি এমন কোনও প্রপার্টি শনাক্ত করে যাতে চাইল্ড প্রপার্টি আছে, তাহলে চাইল্ড প্রপার্টিগুলি রেসপন্সে অন্তর্ভুক্ত করা হবে। যেমন, video রিসোর্সে, snippet প্রপার্টিতে channelId, title, description, tags ও categoryId প্রপার্টি থাকে। যেমন, আপনি part=snippet সেট করলে, API রেসপন্সে এইসব প্রপার্টি থাকবে। প্যারামিটারের মানে আপনি অন্তর্ভুক্ত করতে পারবেন এমন part নাম নিম্নলিখিত তালিকায় রয়েছে: brandPartner contentDetails fileDetails id liveStreamingDetails localizations paidProductPlacementDetails player processingDetails recordingDetails snippet statistics status suggestions topicDetails
ফিল্টার (নিম্নলিখিত প্যারামিটারের মধ্যে ঠিক একটি উল্লেখ করুন)
chart	string আপনি যে চার্টটি পেতে চান, chart প্যারামিটার সেটি শনাক্ত করে। গ্রহণযোগ্য মান হল: mostPopular – নির্দিষ্ট কন্টেন্ট অঞ্চল এবং ভিডিও বিভাগের জন্য সবচেয়ে জনপ্রিয় ভিডিওগুলি দেখায়।
id	string id প্যারামিটারটি রিসোর্সের জন্য YouTube ভিডিও আইডির কমা-দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা ফিরিয়ে আনা হচ্ছে। video রিসোর্সে, id প্রপার্টি ভিডিওর আইডি নির্দিষ্ট করে।
myRating	string এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এই প্যারামিটারের ভ্যালু like বা dislike হিসেবে সেট করুন যাতে API-কে নির্দেশ দেওয়া যায় যে যাচাই করা ব্যবহারকারীর লাইক বা ডিসলাইক করা ভিডিওই শুধু দেখাতে হবে। API, রিটার্ন করা ফলাফল সেটকে সর্বাধিক ১০০০টি ভিডিওতে সীমাবদ্ধ করে। উত্তরের pageInfo.totalResults প্রপার্টি আরও বেশি মোট সংখ্যা দেখালেও, pageToken প্যারামিটার ব্যবহার করে পেজিনেশন শুধুমাত্র সবচেয়ে সাম্প্রতিক ১০০০টি আইটেম ফিরিয়ে আনার অনুমতি দেয়। প্যারামিটারে নিম্নলিখিত ভ্যালু গ্রহণ করা হয়: dislike – শুধুমাত্র যাচাই করা ব্যবহারকারীর অপছন্দ করা ভিডিও দেখায়। like – শুধুমাত্র যাচাই করা ব্যবহারকারীর লাইক করা ভিডিও দেখায়।
ঐচ্ছিক প্যারামিটার
hl	string hl প্যারামিটার, API-কে YouTube ওয়েবসাইট কাজ করে এমন নির্দিষ্ট অ্যাপ্লিকেশন ভাষার জন্য লোকালাইজ করা রিসোর্স মেটাডেটা রিট্রিভ করার নির্দেশ দেয়। প্যারামিটার ভ্যালু অবশ্যই i18nLanguages.list মেথড -এর মাধ্যমে রিটার্ন করা তালিকায় অন্তর্ভুক্ত একটি ভাষা কোড হতে হবে। সেই ভাষায় স্থানীয়করণ করা রিসোর্সের বিবরণ উপলভ্য থাকলে, রিসোর্সের snippet.localized অবজেক্টে স্থানীয়করণ করা ভ্যালু থাকবে। তবে, লোকালাইজ করা বিবরণ উপলভ্য না থাকলে, snippet.localized অবজেক্টে রিসোর্সের ডিফল্ট ভাষায় রিসোর্সের বিবরণ থাকবে।
maxHeight	unsigned integer maxHeight প্যারামিটারটি player.embedHtml প্রপার্টিতে দেখানো এম্বেড করা প্লেয়ারের সর্বাধিক উচ্চতা নির্দিষ্ট করে। আপনি এই প্যারামিটার ব্যবহার করে নির্দিষ্ট করতে পারেন যে ডিফল্ট ডাইমেনশনের পরিবর্তে, এম্বেড কোডটি আপনার অ্যাপ্লিকেশন লেআউটের জন্য উপযুক্ত উচ্চতা ব্যবহার করবে। maxWidth প্যারামিটারও দেওয়া থাকলে, সর্বাধিক প্রস্থ লঙ্ঘন না করার জন্য প্লেয়ারটি maxHeight-এর থেকে ছোট হতে পারে। গ্রহণযোগ্য ভ্যালু হল 72 থেকে 8192, অন্তর্ভুক্ত।
maxResults	unsigned integer maxResults প্যারামিটারটি ফলাফল সেটে ফেরত আসা আইটেমের সর্বাধিক সংখ্যা নির্দিষ্ট করে। মনে রাখবেন: এই প্যারামিটারটি myRating প্যারামিটারের সাথে ব্যবহার করার জন্য কাজ করে, তবে এটি id প্যারামিটারের সাথে ব্যবহার করার জন্য কাজ করে না। গ্রহণযোগ্য ভ্যালু হল 1 থেকে 50, অন্তর্ভুক্ত। ডিফল্ট মান হল 5।
maxWidth	unsigned integer maxWidth প্যারামিটারটি player.embedHtml প্রপার্টিতে দেখানো এম্বেড করা প্লেয়ারের সর্বাধিক প্রস্থ নির্দিষ্ট করে। ডিফল্ট ডাইমেনশনের পরিবর্তে, আপনার অ্যাপ্লিকেশন লেআউটের জন্য উপযুক্ত প্রস্থ এম্বেড কোডের ব্যবহার করা উচিত, তা নির্দিষ্ট করতে আপনি এই প্যারামিটার ব্যবহার করতে পারেন। যদি maxHeight প্যারামিটারও প্রদান করা হয়, তাহলে সর্বোচ্চ উচ্চতা লঙ্ঘন না করার জন্য প্লেয়ারটি maxWidth-এর চেয়ে সংকীর্ণ হতে পারে। 72 থেকে 8192 পর্যন্ত ভ্যালু ব্যবহার করা যাবে।
onBehalfOfContentOwner	string এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।
pageToken	string pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API রেসপন্সে, nextPageToken এবং prevPageToken প্রপার্টি অন্যান্য পৃষ্ঠা শনাক্ত করে যেগুলি ফিরিয়ে আনা যেতে পারে। মনে রাখবেন: এই প্যারামিটার myRating প্যারামিটারের সাথে ব্যবহার করা যায়, তবে id প্যারামিটারের সাথে ব্যবহার করা যায় না।
regionCode	string regionCode প্যারামিটার API-কে নির্দিষ্ট অঞ্চলে উপলভ্য ভিডিও চার্ট বেছে নেওয়ার নির্দেশ দেয়। এই প্যারামিটার শুধুমাত্র chart প্যারামিটারের সাথে ব্যবহার করা যাবে। প্যারামিটারের মান হল ISO 3166-1 alpha-2 দেশের কোড।
videoCategoryId	string videoCategoryId প্যারামিটারটি সেই ভিডিও বিভাগ শনাক্ত করে যার জন্য চার্টটি পুনরুদ্ধার করা উচিত। এই প্যারামিটার শুধুমাত্র chart প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। ডিফল্ট হিসেবে, চার্ট কোনও নির্দিষ্ট বিভাগের মধ্যে সীমাবদ্ধ থাকে না। ডিফল্ট ভ্যালু হল 0।

অনুরোধের বডি

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

রেসপন্স

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

{
  "kind": "youtube#videoListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    video Resource
  ]
}

প্রপার্টি

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

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#videoListResponse হবে।
etag	etag এই রিসোর্সের Etag.
nextPageToken	string ফলাফল সেটের পরবর্তী পৃষ্ঠা ফিরিয়ে আনতে pageToken প্যারামিটারের ভ্যালু হিসেবে যে টোকেন ব্যবহার করা যেতে পারে।
prevPageToken	string ফলাফলের সেটে আগের পৃষ্ঠা ফিরিয়ে আনতে pageToken প্যারামিটারের ভ্যালু হিসেবে যে টোকেন ব্যবহার করা যেতে পারে।
pageInfo	object pageInfo অবজেক্টে ফলাফল সেটের জন্য পেজিং সংক্রান্ত তথ্য থাকে।
pageInfo.totalResults	integer ফলাফলের সেটে মোট ফলাফলের সংখ্যা।
pageInfo.resultsPerPage	integer API রেসপন্সে অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[]	list অনুরোধের মাপকাঠির সাথে ম্যাচ করে এমন ভিডিওর তালিকা।

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
badRequest (400)	videoChartNotFound	অনুরোধ করা ভিডিও চার্ট কাজ করে না বা উপলভ্য নেই।
forbidden (403)	forbidden	ভিডিও ফাইল বা প্রসেসিং সংক্রান্ত তথ্য অ্যাক্সেস করার জন্য অনুরোধটি সঠিকভাবে অনুমোদিত নয়। মনে রাখবেন, fileDetails, processingDetails ও suggestions অংশগুলি শুধুমাত্র সেই ভিডিওর মালিকের জন্য উপলভ্য।
forbidden (403)	forbidden	অনুরোধটি ব্যবহারকারীর রেটিং সংক্রান্ত তথ্য অ্যাক্সেস করতে পারবে না। এই সমস্যাটি হতে পারে কারণ myRating প্যারামিটার ব্যবহার করার জন্য অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
notFound (404)	videoNotFound	যে ভিডিওটি ফিরিয়ে আনার চেষ্টা করছেন সেটি খুঁজে পাওয়া যায়নি। অনুরোধের id প্যারামিটারের ভ্যালু সঠিক কিনা তা নিশ্চিত করুন।

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

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