Groups
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
group
리소스는 최대 500개의 채널, 동영상, 재생목록 또는 저작물로 구성된 맞춤 컬렉션인 YouTube 분석 그룹을 나타냅니다.
그룹의 모든 항목은 동일한 유형의 리소스를 나타내야 합니다. 예를 들어 동영상 100개와 재생목록 100개가 포함된 그룹은 만들 수 없습니다.
애널리틱스 그룹에는 내가 업로드했거나 소유권을 주장했거나 내가 관리하는 채널에 연결된 리소스만 포함할 수 있습니다. 따라서 채널 소유자는 동영상 및 재생목록 그룹을 만들 수 있습니다. 콘텐츠 소유자는 동영상, 재생목록, 채널 또는 저작물 그룹을 만들 수 있습니다.
속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
속성 |
kind |
string
API 리소스의 유형을 식별합니다. 값은 youtube#group 입니다. |
etag |
etag
이 리소스의 Etag입니다. |
id |
string YouTube에서 그룹을 고유하게 식별하는 데 사용하는 ID입니다. |
snippet |
object
snippet 객체에는 생성일 및 이름을 비롯한 그룹에 관한 기본 정보가 포함됩니다. |
snippet.publishedAt |
datetime
그룹이 생성된 날짜 및 시간입니다. 값은 ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ ) 형식으로 지정됩니다. |
snippet.title |
string
그룹 이름입니다. 값은 비어 있지 않은 문자열이어야 합니다. |
contentDetails |
object
contentDetails 객체에는 그룹에 포함된 항목의 수 및 유형과 같은 그룹에 관한 추가 정보가 포함되어 있습니다. |
contentDetails.itemCount |
unsigned long
그룹의 항목 수입니다. |
contentDetails.itemType |
string
그룹에 포함된 리소스의 유형입니다.
이 속성의 유효한 값은 다음과 같습니다.
youtube#channel
youtube#playlist
youtube#video
youtubePartner#asset
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eA YouTube Analytics group is a custom collection of up to 500 channels, videos, playlists, or assets, all of the same resource type.\u003c/p\u003e\n"],["\u003cp\u003eYou can create, retrieve, update, and delete groups using the YouTube Analytics API methods.\u003c/p\u003e\n"],["\u003cp\u003eGroups can only contain resources that you own, have claimed, or are linked to a channel you administer.\u003c/p\u003e\n"],["\u003cp\u003eThe group resource representation includes information such as the group's ID, title, creation date, item count, and item type.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003egroupItems\u003c/code\u003e methods to manage the individual items within a group.\u003c/p\u003e\n"]]],["YouTube Analytics groups are custom collections of up to 500 channels, videos, playlists, or assets of the same type. The API allows users to list, insert, update, and delete groups. Creating a group requires specifying the group's name. Updating a group only allows changing its title, while adding or removing items is handled through a separate method. Each group has an ID, creation date, and details about the number and type of contained items.\n"],null,["# Groups\n\nA **group** resource represents a YouTube Analytics group, which is a custom collection of up to 500 channels, videos, playlists, or assets. \n\nAll of the items in a group must represent the same type of resource. For example, you cannot create a group that contains 100 videos and 100 playlists. \n\nAn Analytics group can only contain resources that you have uploaded or claimed or that are linked to a channel that you administer. As a result, channel owners can create groups of videos and playlists. Content owners can create groups of videos, playlists, channels, or assets.\n\nMethods\n-------\n\nThe API supports the following methods for `groups` resources:\n\n[list](/youtube/analytics/reference/groups/list)\n: Returns a list of groups that match the API request parameters. For example, you can retrieve all groups that the authenticated user owns, or you can retrieve one or more groups by their unique IDs.\n [Try it now](/youtube/analytics/reference/groups/list#try-it).\n\n[insert](/youtube/analytics/reference/groups/insert)\n: Creates a YouTube Analytics group. After creating a group, use the [groupItems.insert](/youtube/analytics/reference/groupItems/insert) method to add items to the group.\n [Try it now](/youtube/analytics/reference/groups/insert#try-it).\n\n[update](/youtube/analytics/reference/groups/update)\n: Modifies the metadata for a group. Currently, the only property that can be updated is the group's title. (Use the [groupItems.insert](/youtube/analytics/reference/groupItems/insert) and [groupItems.delete](/youtube/analytics/reference/groupItems/delete) to add and remove group items.)\n [Try it now](/youtube/analytics/reference/groups/update#try-it).\n\n[delete](/youtube/analytics/reference/groups/delete)\n: Deletes a group.\n [Try it now](/youtube/analytics/reference/groups/delete#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `groups` resource: \n\n```text\n{\n \"kind\": \"youtube#group\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"publishedAt\": datetime,\n \"title\": string\n },\n \"contentDetails\": {\n \"itemCount\": unsigned long,\n \"itemType\": string\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#group`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the group. |\n| `snippet` | `object` The `snippet` object contains basic information about the group, including its creation date and name. |\n| snippet.`publishedAt` | `datetime` The date and time that the group was created. The value is specified in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) (`YYYY-MM-DDThh:mm:ss.sZ`) format. |\n| snippet.`title` | `string` The group name. The value must be a non-empty string. |\n| `contentDetails` | `object` The `contentDetails` object contains additional information about the group, such as the number and type of items that it contains. |\n| contentDetails.`itemCount` | `unsigned long` The number of items in the group. |\n| contentDetails.`itemType` | `string` The type of resources that the group contains. Valid values for this property are: - `youtube#channel` - `youtube#playlist` - `youtube#video` - `youtubePartner#asset` |"]]