PlaylistImages: list

API অনুরোধের প্যারামিটারের সাথে মেলে এমন প্লেলিস্টের ছবির সংগ্রহ দেখায়। আপনি নির্দিষ্ট কোনও প্লেলিস্টের ছবি বা অনন্য আইডি ব্যবহার করে এক বা একাধিক প্লেলিস্টের ছবি ফিরিয়ে আনতে পারবেন।

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন (অনুমোদন ও যাচাইকরণ সম্পর্কে আরও জানুন)।

সুযোগ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটারটি এক বা একাধিক playlistImage রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। যদি প্যারামিটারটি এমন একটি প্রপার্টি শনাক্ত করে যাতে চাইল্ড প্রপার্টি রয়েছে, তাহলে চাইল্ড প্রপার্টিগুলি রেসপন্সে অন্তর্ভুক্ত করা হবে।
ফিল্টার (নিম্নলিখিত প্যারামিটারের মধ্যে ঠিক একটি উল্লেখ করুন)
id	string id প্যারামিটার এক বা একাধিক অনন্য প্লেলিস্ট ইমেজ আইডির কমা দিয়ে আলাদা করা তালিকা নির্দিষ্ট করে।
playlistId	string playlistId প্যারামিটারটি সেই প্লেলিস্টের অনন্য আইডি নির্দিষ্ট করে যার জন্য আপনি প্লেলিস্টের ছবিগুলি পুনরুদ্ধার করতে চান। মনে রাখবেন, এটি একটি ঐচ্ছিক প্যারামিটার হলেও, প্লেলিস্টের ছবি রিট্রিভ করার প্রতিটি অনুরোধে id প্যারামিটার বা playlistId প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
ঐচ্ছিক প্যারামিটার
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 প্যারামিটার ফলাফল সেটের মধ্যে একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত পাঠানো উচিত। API উত্তরের মধ্যে, nextPageToken এবং prevPageToken প্রপার্টি, অন্যান্য যেসব পৃষ্ঠা রিট্রিভ করা যেতে পারে সেগুলিকে শনাক্ত করে।

অনুরোধের বডি

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

রেসপন্স

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

{
          "kind": "youtube#playlistImageListResponse",
          "nextPageToken": string,
          "prevPageToken": string,
          "pageInfo": {
            "totalResults": integer,
            "resultsPerPage": integer
          },
          "items": [
            playlistImages Resource
          ]
        }

প্রপার্টি

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

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