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