PlaylistItems

playlistItem 资源用于标识播放列表中包含的其他资源，例如视频。此外，playlistItem 资源还包含所含资源的详细信息，这些资源与资源在该播放列表中的使用方式相关。

YouTube 还使用播放列表来标识频道的已上传视频列表，其中列表中的每个 playlistItem 表示一个上传的视频。您可以从给定频道的 channel resource 中检索该列表的播放列表 ID。然后，您可以对该列表使用 playlistItems.list 方法。

方法

对于 playlistItems 资源，该 API 支持以下方法：

list

返回与 API 请求参数匹配的播放列表项集合。您可以检索指定播放列表中的所有播放列表项，也可以按唯一 ID 检索一个或多个播放列表项。立即试用。

insert

向播放列表添加资源。 立即试用。

update

修改播放列表项。例如，您可以更新项在播放列表中的位置。立即试用。

删除

删除播放列表项。 立即试用。

资源表示法

以下 JSON 结构显示了 playlistItems 资源的格式：

{
  "kind": "youtube#playlistItem",
  "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,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

属性

下表定义了此资源中显示的属性：

属性
kind	string 标识 API 资源的类型。其值为 youtube#playlistItem。
etag	etag 此资源的 Etag。
id	string YouTube 用来唯一标识播放列表项的 ID。
snippet	object snippet 对象包含播放列表项的基本详情，例如其标题和播放列表中的位置。
snippet.publishedAt	datetime 将此内容添加到播放列表的日期和时间。该值以 ISO 8601 格式指定。
snippet.channelId	string YouTube 用来唯一标识将项添加到播放列表的用户的 ID。
snippet.title	string 商品的名称。
snippet.description	string 商品的说明。
snippet.thumbnails	object 与播放列表项相关联的缩略图图片的映射图。对于地图中的每个对象，键是缩略图图片的名称，值是包含有关缩略图的其他信息的对象。
snippet.thumbnails.(key)	object 有效的键值对包括： default - 默认的缩略图图片。视频（或引用视频的资源，例如播放列表项或搜索结果）的默认缩略图宽 120 像素，高 90 像素。频道的默认缩略图宽 88 像素，高 88 像素。 medium – 更高分辨率版本的缩略图。对于视频（或引用视频的资源），该图片的宽度为 320 像素，高为 180 像素。对于频道，此图片宽 240 像素，高 240 像素。 high – 缩略图的高分辨率版本。对于视频（或引用视频的资源），该图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片宽 800 像素，高 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.videoOwnerChannelTitle	string 上传此视频的频道的频道标题。
snippet.videoOwnerChannelId	string 上传了此视频的频道的频道 ID。
snippet.playlistId	string YouTube 用来唯一标识播放列表项所在播放列表的 ID。
snippet.position	unsigned integer 相应项在播放列表中出现的顺序。该值使用从零开始的索引，因此第一项的位置为 0，第二项的位置为 1，依此类推。
snippet.resourceId	object id 对象包含的信息可用于对作为播放列表项包含在播放列表中的资源进行唯一标识。
snippet.resourceId.kind	string 所引用资源的种类或类型。
snippet.resourceId.videoId	string 如果 snippet.resourceId.kind 属性的值为 youtube#video，则此属性会显示，并且其值将包含 YouTube 用来对播放列表中的视频进行唯一标识的 ID。
contentDetails	object 如果包含的项是 YouTube 视频，则资源中会包含 contentDetails 对象。对象包含有关视频的其他信息。
contentDetails.videoId	string YouTube 用来对视频进行唯一标识的 ID。如需检索 video 资源，请在 API 请求中将 id 查询参数设置为此值。
contentDetails.startAt	string 注意：此属性已被弃用，如果设置了此属性，其值会被忽略。 视频应开始播放的时间（以秒为单位）。（当视频在播放列表环境中播放时，播放列表拥有者可指定视频开始和停止播放的时间。）默认值为 0。
contentDetails.endAt	string 注意：此属性已被弃用，如果设置了此属性，其值会被忽略。 视频应停止播放的时间（以秒计）。（当视频在播放列表环境中播放时，播放列表拥有者可指定视频开始和停止播放的时间。）默认情况下，假设 video.endTime 为视频结尾。
contentDetails.note	string 用户为此商品生成的备注。属性值的长度上限为 280 个字符。
contentDetails.videoPublishedAt	datetime 视频发布到 YouTube 的日期和时间。该值以 ISO 8601 格式指定。
status	object status 对象包含有关播放列表项隐私状态的信息。
status.privacyStatus	string 播放列表项的隐私状态。上传了播放列表项所代表的视频的频道可以使用 videos.insert 或 videos.update 方法设置此值。