Members

참고: 2020년 3월 31일부터 members 엔드포인트가 sponsors 엔드포인트를 대체합니다. 이 엔드포인트는 현재 지원 중단되었으며 2020년 9월 30일부터 더 이상 지원되지 않습니다. API 클라이언트는 members.list 메서드를 대신 사용하도록 sponsors.list 메서드 호출을 업데이트해야 합니다.

이 엔드포인트는 개인 크리에이터가 자신의 채널 멤버십이 사용 설정된 YouTube 채널을 요청하는 데만 사용할 수 있습니다. Google 또는 YouTube 담당자에게 문의하여 액세스 권한을 요청하세요.

member 리소스는 YouTube 채널의 채널 회원을 나타냅니다. 회원은 크리에이터에게 금전적 후원을 반복적으로 제공하며 특별한 혜택을 받습니다. 예를 들어 크리에이터가 채팅에 회원 전용 모드를 사용 설정하면 회원이 채팅할 수 있습니다.

방법

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,
        }
      ]
    }
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
kind string
API 리소스 유형을 식별합니다. 값은 youtube#member입니다.
etag etag
이 리소스의 Etag입니다.
snippet object
snippet 객체에는 구성원에 대한 세부정보가 포함됩니다.
snippet.creatorChannelId string
멤버십을 제공하는 크리에이터의 YouTube 채널 ID입니다.
snippet.memberDetails object
이 객체에는 멤버십 요금을 지불하는 YouTube 채널에 대한 프로필 데이터가 포함됩니다.

채널에 프로필 데이터를 사용할 수 없는 회원이 있을 수 있습니다. 예를 들어 채널을 삭제했지만 여전히 멤버십 비용을 지불하고 있는 회원에게 이러한 상황이 발생합니다. 이러한 회원은 멤버십 혜택을 계속 이용할 수 있습니다.

API 응답에는 memberDetails 객체 내 프로필 세부정보가 설정되지 않은 경우에도 정확한 집계를 위해 이러한 구성원용 리소스가 포함되어 있습니다. 이러한 구성원에게는 membershipsDetails가 계속 제공됩니다.
snippet.memberDetails.channelId string
회원 채널의 YouTube 채널 ID입니다. 설정된 경우 채널 ID는 회원의 고유 식별자로도 처리될 수 있습니다. 설정되지 않은 경우 구성원을 고유하게 식별할 수 없지만 리소스는 구성원이 액세스할 수 있는 등급 및 멤버십 기간과 같은 멤버십 세부정보를 계속 전달합니다.
snippet.memberDetails.channelUrl string
채널의 URL입니다.
snippet.memberDetails.displayName string
채널의 표시 이름입니다.
snippet.memberDetails.profileImageUrl string
채널의 아바타 URL입니다.
snippet.membershipsDetails object
이 객체에는 회원 채널의 멤버십 세부정보가 포함됩니다.
snippet.membershipsDetails.highestAccessibleLevel string
회원 채널에서 현재 액세스할 수 있는 가장 높은 멤버십 등급의 ID입니다. 이 값은 membershipsLevel 리소스의 id 속성 값에 해당합니다.
snippet.membershipsDetails.highestAccessibleLevelDisplayName string
회원 채널에서 현재 이용할 수 있는 가장 높은 멤버십 등급의 이름입니다. 이 값은 membershipsLevel 리소스의 displayName 속성 값에 해당합니다.
snippet.membershipsDetails.accessibleLevels[] list (of strings)
사용자가 현재 액세스할 수 있는 모든 멤버십 등급의 ID 목록입니다. 목록에는 현재 활성 층과 그 아래의 모든 층이 포함됩니다.
snippet.membershipsDuration object
이 객체에는 가격 책정 수준과 관계없이 현재 구성원의 전체 멤버십 기간에 대한 정보가 포함됩니다. 그러면 snippet.membershipsDetails.membershipsDurationAtLevel[] 속성에 구성원이 특정 멤버십 등급에 대한 액세스 권한을 가졌던 멤버십 기간에 대한 세부정보가 포함된 객체 목록이 포함됩니다.

다음 예는 이러한 속성의 작동 방식을 보여줍니다. 회원은 1월에 멤버십 등급 1로 새 멤버십을 구매하여 3월까지 보유하게 됩니다. 4월과 5월에는 구성원에게 멤버십이 없습니다. 6월에 이 회원은 멤버십을 다시 등급 1로 다시 시작합니다. 그리고 8월에 멤버십을 등급 2로 업그레이드합니다. 따라서 API 호출이 10월에 이루어진 경우 member 리소스에는 다음이 포함됩니다. 
"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
    },
  ]
}
snippet.membershipsDuration.memberSince datetime
회원의 현재 멤버십이 시작된 날짜 및 시간입니다. 즉, 이 날짜 및 시간 이후로 구성원이 지속적으로 멤버십을 가지고 있었습니다. 멤버십 기간은 멤버십 등급에 따라 사용 기간이 다를 수 있습니다.
snippet.membershipsDuration.memberTotalDurationMonths integer
사용자가 회원으로 활동한 개월 수(가장 가까운 정수로 반내림)입니다. 이 값은 회원이 멤버십을 보유한 전체 개월 수를 반영하지만 이 숫자는 회원이 그 기간 동안 멤버십을 유지했다는 의미는 아닙니다.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[] list (of objects)
객체 목록으로, 각 객체에는 구성원이 특정 멤버십 등급에 대한 액세스 권한을 가졌던 멤버십 기간에 대한 세부정보가 포함됩니다. 이 목록에는 구성원이 현재 액세스할 수 있는 멤버십 등급별로 객체가 하나씩 포함됩니다.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level string
멤버십 등급 ID입니다. 이 값은 membershipsLevel 리소스의 id 속성 값에 해당합니다.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince datetime
회원이 특정 멤버십 등급에 액세스할 수 있었던 날짜 및 시간입니다. 즉, 구성원은 이 날짜 및 시간부터 지속적으로 등급에 액세스할 수 있었습니다. 더 높은 멤버십 수준에서 지출된 멤버십 기간이 다를 수 있습니다.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths integer
사용자가 지정된 수준에 액세스할 수 있었던 개월 수를 가장 가까운 정수로 내림합니다. 이 값은 회원이 등급에 액세스할 수 있었던 개월 수를 반영하지만 이 숫자는 해당 개월 동안 지속적으로 멤버십을 유지했다는 의미는 아닙니다.