ChannelSections: list

API অনুরোধের মাপকাঠির সাথে মেলে এমন channelSection রিসোর্সের তালিকা রিটার্ন করে।

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

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

অনুরোধ করুন

HTTP অনুরোধ

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

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটার এক বা একাধিক channelSection রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত করা হবে। প্যারামিটারটি যদি এমন কোনও প্রপার্টি শনাক্ত করে যাতে চাইল্ড প্রপার্টি আছে, তাহলে চাইল্ড প্রপার্টিগুলি রেসপন্সে অন্তর্ভুক্ত করা হবে। যেমন, channelSection রিসোর্সে, snippet প্রপার্টিতে অন্যান্য প্রপার্টি থাকে, যেমন বিভাগের ডিসপ্লে শীর্ষক। আপনি part=snippet সেট করলে, API-এর উত্তরে সেইসব নেস্টেড প্রপার্টিও থাকবে। নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার ভ্যালুতে যোগ করতে পারবেন: contentDetails id snippet
ফিল্টার (নিম্নলিখিত প্যারামিটারগুলির মধ্যে ঠিক একটি নির্দিষ্ট করুন)
channelId	string channelId প্যারামিটার একটি YouTube চ্যানেল আইডি নির্দিষ্ট করে। কোনও অনুরোধে এই প্যারামিটারের জন্য কোনও ভ্যালু উল্লেখ করা হলে, API শুধুমাত্র নির্দিষ্ট চ্যানেলের বিভাগগুলি দেখাবে।
id	string id প্যারামিটার, কমা দিয়ে আলাদা করা আইডির তালিকা উল্লেখ করে যা অনন্যভাবে শনাক্ত করে যে channelSection রিসোর্স ফিরিয়ে আনা হচ্ছে। channelSection রিসোর্সে, id প্রপার্টি বিভাগের আইডি নির্দিষ্ট করে।
mine	boolean এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। যাচাইকৃত ব্যবহারকারীর YouTube চ্যানেলের সাথে যুক্ত চ্যানেল বিভাগের ফিড পেতে, এই প্যারামিটারের ভ্যালু true হিসেবে সেট করুন।
ঐচ্ছিক প্যারামিটার
hl	string এই প্যারামিটার বন্ধ করে দেওয়া হয়েছে। hl প্যারামিটারটি চ্যানেল বিভাগের জন্য লোকালাইজ করা মেটাডেটা পুনরুদ্ধার করার জন্য সহায়তা প্রদান করে। তবে, YouTube Studio এবং YouTube অ্যাপে এই কার্যকারিতা বন্ধ করে দেওয়া হয়েছে।
onBehalfOfContentOwner	string এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেল ম্যানেজ করেন। এটি কন্টেন্টের মালিকদের একবার যাচাই করিয়ে নিয়ে তাদের সব ভিডিও ও চ্যানেল ডেটা অ্যাক্সেস করতে দেয়। এর জন্য প্রতিটি আলাদা আলাদা চ্যানেলের জন্য যাচাইকরণের ক্রেডেনশিয়াল দিতে হয় না। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাই করেন সেটি নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।

অনুরোধের বডি

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

রেসপন্স

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

{
  "kind": "youtube#channelSectionListResponse",
  "etag": etag,
  "items": [
    channelSection Resource
  ]
}

প্রপার্টি

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

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#channelSectionListResponse।
etag	etag এই রিসোর্সের Etag.
items[]	list ChannelSections-এর তালিকা যা অনুরোধের মাপকাঠির সাথে মেলে।

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
forbidden (403)	channelSectionForbidden	অনুরোধকারীকে অনুরোধ করা চ্যানেল বিভাগ অ্যাক্সেস করার অনুমতি দেওয়া হয় না।
invalidValue (400)	idInvalid	অনুরোধে ভুল চ্যানেল বিভাগ আইডি উল্লেখ করা হয়েছে।
invalidValue (400)	invalidCriteria	অনুরোধটি সম্পূর্ণ করা যায়নি কারণ ফিল্টার সংক্রান্ত শর্তাবলী সঠিক নয়।
notFound (404)	channelNotFound	অনুরোধের সাথে যুক্ত চ্যানেল খুঁজে পাওয়া যায়নি।
notFound (404)	channelSectionNotFound	অনুরোধের সাথে যুক্ত চ্যানেল বিভাগ খুঁজে পাওয়া যাচ্ছে না।

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

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