ChannelSections: list

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

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

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

অনুরোধ

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 স্টুডিও এবং 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
চ্যানেল বিভাগগুলির একটি তালিকা যা অনুরোধের মানদণ্ডের সাথে মেলে।

ত্রুটি

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

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

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

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