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
Etag لهذا المورد.
items[] list
قائمة تتضمّن membershipsLevel موارد تملكها القناة التي فوضت طلب البيانات من واجهة برمجة التطبيقات

الأخطاء

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

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