Members: list

মনে রাখবেন: এই এন্ডপয়েন্ট শুধুমাত্র স্বতন্ত্র ক্রিয়েটররা তাদের নিজস্ব, চ্যানেল মেম্বারশিপ চালু থাকা YouTube চ্যানেলের জন্য অনুরোধ করতে ব্যবহার করতে পারবেন। অ্যাক্সেসের অনুরোধ করতে আপনার Google বা YouTube প্রতিনিধির সাথে যোগাযোগ করুন।

কোনও চ্যানেলের মেম্বারদের (আগে "স্পনসর" নামে পরিচিত ছিল) তালিকা দেখায়। চ্যানেলের মালিককে API অনুরোধ অনুমোদন করতে হবে।

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপ সহ অনুমোদনের প্রয়োজন:

সুযোগ
https://www.googleapis.com/auth/youtube.channel-memberships.creator

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটারটি member রিসোর্স প্রপার্টি নির্দিষ্ট করে যা API উত্তর অন্তর্ভুক্ত করবে। প্যারামিটারের ভ্যালু snippet হিসেবে সেট করুন।
ঐচ্ছিক প্যারামিটার
mode	string mode প্যারামিটার থেকে বোঝা যায় যে কোন কোন মেম্বারকে API রেসপন্সে অন্তর্ভুক্ত করা হবে। প্যারামিটারের মান নিম্নলিখিত মানগুলির মধ্যে একটিতে সেট করুন: all_current (ডিফল্ট) - বর্তমান মেম্বারদের তালিকা, নতুন থেকে পুরনো হিসেবে। এই মান ব্যবহার করা হলে, API-এর উত্তরে nextPageToken না থাকলে তালিকার শেষ আইটেমে পৌঁছে যাওয়া হয়েছে বলে ধরে নেওয়া হয়। updates - শুধু সেইসব মেম্বারদের তালিকা যারা আগের API কলের পর থেকে যোগ দিয়েছেন বা আপগ্রেড করেছেন। মনে রাখবেন, প্রথম কলটি আপডেটগুলির একটি নতুন স্ট্রিম শুরু করে, কিন্তু আসলে কোনও মেম্বারকে ফেরত পাঠায় না। মেম্বারশিপ সংক্রান্ত আপডেট পাওয়া শুরু করতে, আপনার পছন্দসই ফ্রিকোয়েন্সিতে nextPageToken ব্যবহার করে এন্ডপয়েন্ট পোল করতে হবে। মনে রাখবেন যে এই ভ্যালু ব্যবহার করা হলে, API রেসপন্সে সবসময় একটি nextPageToken থাকে।
maxResults	unsigned integer maxResults প্যারামিটারটি ফলাফল সেটে সর্বাধিক কতগুলি আইটেম দেখানো উচিত তা নির্দিষ্ট করে। গ্রহণযোগ্য ভ্যালু হল 0 থেকে 1000, অন্তর্ভুক্ত। ডিফল্ট ভ্যালু হল 5।
pageToken	string pageToken প্যারামিটার, ফলাফল সেটের মধ্যে এমন একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দিতে হবে। টোকেনটি আসল API অনুরোধের সাথে ব্যবহৃত mode-এর জন্য নির্দিষ্ট, তাই আপনি একটি মোডের মাধ্যমে পাওয়া পৃষ্ঠা টোকেন ব্যবহার করে পরবর্তীকালে অন্য মোডে পরিবর্তন করতে পারবেন না।
hasAccessToLevel	string hasAccessToLevel প্যারামিটার ভ্যালু হল একটি লেভেল আইডি যা ফলাফলের সেটে থাকা মেম্বারদের ন্যূনতম লেভেল নির্দিষ্ট করে।
filterByMemberChannelId	string filterByMemberChannelId প্যারামিটার কমা দিয়ে আলাদা করা চ্যানেল আইডির তালিকা নির্দিষ্ট করে যা নির্দিষ্ট ব্যবহারকারীর মেম্বারশিপ স্ট্যাটাস চেক করার জন্য ব্যবহার করা যেতে পারে। যেমন, UC_1,UC_2,UC_3। প্রতিটি কলের জন্য সর্বাধিক ১০০টি চ্যানেল নির্দিষ্ট করা যেতে পারে।

অনুরোধের বডি

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

রেসপন্স

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

{
  "kind": "youtube#memberListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    member Resource
  ]
}

প্রপার্টি

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

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

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
badRequest (400)	channelMembershipsNotEnabled	অনুরোধ অনুমোদনকারী ক্রিয়েটর চ্যানেলে চ্যানেল মেম্বারশিপ চালু নেই।
badRequest (400)	invalidMode	mode প্যারামিটারের ভ্যালু সঠিক নয়। pageToken প্যারামিটার এমন একটি টোকেন নির্দিষ্ট করলে এই সমস্যা হতে পারে যা নির্দিষ্ট করা মোড থেকে আলাদা মোড ব্যবহার করে ফিরিয়ে আনা হয়েছে।
badRequest (400)	invalidPageToken	pageToken প্যারামিটারের ভ্যালু সঠিক নয়। অনুরোধে ব্যবহার করা পৃষ্ঠা টোকেনের মেয়াদ শেষ হয়ে গেলে বা সেটি শনাক্ত করা না গেলে এই সমস্যা হতে পারে।
badRequest (400)	invalidHasAccessToLevel	hasAccessToLevel প্যারামিটারের মান সঠিক নয়। নির্দিষ্ট করা id লেভেল নেই।
badRequest (400)	invalidFilterByMemberChannelId	filterByMemberChannelId প্যারামিটারের ভ্যালু সঠিক নয়। এই সমস্যাটি ঘটে যদি filterByMemberChannelId প্যারামিটার ভ্যালু ১০০টির বেশি চ্যানেল নির্দিষ্ট করে।