FanFundingEvents

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

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

يمثل مورد fanFundingEvent حدث التمويل من المعجبين على قناة YouTube. توفر ميزة التمويل من المعجبين وسيلة لتحقيق الربح المادي لمنشئي المحتوى في YouTube. تحدث حدث التمويل من المعجبين عندما يقدّم المستخدم دفعة طوعية لمرة واحدة إلى قناة. راجع مركز مساعدة YouTube للاطلاع على مزيد من المعلومات حول ميزة التمويل من المعجبين.

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (fanFundingEvents):

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

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد fanFundingEvents:

{
  "kind": "youtube#fanFundingEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string
  }
}

أماكن إقامة

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

أماكن إقامة
kind string
تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#fanFundingEvent.
etag etag
Etag لهذا المورد.
id string
المعرّف الذي يعيّنه YouTube لتعريف حدث التمويل من المعجبين بشكل فريد.
snippet object
يحتوي الكائن snippet على معلومات حول حدث التمويل من المعجبين.
snippet.channelId string
معرّف القناة التي تلقّت التمويل
snippet.supporterDetails object
تفاصيل حول قناة المؤيّد لا يتوفّر هذا العنصر إلا إذا جعل الداعم حدث التمويل علنيًا.
snippet.supporterDetails.channelId string
معرّف قناة الداعم على YouTube
snippet.supporterDetails.channelUrl string
عنوان URL لقناة المؤيّد
snippet.supporterDetails.displayName string
الاسم المعروض لقناة المؤيّد
snippet.supporterDetails.profileImageUrl string
عنوان URL للصورة الرمزية لقناة المؤيّد
snippet.commentText string
محتوى نص تعليق الداعم
snippet.createdAt datetime
تاريخ ووقت تقديم التمويل يتم تحديد القيمة بتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros unsigned long
المبلغ الذي تمت المساهمة به في حدث التمويل. القيمة بالمايكرو على عملة التمويل. على سبيل المثال، إذا ساهم الممول بمبلغ دولار أمريكي واحد (أو ما يعادله بالعملة المحلية)، تكون قيمة الخاصية snippet.amountMicros هي 1000000.
snippet.currency string
العملة المرتبطة بمبلغ التمويل. وتكون القيمة عبارة عن رمز عملة ISO 4217.
snippet.displayString string
سلسلة مخصّصة للعرض تعرض مبلغ الصندوق والعملة فيه. إذا حدّد الطلب fanFundingEvents.list لغة تطبيق تحتوي على المعلَمة hl، تتم ترجمة سلسلة العرض لعرضها بهذه اللغة. على سبيل المثال، سيتم عرض العملة باللغة الإنجليزية على النحو $1.50، ولكن سيتم عرضها باللغة الفرنسية على الشكل 1,50$.