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$.