Groups

group 리소스는 최대 500개의 채널, 동영상, 재생목록 또는 저작물로 구성된 맞춤 컬렉션인 YouTube 분석 그룹을 나타냅니다.

그룹의 모든 항목은 동일한 유형의 리소스를 나타내야 합니다. 예를 들어 동영상 100개와 재생목록 100개가 포함된 그룹은 만들 수 없습니다.

애널리틱스 그룹에는 내가 업로드했거나 소유권을 주장했거나 내가 관리하는 채널에 연결된 리소스만 포함할 수 있습니다. 따라서 채널 소유자는 동영상 및 재생목록 그룹을 만들 수 있습니다. 콘텐츠 소유자는 동영상, 재생목록, 채널 또는 저작물 그룹을 만들 수 있습니다.

메서드

API는 groups 리소스에 다음 메서드를 지원합니다.

list
API 요청 매개변수와 일치하는 그룹 목록을 반환합니다. 예를 들어 인증된 사용자가 소유한 모든 그룹을 검색하거나, 고유 ID를 기준으로 하나 이상의 그룹을 검색할 수 있습니다. 지금 사용해보기
insert
YouTube 분석 그룹을 만듭니다. 그룹을 만든 후 groupItems.insert 메서드를 사용하여 그룹에 항목을 추가합니다. 지금 사용해 보세요.
업데이트
그룹의 메타데이터를 수정합니다. 현재 업데이트할 수 있는 속성은 그룹의 제목뿐입니다. groupItems.insert 및 groupItems.delete를 사용하여 그룹 항목을 추가 및 삭제합니다. 지금 사용해 보기
삭제
그룹을 삭제합니다. 지금 사용해보기

리소스 표현

아래 JSON 구조는 groups 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

속성

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

속성
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