YouTube에서 Shorts 동영상의 조회수를 집계하는 방식에 맞게 Data API를 업데이트하고 있습니다.
자세히 알아보기
MembershipsLevels
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
참고: 이 엔드포인트는 채널 멤버십이 사용 설정된 자체 YouTube 채널을 요청하는 개별 크리에이터만 사용할 수 있습니다. Google 또는 YouTube 담당자에게 문의하여 액세스 권한을 요청하세요.
membershipsLevel
리소스는 API 요청을 승인한 크리에이터가 관리하는 가격 책정 수준을 식별합니다.
메서드
API는 membershipsLevel
리소스에 대해 다음 메서드를 지원합니다.
- list
- 요청을 승인한 채널의 멤버십 등급을 나열합니다.
속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
속성 |
kind |
string
API 리소스의 유형을 식별합니다. 값은 youtube#membershipsLevel 입니다. |
etag |
etag
이 리소스의 Etag입니다. |
id |
string
YouTube에서 멤버십 등급을 고유하게 식별하기 위해 할당하는 ID입니다. 이 값은 수준의 표시 이름이 변경되더라도 변경되지 않습니다. |
snippet |
object
snippet 객체에는 멤버십 등급에 관한 세부정보가 포함됩니다. |
snippet.creatorChannelId |
string
가격대를 소유한 크리에이터의 YouTube 채널 ID입니다. |
snippet.levelDetails |
object
이 객체에는 멤버십 등급에 관한 데이터가 포함됩니다. |
snippet.levelDetails.displayName |
string
레벨의 표시 이름입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[],["The `membershipsLevel` resource identifies pricing levels for a channel's memberships. Creators can use the `list` method to retrieve these levels via the API. Each level includes a unique `id`, `etag`, `kind`, and a `snippet` object. The `snippet` details the `creatorChannelId` and `levelDetails`. `levelDetails` contains the `displayName` for that specific membership level. The API access is restricted to individual creators of channel-membership enabled YouTube channels.\n"],null,["# MembershipsLevels\n\nNote: This endpoint can only be used by individual creators to make requests for their own, channel-memberships-enabled YouTube channel. Reach out to your Google or YouTube representative to request access.\n\nA **membershipsLevel** resource identifies a pricing level managed\nby the creator that authorized the API request.\n\nMethods\n-------\n\nThe API supports the following methods for `membershipsLevel` resources:\n\n[list](/youtube/v3/docs/membershipsLevels/list)\n: Lists membership levels for the channel that authorized the request.\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `membershipsLevel` resource: \n\n```text\n{\n \"kind\": \"youtube#membershipsLevel\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"creatorChannelId\": string,\n \"levelDetails\": {\n \"displayName\": string,\n }\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#membershipsLevel`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube assigns to uniquely identify the membership level. This value will not change even if the level's display name changes. |\n| `snippet` | `object` The `snippet` object contains details about the membership level. |\n| snippet.`creatorChannelId` | `string` The YouTube channel ID of the creator that owns the pricing level. |\n| snippet.`levelDetails` | `object` This object contains data about the membership level. |\n| snippet.levelDetails.`displayName` | `string` The level's display name. |"]]