MembershipsLevels: list

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

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

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

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 1 واحدی دارد.

درخواست

درخواست 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
Etag این منبع
items[] list
فهرستی از منابع membershipsLevel متعلق به کانالی که درخواست API را مجاز کرده است.

خطاها

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

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