MembershipsLevels: list

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

سطوح عضویت را برای کانالی که درخواست را مجاز کرده است فهرست می‌کند. سطوح در ترتیب نمایش ضمنی برگردانده می‌شوند. درخواست‌های 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 را که پاسخ میانای برنامه‌سازی کاربردی دربرخواهد داشت مشخص می‌کند. مقدار پارامتر فهرستی از بخش‌های منبع است که با کاما از هم جدا شده‌اند. فهرست زیر بخش‌هایی را نشان می‌دهد که می‌توانند بازیابی شوند: id snippet

متن درخواست

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

پاسخ

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

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

مشخصات

جدول زیر خصوصیات نشان‌داده‌شده در این منبع را تعریف می‌کند:

مشخصات
kind	string نوع منبع «میانای برنامه‌سازی کاربردی» را مشخص می‌کند. مقدار youtube#membershipsLevelListResponse خواهد بود.
etag	etag Etag این منبع.
items[]	list فهرستی از منابع membershipsLevel که متعلق به کانالی است که درخواست میانای برنامه‌سازی کاربردی را مجاز کرده است.

خطاها

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

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