Channels: list

দ্রষ্টব্য: channel রিসোর্সের statistics.subscriberCount প্রপার্টির মান আপডেট করা হয়েছে একটি YouTube নীতি পরিবর্তন প্রতিফলিত করার জন্য যা সাবস্ক্রাইবার গণনা দেখানোর পদ্ধতিকে প্রভাবিত করে। আরও তথ্যের জন্য অনুগ্রহ করে পুনর্বিবেচনার ইতিহাস বা YouTube সহায়তা কেন্দ্র দেখুন৷

অনুরোধের মানদণ্ডের সাথে মেলে এমন শূন্য বা তার বেশি channel সংস্থানগুলির একটি সংগ্রহ ফেরত দেয়৷

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

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

একটি অনুরোধ যা একটি channel সংস্থানের জন্য auditDetails অংশ পুনরুদ্ধার করে তাকে অবশ্যই একটি অনুমোদন টোকেন প্রদান করতে হবে যাতে https://www.googleapis.com/auth/youtubepartner-channel-audit স্কোপ থাকে৷ উপরন্তু, MCN চ্যানেলটিকে গ্রহণ বা প্রত্যাখ্যান করার সিদ্ধান্ত নিলে বা টোকেন ইস্যু করার তারিখের দুই সপ্তাহের মধ্যে সেই সুযোগ ব্যবহার করে এমন কোনো টোকেন অবশ্যই প্রত্যাহার করতে হবে।

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটারটি এক বা একাধিক channel রিসোর্স বৈশিষ্ট্যের একটি কমা-বিচ্ছিন্ন তালিকা নির্দিষ্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে।

যদি প্যারামিটারটি এমন একটি সম্পত্তি চিহ্নিত করে যাতে শিশু বৈশিষ্ট্য রয়েছে, তবে শিশু বৈশিষ্ট্যগুলি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে। উদাহরণ স্বরূপ, একটি channel রিসোর্সে, contentDetails বৈশিষ্ট্যে অন্যান্য বৈশিষ্ট্য রয়েছে, যেমন uploads বৈশিষ্ট্য। যেমন, আপনি যদি part=contentDetails সেট করেন, API প্রতিক্রিয়াতে সেই সমস্ত নেস্টেড বৈশিষ্ট্যও থাকবে।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • auditDetails
  • brandingSettings
  • contentDetails
  • contentOwnerDetails
  • id
  • localizations
  • snippet
  • statistics
  • status
  • topicDetails
ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন)
categoryId string
এই প্যারামিটারটি অবমূল্যায়ন করা হয়েছে৷ categoryId প্যারামিটার একটি YouTube গাইড বিভাগ নির্দিষ্ট করে এবং সেই বিভাগের সাথে যুক্ত YouTube চ্যানেলের অনুরোধ করতে ব্যবহার করা যেতে পারে।
forHandle string
forHandle প্যারামিটার একটি YouTube হ্যান্ডেল নির্দিষ্ট করে, যার ফলে সেই হ্যান্ডেলের সাথে যুক্ত চ্যানেলের অনুরোধ করা হয়। পরামিতি মান একটি @ চিহ্ন দিয়ে প্রিপেন্ড করা যেতে পারে। উদাহরণ স্বরূপ, "Google for Developers" চ্যানেলের জন্য সম্পদ পুনরুদ্ধার করতে, forHandle প্যারামিটার মানটিকে GoogleDevelopers বা @GoogleDevelopers এ সেট করুন।
forUsername string
forUsername প্যারামিটার একটি YouTube ব্যবহারকারীর নাম নির্দিষ্ট করে, যার ফলে সেই ব্যবহারকারী নামের সাথে যুক্ত চ্যানেলের অনুরোধ করা হয়।
id string
id প্যারামিটারটি পুনরুদ্ধার করা সংস্থানগুলির জন্য YouTube চ্যানেল আইডি(গুলি) এর একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে৷ একটি channel রিসোর্সে, id প্রপার্টি চ্যানেলের YouTube চ্যানেল আইডি নির্দিষ্ট করে।
managedByMe boolean
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে এমন বিষয়বস্তুর মালিক দ্বারা পরিচালিত চ্যানেলগুলি ফেরত দেওয়ার জন্য API-কে নির্দেশ দিতে এই প্যারামিটারের মান true সেট করুন৷ ব্যবহারকারীকে অবশ্যই নির্দিষ্ট সামগ্রীর মালিকের সাথে লিঙ্কযুক্ত একটি CMS অ্যাকাউন্ট হিসাবে প্রমাণীকরণ করতে হবে এবং onBehalfOfContentOwner প্রদান করতে হবে৷
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 বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।
pageToken string
pageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken এবং prevPageToken বৈশিষ্ট্যগুলি অন্যান্য পৃষ্ঠাগুলি সনাক্ত করে যা পুনরুদ্ধার করা যেতে পারে।

শরীরের অনুরোধ

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

প্রতিক্রিয়া

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

{
  "kind": "youtube#channelListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    channel Resource
  ]
}

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

বৈশিষ্ট্য
kind string
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#channelListResponse
etag etag
এই সম্পদের Etag.
nextPageToken string
ফলাফল সেটের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে pageToken প্যারামিটারের মান হিসাবে টোকেন ব্যবহার করা যেতে পারে।
prevPageToken string
ফলাফল সেটে পূর্ববর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে pageToken প্যারামিটারের মান হিসাবে টোকেন ব্যবহার করা যেতে পারে। মনে রাখবেন যে এই বৈশিষ্ট্যটি API প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হয় না যদি সংশ্লিষ্ট API অনুরোধটি managedByMe প্যারামিটারটিকে true সেট করে।
pageInfo object
pageInfo অবজেক্ট ফলাফল সেটের জন্য পেজিং তথ্য এনক্যাপসুলেট করে।
pageInfo. totalResults integer
ফলাফল সেটে মোট ফলাফলের সংখ্যা।
pageInfo. resultsPerPage integer
API প্রতিক্রিয়ায় অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[] list
অনুরোধের মানদণ্ডের সাথে মেলে এমন চ্যানেলগুলির একটি তালিকা৷

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) invalidCriteria নিম্নলিখিত ফিল্টারগুলির মধ্যে সর্বাধিক একটি নির্দিষ্ট করা যেতে পারে: id , categoryId , mine , managedByMe , forHandle , forUsername . onBehalfOfContentOwner প্যারামিটারের মাধ্যমে বিষয়বস্তুর মালিকের প্রমাণীকরণের ক্ষেত্রে, শুধুমাত্র id বা managedByMe নির্দিষ্ট করা যেতে পারে।
forbidden (403) channelForbidden id প্যারামিটার দ্বারা নির্দিষ্ট করা চ্যানেল অনুরোধ সমর্থন করে না বা অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
notFound (404) categoryNotFound categoryId প্যারামিটার দ্বারা চিহ্নিত বিভাগটি খুঁজে পাওয়া যাবে না। বৈধ মানগুলির একটি তালিকা পুনরুদ্ধার করতে guideCategories.list পদ্ধতি ব্যবহার করুন।
notFound (404) channelNotFound id প্যারামিটারে উল্লিখিত চ্যানেল খুঁজে পাওয়া যাবে না।

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

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