Groups

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

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

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

방법

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

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