Activities

YouTube 已弃用频道公告功能。activities.list 方法仍不会返回频道公告,且 activities.insert 方法不再受支持。如需了解详情,请参阅 YouTube 帮助中心

activity 资源包含特定频道或用户在 YouTube 上采取的操作的相关信息。活动 Feed 中报告的操作包括对视频评分、分享视频、将视频标记为收藏、上传视频等。每个 activity 资源都标识了操作类型、与操作相关联的频道以及与操作相关联的资源,例如已评分或上传的视频。

方法

对于 activities 资源,该 API 支持以下方法:

list
返回符合请求条件的频道活动事件列表。例如,您可以检索与特定频道或用户自己的频道相关联的事件。立即试用

不再支持 activities.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
      }
    },
    "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
主要与 activity 关联的资源的标题。
snippet.description string
主要与 activity 关联的资源的说明。
snippet.thumbnails object
与主要与 activity 相关联的资源关联的缩略图的映射。对于映射中的每个对象,键都是缩略图的名称,其值是包含有关缩略图的其他信息的对象。
snippet.thumbnails.(key) object
有效的键值对包括:
  • default - 默认缩略图。视频(或引用视频的资源,例如播放列表项或搜索结果)的默认缩略图为 120 像素宽 90 像素高。频道的默认缩略图为 88 像素宽 88 像素高。
  • medium – 更高分辨率版本的缩略图。对于视频(或引用视频的资源),此图片的宽度为 320 像素,高度为 180 像素。对于频道,此图片的宽度为 240 px,高度为 240 px。
  • high - 缩略图的高分辨率版本。对于视频(或引用视频的资源),此图片的宽度为 480 像素,高度为 360 像素。对于频道,此图片的宽度为 800 px,高度为 800 px。
  • standard - 缩略图的分辨率甚至高于 high 分辨率版本。此图片适用于某些视频和其他资源(例如播放列表项或搜索结果)显示。此图片的宽度为 640 px,高度为 480 px。
  • maxres - 缩略图的最高分辨率版本。此图片大小适用于某些视频和其他资源(例如播放列表项或搜索结果),此图片的宽度为 1280 px,高度为 720 px。
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
  • bulletin (已弃用)
snippet.groupId string
与活动相关联的组 ID。群组 ID 用于标识与同一用户和资源相关联的用户事件。例如,如果用户对某个视频进行了评分并将同一视频加入收藏,那么这些事件的条目会在用户的活动 Feed 中具有相同的组 ID。在您的界面中,您可以通过对具有相同 groupId 值的事件进行分组来避免重复。
contentDetails object
contentDetails 对象包含与 activity 关联的内容的信息。例如,如果 snippet.type 的值为 videoRated,则 contentDetails 对象的内容会标识已评分的视频。
contentDetails.upload object
upload 对象包含有关已上传视频的信息。仅当 snippet.typeupload 时,此属性才会存在。
contentDetails.upload.videoId string
YouTube 用来对上传的视频进行唯一标识的 ID。
contentDetails.like object
like 对象包含获得好评(顶)的资源的相关信息。仅当 snippet.typelike 时,此属性才会存在。
contentDetails.like.resourceId object
resourceId 对象包含标识已评分资源的信息。
contentDetails.like.resourceId.kind string
API 资源的类型。
contentDetails.like.resourceId.videoId string
如果分级资源是视频,则 YouTube 用来唯一标识视频的 ID。仅当 resourceId.kindyoutube#video 时,此属性才会存在。
contentDetails.favorite object
favorite 对象包含与标记为收藏的视频有关的信息。仅当 snippet.typefavorite 时,此属性才会存在。
contentDetails.favorite.resourceId object
resourceId 对象包含的信息用于标识已标记为“收藏”的资源。
contentDetails.favorite.resourceId.kind string
API 资源的类型。
contentDetails.favorite.resourceId.videoId string
YouTube 用来唯一标识收藏视频的 ID。仅当 resourceId.kindyoutube#video 时,此属性才会显示。

注意activities.list 方法目前不会为新评论返回资源。
contentDetails.comment object
comment 对象包含收到评论的资源的相关信息。仅当 snippet.typecomment 时,此属性才会存在。
contentDetails.comment.resourceId object
resourceId 对象包含标识与评论关联的资源的信息。
contentDetails.comment.resourceId.kind string
API 资源的类型。
contentDetails.comment.resourceId.videoId string
YouTube 用来唯一标识与评论相关联的视频的 ID。仅当 resourceId.kindyoutube#video 时,此属性才会存在。
contentDetails.comment.resourceId.channelId string
YouTube 用来唯一标识与评论相关联的频道的 ID。仅当 resourceId.kindyoutube#channel 时,此属性才会存在。
contentDetails.subscription object
subscription 对象包含有关用户订阅的频道的信息。仅当 snippet.typesubscription 时,此属性才会存在。
contentDetails.subscription.resourceId object
resourceId 对象包含标识用户订阅的资源的信息。
contentDetails.subscription.resourceId.kind string
API 资源的类型。
contentDetails.subscription.resourceId.channelId string
YouTube 用于唯一标识用户所订阅频道的 ID。仅当 resourceId.kindyoutube#channel 时,此属性才会存在。
contentDetails.playlistItem object
playlistItem 对象包含有关新播放列表项的信息。仅当 snippet.typeplaylistItem 时,此属性才会存在。
contentDetails.playlistItem.resourceId object
resourceId 对象包含的信息用于标识已添加到播放列表的资源。
contentDetails.playlistItem.resourceId.kind string
API 资源的类型。
contentDetails.playlistItem.resourceId.videoId string
YouTube 用来唯一标识添加到播放列表中的视频的 ID。仅当 resourceId.kindyoutube#video 时,此属性才会存在。
contentDetails.playlistItem.playlistId string
YouTube 用来唯一标识播放列表的值。
contentDetails.playlistItem.playlistItemId string
YouTube 用来唯一标识播放列表中项的值。
contentDetails.recommendation object
recommendation 对象包含推荐资源的相关信息。仅当 snippet.typerecommendation 时,此属性才会存在。
contentDetails.recommendation.resourceId object
resourceId 对象包含标识推荐资源的信息。
contentDetails.recommendation.resourceId.kind string
API 资源的类型。
contentDetails.recommendation.resourceId.videoId string
YouTube 用来唯一标识视频的 ID(如果推荐资源是视频)。仅当 resourceId.kindyoutube#video 时,此属性才会存在。
contentDetails.recommendation.resourceId.channelId string
YouTube 用来唯一标识频道的 ID(如果推荐资源为频道)。仅当 resourceId.kindyoutube#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 会使用它来唯一标识相应视频。仅当 seedResourceId.kindyoutube#video 时,此属性才会存在。
contentDetails.recommendation.seedResourceId.channelId string
如果推荐是由特定频道引发的,则 YouTube 用来唯一标识频道的 ID。仅当 seedResourceId.kindyoutube#channel 时,此属性才会存在。
contentDetails.recommendation.seedResourceId.playlistId string
如果推荐是由某个特定播放列表引发的,则 YouTube 用来唯一标识播放列表的 ID。仅当 seedResourceId.kindyoutube#playlist 时,此属性才会存在。
contentDetails.social object
social 对象包含有关社交网络帖子的详细信息。仅当 snippet.typesocial 时,此属性才会存在。
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.typechannelItem 时,此属性才会存在。
contentDetails.channelItem.resourceId object
resourceId 对象包含的信息用于标识已添加到频道中的资源。