FanFundingEvents

הערה: זוהי הודעה על הוצאה משימוש.

התכונה 'מימון על ידי אוהדים' הוצאה משימוש ו-Fan Funding API יושבת ב-28 בפברואר 2017. ההודעה על ההוצאה משימוש קרובה להשקה של התכונה החדשה YouTube Chat.

משאב fanFundingEvent מייצג אירוע 'מימון על ידי אוהדים' בערוץ YouTube. 'מימון על ידי אוהדים' מאפשר לך לתמוך בצורה כספית ביוצרים ב-YouTube. אירוע 'מימון על ידי אוהדים' מתרחש כאשר משתמש מבצע תשלום חד-פעמי לערוץ. עיין במרכז העזרה של YouTube למידע נוסף על 'מימון על ידי אוהדים'.

שיטות

ה-API תומך בשיטות הבאות עבור משאבי fanFundingEvents:

list

רשימת אירועי מימון של מעריצים בערוץ. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ. כדאי לנסות עכשיו.

ייצוג משאבים

המבנה הבא של 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 מזהה את סוג המשאב של ה-API. הערך יהיה youtube#fanFundingEvent.
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 סכום הכסף שתרם לאירוע המימון. הערך הוא במיליוניות של מטבע המימון. לדוגמה, אם הקרן תרמה דולר אחד ($1), ערך הנכס snippet.amountMicros הוא 1000000.
snippet.currency	string המטבע שמשויך לסכום המימון. הערך הוא קוד מטבע בתקן ISO 4217.
snippet.displayString	string מחרוזת, המיועדת לרשת המדיה, שבה מוצג סכום הקרן והמטבע. אם בבקשה של fanFundingEvents.list צוינה שפת אפליקציה עם הפרמטר hl, מחרוזת התצוגה מותאמת לשוק המקומי עבור אותה שפה. לדוגמה, המטבע יוצג באנגלית בתור $1.50, אבל בצרפתית הוא יוצג בתור 1,50$.