Sponsors

注意：此资源自 2020 年 3 月 31 日起已弃用。我们已将其替换为 member 资源。您可以在 YouTube Data API 文档中查看有关该资源的信息。

自弃用以来，2020 年 9 月 30 日当天或之后将不再支持 sponsors.list 方法。API 客户端应更新对 sponsors.list 方法的调用，以改用 members.list 方法。

sponsor 资源表示 YouTube 频道的频道会员（以前称为“赞助商”）。 会员可定期向创作者提供资金支持、获享特殊福利。例如，如果创作者启用了聊天的会员专享模式，会员就可以聊天。

方法

该 API 支持 sponsors 资源的以下方法：

list

列出频道的赞助商。API 请求必须由频道所有者授权。 立即试用。

资源表示法

以下 JSON 结构显示了 sponsors 资源的格式：

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

属性

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

属性
kind	string 标识 API 资源类型。值为 youtube#sponsor。
etag	etag 此资源的 Etag。
id	string YouTube 为唯一标识赞助者而分配的 ID。
snippet	object snippet 对象包含赞助者的详细信息。
snippet.channelId	string 此 ID 用于标识正在赞助的频道。
snippet.sponsorDetails	object 此对象包含赞助商的详细信息。
snippet.sponsorDetails.channelId	string YouTube 频道 ID。
snippet.sponsorDetails.channelUrl	string 频道的网址。
snippet.sponsorDetails.displayName	string 频道的显示名。
snippet.sponsorDetails.profileImageUrl	string 频道的头像网址。
snippet.sponsorSince	datetime 用户成为赞助者的日期和时间。该值采用 ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) 格式指定。