Members

참고: 2020년 3월 31일부터 members 엔드포인트가 sponsors 엔드포인트를 대체합니다. sponsors 엔드포인트는 지원 중단되었으며 2020년 9월 30일 이후에는 더 이상 지원되지 않습니다. API 클라이언트는 sponsors.list 메서드 호출을 업데이트하여 members.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로 업그레이드합니다. 따라서 10월에 API 호출이 이루어지면 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
사용자가 지정된 수준에 액세스한 기간(가장 가까운 정수로 반올림)입니다. 이 값은 회원이 등급에 액세스한 전체 월 수를 반영하지만, 이 숫자가 회원이 해당 기간 동안 멤버십을 연속으로 보유했음을 의미하지는 않습니다.