MembershipsLevels: list

ملاحظة: يمكن لصنّاع المحتوى الفرديين استخدام نقطة النهاية هذه لتقديم طلبات إلى قنواتهم الخاصة على YouTube والتي تم تفعيل ميزة "العضوية في القنوات" فيها. يمكنك التواصل مع ممثّل عن Google أو 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
علامة هذا المرجع.
items[] list
قائمة تضمّ membershipsLevel مورد تملك القناة التي سمحت بإرسال طلب البيانات من واجهة برمجة التطبيقات

الأخطاء

يحدّد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات استجابةً لطلب بيانات إلى هذه الطريقة. يُرجى الاطّلاع على وثائق رسالة الخطأ للحصول على مزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) channelMembershipsNotEnabled إنّ قناة صانع المحتوى التي تسمح بالطلب غير مفعّلة في ميزة "العضوية في القنوات".