يسرد مستويات الانتساب للقناة التي سمحت بالطلب. ويتم عرض المستويات بالترتيب الضمني المعروض. ينتج عن طلبات واجهة برمجة التطبيقات لهذه الطريقة أحد الاستجابات التالية:
- إذا فعّل منشئ المحتوى ميزة "القنوات المنتسَب إليها" وكان لديه مستويات أسعار، يجب أن تتضمّن الاستجابة لواجهة برمجة التطبيقات قائمة بالمستويات.
- إذا فعّل منشئ المحتوى ميزة "القنوات المُنتسَب إليها" ولكن لم يحدّد مستويات الأسعار، يعني هذا أنّ استجابة واجهة برمجة التطبيقات تحتوي على قائمة فارغة.
- إذا لم يفعّل منشئ المحتوى ميزة "القنوات المُنتسَب إليها"، ستعرض واجهة برمجة التطبيقات
خطأ
channelMembershipsNotEnabled
.
الحصة النسبية: إنّ الاستدعاء لهذه الطريقة لديه تكلفة حصة وحدة واحدة.
الطلب
طلب HTTP
GET https://www.googleapis.com/youtube/v3/membershipsLevels
ويتطلب هذا الطلب تفويضًا من خلال النطاق التالي:
النطاق |
---|
https://www.googleapis.com/auth/youtube.channel-memberships.creator |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
part |
string تحدّد المعلَمة part خصائص المورد membershipsLevel التي ستشملها استجابة واجهة برمجة التطبيقات. قيمة المَعلمة هي
قائمة مفصولة بفواصل لأجزاء الموارد. تعرض القائمة التالية الأجزاء التي يمكن
استردادها:
|
نص الطلب
لا تقدِّم نص طلب عند طلب هذه الطريقة.
الإجابة
إذا نجحت هذه الطريقة، فإنها تعرض نص الاستجابة بالبنية التالية:
{ "kind": "youtube#membershipsLevelListResponse", "etag": etag, "items": [ membershipsLevel Resource ] }
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
أماكن إقامة | |
---|---|
kind |
string تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#membershipsLevelListResponse . |
etag |
etag Etag لهذا المورد. |
items[] |
list قائمة تتضمّن membershipsLevel موارد تملكها القناة التي فوضت طلب البيانات من واجهة برمجة التطبيقات |
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
إنّ ميزة "القنوات المنتسَب إليها" غير مفعّلة في قناة منشئ المحتوى التي تسمح بالطلب. |