Playlists: list

API অনুরোধের প্যারামিটারের সাথে মেলে এমন প্লেলিস্টের একটি সংগ্রহ প্রদান করে। যেমন, আপনি যাচাই করা ব্যবহারকারীর মালিকানাধীন সব প্লেলিস্ট রিট্রিভ করতে পারেন অথবা অনন্য আইডি ব্যবহার করে এক বা একাধিক প্লেলিস্ট রিট্রিভ করতে পারেন।

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

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

অনুরোধ করুন

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 এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। যাচাইকৃত ব্যবহারকারীর মালিকানাধীন প্লেলিস্টই যাতে API ফেরত পাঠায়, সেই নির্দেশ দিতে এই প্যারামিটারের ভ্যালু 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 প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করা থাকলে এই প্যারামিটারটি প্রয়োজন এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার যে কন্টেন্টের মালিককে নির্দিষ্ট করে, তার সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অবশ্যই অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার ভ্যালু যে চ্যানেলকে নির্দিষ্ট করে, সেটি অবশ্যই onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে। এই প্যারামিটারটি সেইসব YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিককে একবার যাচাইকরণ করার এবং প্রতিটি আলাদা চ্যানেলের জন্য যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটারের মানে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন নেওয়ার অনুমতি দেয়।
pageToken	string pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API রেসপন্সে, 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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।