Playlists

playlist 资源表示 YouTube 播放列表。播放列表是可以连续观看并与其他用户分享的一系列视频。默认情况下，播放列表是公开显示给其他用户的，但是播放列表可以设为公开或私享。

YouTube 还会使用播放列表标识频道的特殊视频合集，例如：

• 上传的视频
• 好评（赞过）的视频

更具体地说，这些列表与某个频道相关联，而频道是个人、团体或公司的视频、播放列表和其他 YouTube 信息的集合。您可以从指定频道的 channel resource 检索其中每个列表的播放列表 ID。

然后，您可以使用 playlistItems.list 方法来检索其中的任何列表。您还可以通过调用 playlistItems.insert 和 playlistItems.delete 方法向这些列表中添加项或从中移除项。

方法

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

list

返回与 API 请求参数匹配的播放列表集合。例如，您可以检索经过身份验证的用户拥有的所有播放列表，也可以按唯一 ID 检索一个或多个播放列表。 立即试用。

insert

创建播放列表。 立即试用。

update

修改播放列表。例如，您可以更改播放列表的标题、说明或隐私状态。 立即试用。

delete

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

资源表示法

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

{
  "kind": "youtube#playlist",
  "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,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string,
    "podcastStatus": enum
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

属性

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

属性
kind	string 标识 API 资源的类型。该值将为 youtube#playlist。
etag	etag 此资源的 Etag。
id	string YouTube 用来唯一标识播放列表的 ID。
snippet	object snippet 对象包含播放列表的基本详情，例如标题和说明。
snippet.publishedAt	datetime 播放列表的创建日期和时间。该值采用 ISO 8601 格式。
snippet.channelId	string YouTube 用于标识发布播放列表的频道的唯一标识符。
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.tags[]	list 此属性已弃用。 与播放列表相关联的关键字标签。
snippet.defaultLanguage	string playlist 资源的 snippet.title 和 snippet.description 属性中的文本语言。
snippet.localized	object snippet.localized 对象包含播放列表的本地化标题和说明，或者播放列表元数据的默认语言标题。 如果 playlists.list 请求使用 hl 参数来指定应返回哪些本地化文本的语言，并且该语言中有该语言的本地化文本，则系统会在资源代码段中返回本地化文本。 如果未指定 hl 参数值，或者指定了值但指定语言没有本地化元数据，则返回默认语言的元数据。 该属性包含只读值。使用 localizations 对象添加、更新或删除本地化商品名。
snippet.localized.title	string 本地化播放列表的标题。
snippet.localized.description	string 本地化的播放列表说明。
status	object status 对象包含播放列表的状态信息。
status.privacyStatus	string 播放列表的隐私状态。 此属性的有效值包括： <ph type="x-smartling-placeholder"> </ph> private public unlisted
status.podcastStatus	string 播放列表的播客状态。如果值为 enabled，则播放列表会被标记为播客节目。如需将播放列表的播客状态设置为 enabled，播放列表必须包含播放列表图片。 此属性的有效值包括： enabled disabled unspecified
contentDetails	object contentDetails 对象包含有关播放列表内容的信息，包括播放列表中的视频数量。
contentDetails.itemCount	unsigned integer 播放列表中的视频数量。
player	object player 对象包含您在嵌入式播放器中播放播放列表时会用到的信息。
player.embedHtml	string <iframe> 标记，用于嵌入将播放播放列表的播放器。
localizations	object localizations 对象用于封装播放列表元数据的翻译。
localizations.(key)	object 与键值关联的本地化文本的语言。该值是一个包含 BCP-47 语言代码的字符串。
localizations.(key).title	string 本地化播放列表的标题。
localizations.(key).description	string 本地化的播放列表说明。