MembershipsLevels: list

ملاحظة: لا يمكن لصنّاع المحتوى الأفراد استخدام نقطة النهاية هذه إلا لتقديم طلبات لقنواتهم على YouTube التي تم تفعيل ميزة "العضوية في القنوات" فيها.

تعرض هذه الطريقة مستويات العضوية في القناة التي أذنت بالطلب. يتم عرض المستويات بترتيب العرض الضمني. تؤدي طلبات واجهة برمجة التطبيقات إلى هذه الطريقة إلى إحدى الاستجابات التالية:

  • إذا فعّل صانع المحتوى ميزة "العضوية في القنوات" وحدّد مستويات الأسعار، ستتضمّن استجابة واجهة برمجة التطبيقات قائمة بالمستويات.
  • إذا فعّل صانع المحتوى ميزة "العضوية في القنوات" ولكن لم يحدّد مستويات الأسعار، ستتضمّن استجابة واجهة برمجة التطبيقات قائمة فارغة.
  • إذا لم يفعّل صانع المحتوى ميزة "العضوية في القنوات"، ستعرض واجهة برمجة التطبيقات الخطأ 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 لم يتم تفعيل ميزة "العضوية في القنوات" في قناة صانع المحتوى التي أذنت بالطلب.