FanFundingEvents

注意：这是关于弃用的公告。

粉丝资助功能已弃用，我们将于 2017 年 2 月 28 日停用 Fan Funding API。此弃用通知正好与 YouTube 新推出的超级留言功能发布同时进行。

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 此资源的 Etag。
id	string YouTube 指定用于唯一标识粉丝资助活动的 ID。
snippet	object snippet 对象包含有关粉丝资助活动的信息。
snippet.channelId	string 收到资金的频道的 ID。
snippet.supporterDetails	object 支持者频道的详细信息。仅当支持者将筹资活动设为公开时，此对象才会显示。
snippet.supporterDetails.channelId	string 支持者的 YouTube 频道 ID。
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 美元（1 美元），则 snippet.amountMicros 属性值为 1000000。
snippet.currency	string 与资金金额相关联的币种。该值为 ISO 4217 货币代码。
snippet.displayString	string 一个用于显示资金金额和币种的字符串。如果 fanFundingEvents.list 请求使用 hl 参数指定了应用语言，则系统会将显示字符串本地化，以显示相应的语言。例如，英语中的货币将显示为 $1.50，但法语中的货币会显示为 1,50$。