Activities

activity 资源包含有关特定频道或用户在 YouTube 上执行的操作的信息。活动 Feed 中报告的操作包括对视频评分、分享视频、将视频标记为收藏、上传视频等。每个 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 与主要关联到相应 activity 的资源相关联的缩略图的映射。对于地图中的每个对象，键是缩略图的名称，值是包含有关缩略图的其他信息的对象。
snippet.thumbnails.(key)	object 有效的键值包括： default - 默认缩略图。视频（或引用视频的资源，例如播放列表项或搜索结果）的默认缩略图宽度为 120 像素，高度为 90 像素。频道的默认缩略图宽度为 88 像素，高度为 88 像素。 medium - 缩略图的更高分辨率版本。对于视频（或引用视频的资源），此图片的宽度为 320 像素，高度为 180 像素。对于频道，此图片的宽度为 240 像素，高度为 240 像素。 high - 缩略图的高分辨率版本。对于视频（或引用视频的资源），此图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片的宽度和高度均为 800 像素。 standard - 比 high 分辨率的缩略图分辨率更高。此图片适用于某些视频以及引用视频的其他资源，例如播放列表项或搜索结果。此图片的宽度为 640 像素，高度为 480 像素。 maxres - 缩略图的最高分辨率版本。此图片尺寸适用于某些视频以及引用视频的其他资源，例如播放列表项或搜索结果。此图片的宽度为 1280 像素，高度为 720 像素。
snippet.thumbnails.(key).url	string 图片的网址。
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 用于标识与同一用户和资源相关联的用户事件。例如，如果用户对某个视频进行了评分，并将其标记为喜爱视频，那么用户活动 Feed 中相应事件的条目将具有相同的群组 ID。在界面中，您可以通过将具有相同 groupId 值的事件分组来避免重复。
contentDetails	object contentDetails 对象包含与 activity 相关联的内容的信息。例如，如果 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 社交网络帖子的网址。
contentDetails.social.imageUrl	string 帖子作者的图片。
contentDetails.channelItem	object channelItem 对象包含有关已添加到频道的资源的详细信息。仅当 snippet.type 为 channelItem 时，此属性才会存在。
contentDetails.channelItem.resourceId	object resourceId 对象包含用于标识已添加到频道的资源的信息。