Members

A member 资源表示 YouTube 频道的频道会员。会员会定期向创作者提供资金支持，并获得特殊 福利。例如，当创作者为聊天开启会员专享模式时，会员可以聊天。

以下访问权限限制适用：

• 只有拥有专属 YouTube 合作伙伴经理的 YouTube 创作者才能访问 members 和 membershipsLevels 端点。
• 访问权限是在频道级别授予的。由于这种频道级许可名单机制，youtube.channel-memberships.creator OAuth 范围不会经过标准的 Google Cloud OAuth 验证流程。

方法

该 API 支持以下 member 资源方法：

list

列出频道的会员（以前称为“赞助者”）。API 请求必须由 频道所有者授权。

资源表示法

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

{
  "kind": "youtube#member",
  "etag": etag,
  "snippet": {
    "creatorChannelId": string,
    "memberDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "membershipsDetails": {
      "highestAccessibleLevel": string,
      "highestAccessibleLevelDisplayName": string,
      "accessibleLevels": [
        string
      ],
      "membershipsDuration": {
        "memberSince": datetime,
        "memberTotalDurationMonths": integer,
      },
      "membershipsDurationAtLevel": [
        {
          "level": string,
          "memberSince": datetime,
          "memberTotalDurationMonths": integer,
        }
      ]
    }
  }
}

属性

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

"membershipsDetails": {
  "membershipsDuration": {
    "memberSince": "2020-06-01T12:00:00",
    "memberTotalDurationMonths": 7,
  },
  "membershipsDurationAtLevel": [
    {
      "level": "level_1_ID",
      "memberSince": "2020-06-01T12:00:00",
      "memberTotalDurationMonths": 7
    },
    {
      "level": "level_2_ID",
      "memberSince": "2020-08-01T12:00:00",
      "memberTotalDurationMonths": 2
    },
  ]
}