MembershipsLevels: list

توجه: این نقطه پایانی فقط می‌تواند توسط سازندگان شخصی برای ارسال درخواست برای کانال یوتیوب خود که قابلیت عضویت در کانال را دارد، استفاده شود.

سطوح عضویت را برای کانالی که درخواست را تأیید کرده است، فهرست می‌کند. سطوح به ترتیب نمایش ضمنی بازگردانده می‌شوند. درخواست‌های API به این متد یکی از پاسخ‌های زیر را ارائه می‌دهند:

• اگر سازنده، عضویت در کانال را فعال کرده و سطوح قیمت‌گذاری داشته باشد، پاسخ API شامل فهرست سطوح است.
• اگر سازنده، عضویت در کانال را فعال کرده باشد اما سطوح قیمت‌گذاری را تعریف نکرده باشد، پاسخ API حاوی یک لیست خالی است.
• اگر سازنده، عضویت در کانال را فعال نکرده باشد، API خطای channelMembershipsNotEnabled را برمی‌گرداند.

تأثیر سهمیه: فراخوانی این متد هزینه سهمیه‌ای برابر با ۱ واحد دارد.

درخواست

درخواست HTTP

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

این درخواست نیاز به مجوز با دامنه زیر دارد:

محدوده
https://www.googleapis.com/auth/youtube.channel-memberships.creator

پارامترها

جدول زیر پارامترهایی را که این پرس و جو پشتیبانی می‌کند، فهرست می‌کند. همه پارامترهای ذکر شده، پارامترهای پرس و جو هستند.

پارامترها
پارامترهای مورد نیاز
part	string پارامتر part ویژگی‌های منبع membershipsLevel را که پاسخ API شامل آن خواهد بود، مشخص می‌کند. مقدار پارامتر، فهرستی از بخش‌های منبع است که با کاما از هم جدا شده‌اند. فهرست زیر بخش‌هایی را که می‌توانند بازیابی شوند نشان می‌دهد: id snippet

درخواست بدنه

هنگام فراخوانی این متد، بدنه درخواست را ارائه ندهید.

پاسخ

در صورت موفقیت، این متد یک بدنه پاسخ با ساختار زیر برمی‌گرداند:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

خواص

جدول زیر ویژگی‌هایی را که در این منبع ظاهر می‌شوند، تعریف می‌کند:

خواص
kind	string نوع منبع API را مشخص می‌کند. مقدار آن youtube#membershipsLevelListResponse خواهد بود.
etag	etag برچسب E این منبع.
items[]	list فهرستی از منابع membershipsLevel که متعلق به کانالی است که درخواست API را تأیید کرده است.

خطاها

جدول زیر پیام‌های خطایی را که API می‌تواند در پاسخ به فراخوانی این متد برگرداند، مشخص می‌کند. برای جزئیات بیشتر، لطفاً به مستندات پیام خطا مراجعه کنید.

نوع خطا	جزئیات خطا	توضیحات
badRequest (400)	channelMembershipsNotEnabled	کانال سازنده‌ای که درخواست را تأیید می‌کند، عضویت کانال فعال ندارد.