Videos: list

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

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

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

অনুরোধ

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 নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন)
chart string
chart প্যারামিটারটি আপনি যে চার্টটি পুনরুদ্ধার করতে চান তা চিহ্নিত করে।

গ্রহণযোগ্য মান হল:
id string
id প্যারামিটারটি পুনরুদ্ধার করা সংস্থানগুলির জন্য YouTube ভিডিও আইডি(গুলি) এর একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে৷ একটি video রিসোর্সে, id প্রপার্টি ভিডিওর আইডি নির্দিষ্ট করে।
myRating string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এই প্যারামিটারের মানটি like বা dislike হিসাবে সেট করুন যাতে API-কে শুধুমাত্র প্রমাণীকৃত ব্যবহারকারীর পছন্দ বা অপছন্দ করা ভিডিওগুলি ফেরত দিতে নির্দেশ দেয়৷

গ্রহণযোগ্য মান হল:
  • 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 প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken এবং prevPageToken বৈশিষ্ট্যগুলি অন্যান্য পৃষ্ঠাগুলি সনাক্ত করে যা পুনরুদ্ধার করা যেতে পারে।

দ্রষ্টব্য: এই প্যারামিটারটি myRating প্যারামিটারের সাথে ব্যবহারের জন্য সমর্থিত, কিন্তু এটি id প্যারামিটারের সাথে ব্যবহারের জন্য সমর্থিত নয়।
regionCode string
regionCode প্যারামিটার API-কে নির্দিষ্ট অঞ্চলে উপলব্ধ একটি ভিডিও চার্ট নির্বাচন করার নির্দেশ দেয়। এই প্যারামিটারটি শুধুমাত্র chart প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। প্যারামিটার মান হল একটি ISO 3166-1 আলফা-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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।