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. 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$ نمایش داده می شود. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2023-02-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2023-02-22 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Fan Funding feature has been deprecated, and its API will be turned off on February 28, 2017, in conjunction with the launch of YouTube's Super Chat feature.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003efanFundingEvent\u003c/code\u003e resource represents a one-time, voluntary monetary payment from a user to a YouTube channel as part of the now deprecated Fan Funding feature.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003efanFundingEvents\u003c/code\u003e API supports a \u003ccode\u003elist\u003c/code\u003e method for retrieving fan funding events for a channel, which requires authorization from the channel owner.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003efanFundingEvent\u003c/code\u003e resource includes details such as the supporter's information (if made public), the amount funded, the currency used, and a display string of the funding amount.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esnippet\u003c/code\u003e object within the \u003ccode\u003efanFundingEvent\u003c/code\u003e resource contains information about the funding event, including the channel that received the funding, supporter details, comment text, and the date, time, and amount of the funding.\u003c/p\u003e\n"]]],["The Fan Funding feature is deprecated, with its API shutting down on February 28, 2017. The `fanFundingEvent` resource represents a voluntary, one-time payment to a YouTube channel. The API allows listing fan funding events for a channel via the `list` method, which requires channel owner authorization. Each event's data includes details like the supporter's channel ID, comment, and the funding amount, currency, and the display string. YouTube has released Super Chat as a replacement.\n"],null,["# FanFundingEvents\n\n**Note:** This is a deprecation announcement. \n\nThe Fan Funding feature has been deprecated, and the Fan Funding API will be turned off on February 28, 2017. This deprecation announcement coincides with the release of YouTube's new [Super Chat](https://youtube.googleblog.com/2017/01/can-we-chat-hello-super-chat.html) feature.\nA **fanFundingEvent** resource represents a Fan Funding event on a YouTube channel. Fan Funding provides a way to monetarily support YouTube creators. A Fan Funding event occurs when a user makes a one-time, voluntary payment to a channel. See the [YouTube Help Center](https://support.google.com/youtube/answer/6052077) to learn more about Fan Funding.\n\nMethods\n-------\n\nThe API supports the following methods for `fanFundingEvents` resources:\n\n[list](/youtube/v3/live/docs/fanFundingEvents/list)\n: Lists fan funding events for a channel. The API request must be authorized by the channel owner.\n [Try it now](/youtube/v3/live/docs/fanFundingEvents/list#try-it).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `fanFundingEvents` resource: \n\n```text\n{\n \"kind\": \"youtube#fanFundingEvent\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"channelId\": string,\n \"supporterDetails\": {\n \"channelId\": string,\n \"channelUrl\": string,\n \"displayName\": string,\n \"profileImageUrl\": string\n },\n \"commentText\": string,\n \"createdAt\": datetime,\n \"amountMicros\": unsigned long,\n \"currency\": string,\n \"displayString\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|--------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#fanFundingEvent`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube assigns to uniquely identify the fan funding event. |\n| `snippet` | `object` The `snippet` object contains information about the fan funding event. |\n| snippet.`channelId` | `string` The ID of the channel that received the funding. |\n| snippet.`supporterDetails` | `object` Details about the supporter's channel. This object is only present if the supporter made the funding event public. |\n| snippet.supporterDetails.`channelId` | `string` The supporter's YouTube channel ID. |\n| snippet.supporterDetails.`channelUrl` | `string` The URL of the supporter's channel. |\n| snippet.supporterDetails.`displayName` | `string` The display name of the supporter's channel. |\n| snippet.supporterDetails.`profileImageUrl` | `string` The avatar URL for the supporter's channel. |\n| snippet.`commentText` | `string` The text contents of the supporter's comment. |\n| snippet.`createdAt` | `datetime` The date and time when the funding occurred. The value is specified in [ISO 8601](//www.w3.org/TR/NOTE-datetime) (`YYYY-MM-DDThh:mm:ss.sZ`) format. |\n| snippet.`amountMicros` | `unsigned long` The amount of money contributed in the funding event. The value is in micros of the funding currency. For example, if the funder contributed one dollar ($1), the `snippet.amountMicros` property value is `1000000`. |\n| snippet.`currency` | `string` The currency associated with the funding amount. The value is an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. |\n| snippet.`displayString` | `string` A string, intended for display, that shows the fund amount and currency. If the `fanFundingEvents.list` request specified an application language with the [hl](/youtube/v3/live/docs/fanFundingEvents/list#hl) parameter, the display string is localized for display in that language. For example, in English, currency would be displayed as `$1.50`, but in French, it would be displayed as `1,50$`. |"]]
