FanFundingEvents: list

ملاحظة: هذا إعلان بشأن الإيقاف.

لقد تمّ إيقاف ميزة التمويل من المعجبين وسيتمّ إيقاف واجهة برمجة تطبيقات التمويل من المعجبين في 28 شباط (فبراير) 2017. يتزامن إعلان الإيقاف هذا مع إصدار ميزة Super Chat الجديدة في YouTube.

يسرد أحداث التمويل من المعجبين لقناة. يجب أن يأذن مالك القناة بطلب واجهة برمجة التطبيقات.

طلب

طلب HTTP

GET https://www.googleapis.com/youtube/v3/fanFundingEvents

التفويض

ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

المعلَمات

يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.

المعلَمات
المعلّمات المطلوبة
part string
تحدد المعلمة part أجزاء المورد fanFundingEvent التي ستتضمنها استجابة واجهة برمجة التطبيقات. القيمتان المسموح بإدراجهما هما id وsnippet.
المعلّمات الاختيارية
hl string
توجِّه المَعلمة hl واجهة برمجة التطبيقات لاسترداد سلسلة عرض عملة مترجمة للغة لغة تطبيق معتمَدة على موقع YouTube الإلكتروني. على سبيل المثال، سيتم عرض العملة باللغة الإنجليزية على النحو $1.50، ولكن سيتم عرضها باللغة الفرنسية على الشكل 1,50$.

يجب أن تكون قيمة المعلّمة رمز لغة مضمّنًا في القائمة المعروضة باستخدام طريقة i18nLanguages.list.
maxResults unsigned integer
تحدّد المعلمة maxResults الحد الأقصى لعدد العناصر التي يجب عرضها في مجموعة النتائج. القيم المقبولة هي 0 إلى 50، بما في ذلك القيم الواقعة بينهما. القيمة التلقائية هي 5.
pageToken string
تحدّد المعلمة pageToken الصفحة المحدّدة في مجموعة النتائج التي يُطلب من خادم واجهة برمجة التطبيقات عرضها. في استجابة واجهة برمجة التطبيقات، تحدّد الخاصية nextPageToken الصفحة التالية من نتائج الطلب.

نص الطلب

لا تقدِّم نص طلب عند طلب هذه الطريقة.

الإجابة

إذا نجحت هذه الطريقة، فإنها تعرض نص الاستجابة بالبنية التالية:

{
  "kind": "youtube#fanFundingEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    fanFundingEvent resource
  ]
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
kind string
تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#fanFundingEventListResponse.
etag etag
Etag لهذا المورد.
nextPageToken string
الرمز المميّز الذي يمكن استخدامه كقيمة للمعلَمة pageToken لاسترداد الصفحة التالية في مجموعة النتائج
pageInfo object
يتضمّن الكائن pageInfo معلومات الصفحات في مجموعة النتائج.
pageInfo.totalResults integer
إجمالي عدد النتائج في مجموعة النتائج.
pageInfo.resultsPerPage integer
عدد النتائج المضمّنة في استجابة واجهة برمجة التطبيقات.
items[] list
قائمة بأحداث التمويل من المعجبين التي تستوفي معايير الطلب.

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) insufficientPermissions ليست لديك الأذونات اللازمة لعرض أحداث التمويل من المعجبين في القناة.
invalidValue (400) fanFundingNotEnabledForChannelId عدم تفعيل ميزة التمويل من المعجبين في القناة.

جرِّب هذه الميزة الآن.

استخدم مستكشف واجهة برمجة التطبيقات لاستدعاء هذه الطريقة في البيانات المباشرة والاطلاع على طلب واجهة برمجة التطبيقات والاستجابة لها.