Members: list

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

একটি চ্যানেলের জন্য সদস্যদের (পূর্বে "স্পন্সর" নামে পরিচিত) তালিকা করে। API অনুরোধ চ্যানেল মালিক দ্বারা অনুমোদিত হতে হবে.

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

অনুরোধ

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 । প্রতি কলে সর্বাধিক 100টি চ্যানেল নির্দিষ্ট করা যেতে পারে।

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

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

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

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

{
  "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 প্যারামিটার মান 100 টির বেশি চ্যানেল নির্দিষ্ট করলে এই ত্রুটিটি ঘটে।