FanFundingEvents
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Примечание. Это объявление об устаревании.
Поддержка функции Fan Funding устарела, а 28 февраля 2017 года API Fan Funding будет отключен. Это объявление об прекращении поддержки совпадает с выпуском новой функции
Super Chat на YouTube.
Ресурс fanFundingEvent
представляет событие Fan Funding на канале YouTube. Fan Funding — это способ денежной поддержки авторов 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 Идентификатор канала болельщика на YouTube. |
snippet.supporterDetails. channelUrl | string URL канала сторонника. |
snippet.supporterDetails. displayName | string Отображаемое имя канала болельщика. |
snippet.supporterDetails. profileImageUrl | string URL-адрес аватара для канала сторонника. |
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 "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-02-22 UTC.
[null,null,["Последнее обновление: 2023-02-22 UTC."],[[["\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$`. |"]]