Members

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

다음 액세스 제한사항이 적용됩니다.

  • members 및 membershipsLevels 엔드포인트에 대한 액세스는 전담 YouTube 파트너 관리자가 있는 YouTube 크리에이터로 제한됩니다.
  • 액세스 권한은 채널 수준에서 부여됩니다. 이러한 채널 수준 허용 목록으로 인해 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,
        }
      ]
    }
  }
}

속성

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

속성
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입니다. 이 값 은 id 속성 값에 해당하는 membershipsLevel 리소스입니다.
snippet.membershipsDetails.highestAccessibleLevelDisplayName string
회원 채널이 현재 액세스할 수 있는 가장 높은 멤버십 등급의 이름입니다. 이 값은 displayName 리소스의 membershipsLevel 속성 값에 해당합니다.
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입니다. 이 값은 id 리소스의 membershipsLevel 속성 값에 해당합니다.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince datetime
회원이 지정된 멤버십 등급에 액세스할 수 있었던 날짜 및 시간입니다. 즉, 회원은 이 날짜와 시간 이후로 해당 등급에 계속 액세스할 수 있었습니다. 멤버십의 기간은 더 높은 멤버십 등급에 따라 다를 수 있습니다.
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths integer
사용자가 지정된 등급에 액세스할 수 있었던 기간(개월 수)을 가장 가까운 정수로 반올림한 값입니다. 이 값은 회원이 해당 등급에 액세스할 수 있었던 전체 개월 수를 반영하지만, 회원이 해당 개월 수 동안 멤버십을 계속 유지했다는 의미는 아닙니다.