Activities

activity 리소스에는 특정 채널 또는 사용자가 YouTube에서 취한 조치에 관한 정보가 포함되어 있습니다. 활동 피드에 보고되는 활동에는 동영상 평가, 동영상 공유, 동영상을 즐겨찾기로 표시, 동영상 업로드 등이 포함됩니다. 각 activity 리소스는 작업 유형, 작업과 연결된 채널, 작업과 연결된 리소스(예: 평가되거나 업로드된 동영상)를 식별합니다.

메서드

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

list
요청 기준과 일치하는 채널 활동 이벤트 목록을 반환합니다. 예를 들어 특정 채널 또는 사용자의 자체 채널과 연결된 이벤트를 가져올 수 있습니다. 지금 사용해보기

리소스 표현

다음 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
      }
    },
    "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 형식으로 지정됩니다.
snippet.channelId string
YouTube가 활동과 연결된 채널을 고유하게 식별하는 데 사용하는 ID입니다.
snippet.title string
활동과 주로 연결된 리소스의 제목입니다.
snippet.description string
활동과 주로 연결된 리소스의 설명입니다.
snippet.thumbnails object
활동과 주로 연결된 리소스와 연결된 썸네일 이미지의 맵입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
snippet.thumbnails.(key) object
유효한 키 값은 다음과 같습니다.
  • default - 기본 썸네일 이미지입니다. 동영상 또는 동영상을 참조하는 리소스(예: 재생목록 항목 또는 검색 결과)의 기본 썸네일은 너비 120px, 높이 90px입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 320px이고 높이가 180px입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 480px이고 높이가 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
  • standard - high 해상도 이미지보다 훨씬 더 높은 해상도의 썸네일 이미지입니다. 이 이미지는 일부 동영상과 재생목록 항목, 검색 결과 등 동영상을 참조하는 기타 리소스에 사용할 수 있습니다. 이 이미지는 너비가 640px이고 높이가 480px입니다.
  • maxres: 썸네일 이미지의 최고 해상도 버전입니다. 이 이미지 크기는 일부 동영상과 재생목록 항목, 검색 결과 등 동영상을 참조하는 기타 리소스에 사용할 수 있습니다. 이 이미지는 너비가 1280px이고 높이가 720px입니다.
snippet.thumbnails.(key).url string
이미지의 URL입니다.
snippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
snippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.
snippet.channelTitle string
이 활동을 담당하는 채널의 채널 제목
snippet.type string
리소스가 설명하는 활동의 유형입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • channelItem
  • comment - (현재 반환되지 않음)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • 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인 경우에만 존재합니다.

참고: 현재 activities.list 메서드는 새 댓글의 리소스를 반환하지 않습니다.
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
사용자에게 리소스가 추천되는 이유입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • 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.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 객체에는 채널에 추가된 리소스를 식별하는 정보가 포함됩니다.