FanFundingEvents

توجه: این یک اعلامیه منسوخ شدن است.

ویژگی Fan Funding منسوخ شده است و Fan Funding API در 28 فوریه 2017 خاموش خواهد شد. این اعلامیه لغو همزمان با انتشار ویژگی جدید Super Chat YouTube است.

یک منبع fanFundingEvent یک رویداد سرمایه‌گذاری طرفداران را در یک کانال YouTube نشان می‌دهد. سرمایه‌گذاری طرفداران راهی برای حمایت مالی از سازندگان YouTube ارائه می‌کند. رویداد Fan Funding زمانی اتفاق می‌افتد که کاربر یک بار و داوطلبانه به یک کانال پرداخت کند. برای کسب اطلاعات بیشتر درباره تأمین مالی طرفداران، به مرکز راهنمایی 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 Etag این منبع
id	string شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد رویداد تأمین مالی طرفداران اختصاص می‌دهد.
snippet	object شی snippet حاوی اطلاعاتی درباره رویداد تأمین مالی طرفداران است.
snippet. channelId	string شناسه کانالی که بودجه را دریافت کرده است.
snippet. supporterDetails	object جزئیات کانال حامی این شی فقط در صورتی وجود دارد که حامی رویداد مالی را عمومی کند.
snippet.supporterDetails. channelId	string شناسه کانال یوتیوب حامی.
snippet.supporterDetails. channelUrl	string آدرس کانال حامی
snippet.supporterDetails. displayName	string نام نمایشی کانال حامی
snippet.supporterDetails. profileImageUrl	string نشانی وب آواتار برای کانال حامی.
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$ نمایش داده می شود.