Activities

activity 리소스에는 특정 채널이나 사용자가 YouTube에서 실행한 작업의 정보가 포함되어 있습니다. 활동 피드로 보고되는 작업에는 동영상 평가, 동영상 공유, 동영상을 즐겨찾기에 추가, 동영상에 댓글 달기, 동영상 업로드 등이 있습니다. 각 activity 리소스를 통해 작업의 유형, 작업에 연결된 채널, 평가되거나 업로드된 동영상 등의 작업을 확인할 수 있습니다.

메소드

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

list: 요청 기준과 일치하는 채널 활동 이벤트의 목록을 반환합니다. 예를 들어 특정 채널과 관련된 이벤트, 사용자의 구독정보 및 Google+ 친구 또는 사용자별로 맞춤 설정되는 YouTube 홈페이지 피드와 관련된 이벤트를 검색할 수 있습니다. 지금 사용해 보세요.
insert: 특정 채널의 게시판을 올립니다. (요청을 제출하는 사용자에게 채널을 대신하여 작업할 수 있는 권한이 부여되어야 합니다.)

참고: activity 리소스에 사용자의 동영상 평가 또는 동영상을 즐겨찾기에 추가 같은 작업 정보를 포함시킬 수도 있지만, 이러한 activity 리소스를 생성하려면 다른 API 메소드를 사용해야 합니다. 예를 들어 API의 videos.rate() 메소드를 사용해 동영상을 평가하고 playlistItems.insert() 메소드를 사용해 동영상을 즐겨찾기에 추가할 수 있습니다.

지금 사용해 보세요.

리소스 표현

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

{
  "kind": "youtube#activity",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "type": string,
    "groupId": string
  },
  "contentDetails": {
    "upload": {
      "videoId": string
    },
    "like": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "favorite": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      }
    },
    "comment": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      }
    },
    "subscription": {
      "resourceId": {
        "kind": string,
        "channelId": string,
      }
    },
    "playlistItem": {
      "resourceId": {
        "kind": string,
        "videoId": string,
      },
      "playlistId": string,
      "playlistItemId": string
    },
    "recommendation": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
      },
      "reason": string,
      "seedResourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "bulletin": {
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      }
    },
    "social": {
      "type": string,
      "resourceId": {
        "kind": string,
        "videoId": string,
        "channelId": string,
        "playlistId": string
      },
      "author": string,
      "referenceUrl": string,
      "imageUrl": string
    },
    "channelItem": {
      "resourceId": {
      }
    },
  }
}

속성

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

