Channels: list

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

অনুরোধের মাপকাঠি পূরণ করে এমন শূন্য বা তার বেশি channel রিসোর্সের সংগ্রহ রিটার্ন করে।

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

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

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 কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে। এই প্যারামিটারের মান true-এ সেট করুন যাতে API-কে শুধুমাত্র onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্টের মালিকের দ্বারা পরিচালিত চ্যানেলগুলি ফেরত দেওয়ার নির্দেশ দেওয়া হয়। ব্যবহারকারীকে অবশ্যই নির্দিষ্ট কন্টেন্ট মালিকের সাথে লিঙ্ক করা CMS অ্যাকাউন্ট হিসেবে যাচাই করতে হবে এবং onBehalfOfContentOwner প্রদান করতে হবে।
mine	boolean এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এই প্যারামিটারের ভ্যালু true-এ সেট করুন যাতে API-কে শুধু যাচাই করা ব্যবহারকারীর মালিকানাধীন চ্যানেলগুলি দেখানোর নির্দেশ দেওয়া যায়।
ঐচ্ছিক প্যারামিটার
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 প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API উত্তরের মধ্যে, 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 অনুরোধে managedByMe প্যারামিটার true হিসেবে সেট করা থাকলে, এই প্রপার্টি API উত্তরে অন্তর্ভুক্ত করা হয় না।
pageInfo	object pageInfo অবজেক্টটি ফলাফল সেটের জন্য পেজিং তথ্য এনক্যাপসুলেট করে।
pageInfo.totalResults	integer ফলাফলের সেটে মোট ফলাফলের সংখ্যা।
pageInfo.resultsPerPage	integer API রেসপন্সে অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[]	list অনুরোধের মাপকাঠি পূরণ করে এমন চ্যানেলের তালিকা।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ রিটার্ন করতে পারে, তা নিম্নলিখিত সারণীতে শনাক্ত করা হয়েছে। আরও বিবরণের জন্য, YouTube Data 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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।