API অনুরোধের মানদণ্ডের সাথে মেলে এমন channelSection
সংস্থানগুলির একটি তালিকা প্রদান করে৷
কোটা প্রভাব: এই পদ্ধতিতে একটি কলের জন্য 1 ইউনিটের কোটা খরচ হয়।
সাধারণ ব্যবহারের ক্ষেত্রে
অনুরোধ
HTTP অনুরোধ
GET https://www.googleapis.com/youtube/v3/channelSections
পরামিতি
নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।
পরামিতি | ||
---|---|---|
প্রয়োজনীয় পরামিতি | ||
part | string part প্যারামিটারটি এক বা একাধিক channelSection রিসোর্স বৈশিষ্ট্যের একটি কমা-বিভক্ত তালিকা নির্দি��্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে।যদি প্যারামিটারটি এমন একটি সম্পত্তি চিহ্��ি�� কর��� যাত�� ��িশু বৈশিষ্ট্য রয়েছে, তবে শিশু বৈশিষ্ট্যগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে। উদাহরণ স্বরূপ, channelSection রিসোর্সে, snippet প্রপার্টিতে অন্যান্য প্রপার্টি থাকে, যেমন সেকশনের ডিসপ্লে টাইটেল। আপনি যদি part=snippet সেট করেন, তাহলে API প্রতিক্রিয়াতে নেস্ট করা সমস্ত বৈশিষ্ট্যও থাকবে।নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
| |
ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন) | ||
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 অনুরোধ এবং প্রতিক্রিয়া দেখুন।