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 그룹에 포함된 리소스의 유형입니다. 이 속성에 유효한 값은 다음과 같습니다.
|