Playlists: list

API অনুরোধের পরামিতিগুলির সাথে মেলে এমন প্লেলিস্টের একটি সংগ্রহ দেখায়। উদাহরণস্বরূপ, আপনি প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন সমস্ত প্লেলিস্ট পুনরুদ্ধার করতে পারেন, অথবা আপনি তাদের অনন্য আইডি দ্বারা এক বা একাধিক প্লেলিস্ট পুনরুদ্ধার করতে পারেন৷

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

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

অনুরোধ

HTTP অনুরোধ

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

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটারটি এক বা একাধিক playlist সম্পদ বৈশিষ্ট্যের একটি কমা-বিচ্ছিন্ন তালিকা নির্দিষ্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে।

যদি প্যারামিটারটি এমন একটি সম্পত্তি চিহ্নিত করে যাতে শিশু বৈশিষ্ট্য রয়েছে, তবে শিশু বৈশিষ্ট্যগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে। উদাহরণস্বরূপ, একটি playlist রিসোর্সে, snippet প্রপার্টিতে author , title , description এবং timeCreated এর মত বৈশিষ্ট্য থাকে। যেমন, আপনি part=snippet সেট করলে, API প্রতিক্রিয়াতে সেই সমস্ত বৈশিষ্ট্য থাকবে।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন)
channelId string
এই মানটি নির্দেশ করে যে API শুধুমাত্র নির্দিষ্ট চ্যানেলের প্লেলিস্টগুলি ফিরিয়ে দেবে৷
id string
id প্যারামিটারটি পুনরুদ্ধার করা সংস্থানগুলির জন্য YouTube প্লেলিস্ট আইডি(গুলি) এর একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে৷ একটি playlist রিসোর্সে, id প্রপার্টি প্লেলিস্টের YouTube প্লেলিস্ট আইডি নির্দিষ্ট করে।
mine boolean
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এপিআইকে শুধুমাত্র প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন প্লেলিস্ট ফেরত দিতে নির্দেশ দিতে এই প্যারামিটারের মান true সেট করুন।
ঐচ্ছিক পরামিতি
hl string
hl প্যারামিটার API-কে একটি নির্দিষ্ট অ্যাপ্লিকেশন ভাষার জন্য স্থানীয় রিসোর্স মেটাডেটা পুনরুদ্ধার করার নির্দেশ দেয় যা YouTube ওয়েবসাইট সমর্থন করে । প্যারামিটার মানটি অবশ্যই i18nLanguages.list পদ্ধতি দ্বারা প্রত্যাবর্তিত তালিকায় অন্তর্ভুক্ত একটি ভাষা কোড হতে হবে।

যদি সেই ভাষায় স্থানীয়কৃত সম্পদের বিবরণ পাওয়া যায়, তাহলে সম্পদের snippet.localized অবজেক্টে স্থানীয় মান থাকবে। যাইহোক, যদি স্থানীয়কৃত বিশদ উপলব্ধ না হয়, snippet.localized অবজেক্টে সংস্থানের ডিফল্ট ভাষায় সম্পদের বিবরণ থাকবে।
maxResults unsigned integer
maxResults প্যারামিটারটি ফলাফল সেটে সর্বাধিক কতগুলি আইটেম ফেরত দিতে হবে তা নির্দিষ্ট করে। গ্রহণযোগ্য মান হল 0 থেকে 50 , সমেত। ডিফল্ট মান হল 5 ।
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

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

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

এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।
pageToken string
pageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken এবং prevPageToken বৈশিষ্ট্যগুলি অন্যান্য পৃষ্ঠাগুলি সনাক্ত করে যা পুনরুদ্ধার করা যেতে পারে।

শরীরের অনুরোধ

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

প্রতিক্রিয়া

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

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

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

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

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) channelClosed channelId প্যারামিটারে উল্লেখিত চ্যানেলটি বন্ধ করা হয়েছে।
forbidden (403) channelSuspended channelId প্যারামিটারে উল্লেখিত চ্যানেলটি স্থগিত করা হয়েছে।
forbidden (403) playlistForbidden অনুরোধের id প্যারামিটারের সাথে চিহ্নিত প্লেলিস্ট অনুরোধটিকে সমর্থন করে না বা অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
notFound (404) channelNotFound channelId প্যারামিটারে নির্দিষ্ট করা চ্যানেল খুঁজে পাওয়া যাবে না।
notFound (404) playlistNotFound অনুরোধের id প্যারামিটারের সাথে চিহ্নিত প্লেলিস্ট পাওয়া যাবে না।
invalidValue (400) playlistOperationUnsupported API নির্দিষ্ট প্লেলিস্ট তালিকাভুক্ত করার ক্ষমতা সমর্থন করে না। উদাহরণস্বরূপ, আপনি আপনার পরে দেখার প্লেলিস্ট তালিকাভুক্ত করতে পারবেন না।

এটা চেষ্টা করুন!

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