속성 이름
`kind`	`string` API 리소스의 유형입니다. 값은 `youtube#activity`가 됩니다.
`etag`	`etag` 이 리소스의 Etag입니다.
`id`	`string` YouTube가 활동을 고유하게 식별하는 데 사용하는 ID입니다.
`snippet`	`object` `snippet` 개체는 활동의 유형 및 그룹 ID 등 활동에 대한 기본 세부정보를 포함합니다.
`snippet.publishedAt`	`datetime` 활동이 발생한 날짜 및 시간입니다. 값은 ISO 8601(`YYYY-MM-DDThh:mm:ss.sZ`) 형식으로 지정됩니다.
`snippet.channelId`	`string` YouTube가 활동에 연결된 채널을 고유하게 식별하는 데 사용하는 ID입니다.
`snippet.title`	`string` 활동과 주로 연결된 리소스의 제목입니다.
`snippet.description`	`string` 활동과 주로 연결된 리소스의 설명입니다.
`snippet.thumbnails`	`object` 활동과 주로 연결된 리소스에 연결된 미리보기 이미지 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
`snippet.thumbnails.(key)`	`object` 유효한 키 값은 다음과 같습니다. `default` – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다. `medium` – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다. `high` – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
`snippet.thumbnails.(key).url`	`string` 이미지의 URL입니다.
`snippet.thumbnails.(key).width`	`unsigned integer` 이미지의 너비입니다.
`snippet.thumbnails.(key).height`	`unsigned integer` 이미지의 높이입니다.
`snippet.channelTitle`	`string` 이 활동에 책임이 있는 채널의 채널 제목입니다.
`snippet.type`	`string` 리소스가 설명하는 활동의 유형입니다. 이 속성에 유효한 값은 다음과 같습니다. `bulletin` `channelItem` `comment` `favorite` `like` `playlistItem` `recommendation` `social` `subscription` `upload`
`snippet.groupId`	`string` 활동에 관련된 그룹 ID입니다. 그룹 ID는 같은 사용자 및 리소스에 연결된 사용자 이벤트를 식별합니다. 예를 들어 사용자가 동영상을 평가하고 같은 동영상을 즐겨찾기에 추가하는 경우 이벤트 항목은 사용자의 활동 피드에 같은 그룹 ID를 갖게 됩니다. 사용자 인터페이스에서 같은 `groupId` 값으로 이벤트를 그룹으로 묶어서 반복을 피할 수 있습니다.
`contentDetails`	`object` `contentDetails` 개체는 활동에 연결된 콘텐츠에 대한 정보를 포함합니다. 예를 들어 `snippet.type` 값이 `videoRated`인 경우 `contentDetails` 개체의 콘텐츠는 평가된 동영상을 식별합니다.
`contentDetails.upload`	`object` `upload` 개체는 업로드한 동영상에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `upload`인 경우에만 존재합니다.
`contentDetails.upload.videoId`	`string` YouTube가 업로드한 동영상을 고유하게 식별하는 데 사용하는 ID입니다.
`contentDetails.like`	`object` `like` 개체는 추천(좋아요) 평가를 받은 리소스에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `like`인 경우에만 존재합니다.
`contentDetails.like.resourceId`	`object` `resourceId` 개체는 평가된 리소스를 식별하는 정보를 포함합니다.
`contentDetails.like.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.like.resourceId.videoId`	`string` 평가된 리소스가 동영상인 경우 YouTube가 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#video`인 경우에만 존재합니다.
`contentDetails.favorite`	`object` `favorite` 개체는 즐겨찾기에 등록한 동영상에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `favorite`인 경우에만 존재합니다.
`contentDetails.favorite.resourceId`	`object` `resourceId` 개체는 즐겨찾기에 등록한 리소스를 식별하는 정보를 포함합니다.
`contentDetails.favorite.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.favorite.resourceId.videoId`	`string` YouTube가 즐겨찾는 동영상을 고유하게 식별하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#video`인 경우에만 존재합니다.
`contentDetails.comment`	`object` `comment` 개체는 댓글이 달린 리소스에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `comment`인 경우에만 존재합니다.
`contentDetails.comment.resourceId`	`object` `resourceId` 개체는 댓글이 연결된 리소스를 식별하는 정보를 포함합니다.
`contentDetails.comment.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.comment.resourceId.videoId`	`string` YouTube가 댓글이 연결된 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#video`인 경우에만 존재합니다.
`contentDetails.comment.resourceId.channelId`	`string` YouTube가 댓글이 연결된 채널을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#channel`인 경우에만 존재합니다.
`contentDetails.subscription`	`object` `subscription` 개체는 사용자가 구독한 채널에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `subscription`인 경우에만 존재합니다.
`contentDetails.subscription.resourceId`	`object` `resourceId` 개체는 사용자가 구독한 리소스를 식별하는 정보를 포함합니다.
`contentDetails.subscription.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.subscription.resourceId.channelId`	`string` YouTube가 사용자가 구독한 채널을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#channel`인 경우에만 존재합니다.
`contentDetails.playlistItem`	`object` `playlistItem` 개체는 새 재생목록 항목에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `playlistItem`인 경우에만 존재합니다.
`contentDetails.playlistItem.resourceId`	`object` `resourceId` 개체는 재생목록에 추가된 리소스를 식별하는 정보를 포함합니다.
`contentDetails.playlistItem.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.playlistItem.resourceId.videoId`	`string` YouTube가 재생목록에 추가된 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#video`인 경우에만 존재합니다.
`contentDetails.playlistItem.playlistId`	`string` YouTube가 재생목록을 고유하게 식별하는 데 사용하는 값입니다.
`contentDetails.playlistItem.playlistItemId`	`string` YouTube가 재생목록의 항목을 고유하게 식별하기 위해 사용하는 값입니다.
`contentDetails.recommendation`	`object` `recommendation` 개체는 추천된 리소스에 대한 정보를 포함합니다. 이 속성은 `snippet.type`이 `recommendation`인 경우에만 존재합니다.
`contentDetails.recommendation.resourceId`	`object` `resourceId` 개체는 추천된 리소스를 식별하는 정보를 포함합니다.
`contentDetails.recommendation.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.recommendation.resourceId.videoId`	`string` 추천된 리소스가 동영상인 경우 YouTube가 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#video`인 경우에만 존재합니다.
`contentDetails.recommendation.resourceId.channelId`	`string` 추천된 리소스가 채널인 경우 YouTube가 채널을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `resourceId.kind`가 `youtube#channel`인 경우에만 존재합니다.
`contentDetails.recommendation.reason`	`string` 리소스가 사용자에게 추천된 이유입니다. 이 속성에 유효한 값은 다음과 같습니다. `unspecified` `videoFavorited` `videoLiked` `videoWatched`
`contentDetails.recommendation.seedResourceId`	`object` `seedResourceId` 개체는 맞춤 동영상을 표시하게 된 원인 리소스에 대한 정보를 포함합니다.
`contentDetails.recommendation.seedResourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.recommendation.seedResourceId.videoId`	`string` 특정 동영상 때문에 맞춤 동영상이 표시된 경우 YouTube가 이 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `seedResourceId.kind`가 `youtube#video`인 경우에만 존재합니다.
`contentDetails.recommendation.seedResourceId.channelId`	`string` 특정 채널 때문에 맞춤 동영상이 표시된 경우 YouTube가 이 채널을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `seedResourceId.kind`가 `youtube#channel`인 경우에만 존재합니다.
`contentDetails.recommendation.seedResourceId.playlistId`	`string` 특정 재생목록 때문에 맞춤 동영상이 표시된 경우 YouTube가 이 재생목록을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `seedResourceId.kind`가 `youtube#playlist`인 경우에만 존재합니다.
`contentDetails.bulletin`	`object` `bulletin` 개체는 채널 게시판 게시물에 대한 세부정보를 포함합니다. 이 개체는 `snippet.type`이 `bulletin`인 경우에만 존재합니다.
`contentDetails.bulletin.resourceId`	`object` `resourceId` 개체는 게시판 게시물에 연결된 리소스를 식별하는 정보를 포함합니다.
`contentDetails.bulletin.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.bulletin.resourceId.videoId`	`string` 게시물이 동영상을 참조하는 경우 YouTube가 게시판 게시물에 추천된 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `bulletin.resourceId.kind` 속성의 값이 `youtube#video`인 경우에만 존재합니다.
`contentDetails.bulletin.resourceId.channelId`	`string` 게시물이 채널을 참조하는 경우 YouTube가 게시판 게시물에 추천된 채널을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `bulletin.resourceId.kind` 속성의 값이 `youtube#channel`인 경우에만 존재합니다.
`contentDetails.bulletin.resourceId.playlistId`	`string` 게시물이 재생목록을 참조하는 경우 YouTube가 게시판 게시물에 추천된 재생목록을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `bulletin.resourceId.kind` 속성의 값이 `youtube#playlist`인 경우에만 존재합니다.
`contentDetails.social`	`object` `social` 개체는 소셜 네트워크 소식에 대한 세부정보를 포함합니다. 이 속성은 `snippet.type`이 `social`인 경우에만 존재합니다.
`contentDetails.social.type`	`string` 소셜 네트워크의 이름입니다. 이 속성에 유효한 값은 다음과 같습니다. `facebook` `googlePlus` `twitter` `unspecified`
`contentDetails.social.resourceId`	`object` `resourceId` 개체는 소셜 네트워크 소식에 연결된 리소스를 식별하는 정보를 요약합니다.
`contentDetails.social.resourceId.kind`	`string` API 리소스의 유형입니다.
`contentDetails.social.resourceId.videoId`	`string` 소식이 동영상을 참조하는 경우 YouTube가 소셜 네트워크 소식에 추천된 동영상을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `social.resourceId.kind` 속성의 값이 `youtube#video`인 경우에만 존재합니다.
`contentDetails.social.resourceId.channelId`	`string` 소식이 채널을 참조하는 경우 YouTube가 소셜 네트워크 소식에 추천된 채널을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `social.resourceId.kind` 속성의 값이 `youtube#channel`인 경우에만 존재합니다.
`contentDetails.social.resourceId.playlistId`	`string` 소식이 재생목록을 참조하는 경우 YouTube가 소셜 네트워크 소식에 추천된 재생목록을 고유하게 식별하는 데 사용하는 ID입니다. 이 속성은 `social.resourceId.kind` 속성의 값이 `youtube#playlist`인 경우에만 존재합니다.
`contentDetails.social.author`	`string` 소셜 네트워크 소식의 작성자입니다.
`contentDetails.social.referenceUrl`	`string` 소셜 네트워크 소식의 URL입니다.
`contentDetails.social.imageUrl`	`string` 소식 작성자의 이미지입니다.
`contentDetails.channelItem`	`object` `channelItem` 개체는 채널에 추가된 리소스에 대한 세부정보를 포함합니다. 이 속성은 `snippet.type`이 `channelItem`인 경우에만 존재합니다.
`contentDetails.channelItem.resourceId`	`object` `resourceId` 개체는 채널에 추가된 리소스를 식별하는 정보를 포함합니다.