FanFundingEvents: list

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

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

列出某个频道的粉丝资助活动。API 请求必须由频道所有者授权。

请求

HTTP 请求

GET https://www.googleapis.com/youtube/v3/fanFundingEvents

授权

此请求需要获得以下至少一个范围的授权（详细了解身份验证和授权）。

范围
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

参数

下表列出了此查询支持的参数。列出的所有参数都是查询参数。

参数
必需参数
part string
part 参数用于指定 API 响应将包含的 fanFundingEvent 资源部分。支持的值为 id 和 snippet。
可选参数
hl string
hl 参数会指示 API 检索 YouTube 网站支持的特定应用语言的本地化货币显示字符串。例如，英语中，货币会显示为 $1.50，但法语中则会显示为 1,50$。

参数值必须是 i18nLanguages.list 方法返回的列表中包含的语言代码。
maxResults unsigned integer
maxResults 参数用于指定结果集中应返回的最大项数。可接受的值包括0到50（含 0 和 5000）。默认值为 5。
pageToken string
pageToken 参数用于标识结果集中请求 API 服务器返回的特定网页。在 API 响应中，nextPageToken 属性用于标识请求的下一页结果。

请求正文

调用此方法时请勿提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

{
  "kind": "youtube#fanFundingEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    fanFundingEvent resource
  ]
}

属性

下表定义了此资源中显示的属性：

属性
kind string
标识 API 资源类型。值为 youtube#fanFundingEventListResponse。
etag etag
此资源的 Etag。
nextPageToken string
可用作 pageToken 参数值以检索结果集中的下一页的令牌。
pageInfo object
pageInfo 对象用于封装结果集的分页信息。
pageInfo.totalResults integer
结果集中的结果总数。
pageInfo.resultsPerPage integer
API 响应中包含的结果数。
items[] list
符合请求条件的粉丝资助活动列表。

错误

下表列出了该 API 为响应对此方法的调用可能返回的错误消息。如需了解详情，请参阅错误消息文档。

错误类型 错误详情 说明
forbidden (403) insufficientPermissions 您没有查看频道的粉丝资助活动所需的权限。
invalidValue (400) fanFundingNotEnabledForChannelId 频道未启用粉丝资助功能。

试试看！

使用 API Explorer 针对实际数据调用此方法，并查看 API 请求和响应。