Logo
Section 1 / 3

playlists 资源:创建、更新和列出

了解播放列表资源及其如何用于创建、获取和修改 YouTube 播放列表的信息。

导入

playlists 资源:创建、更新和列出

了解播放列表资源及其如何用于创建、获取和修改 YouTube 播放列表的信息。

播放列表是 YouTube 上视频的集合。用户可以手动创建播放列表,也可以让 YouTube 通过识别特定频道中的不同类型视频(如喜欢的视频或上传的视频)自动生成播放列表。playlists 资源用于存储这些播放列表的相关信息。

在本课程中,我们将学习 playlists 资源,它提供了多种方法,如 list、insert、update 和 delete,可用于与 YouTube 上的播放列表进行交互。


代码示例

1https://www.googleapis.com/youtube/v3/playlists

请求参数

参数名类型必填/可选描述
part字符串必填此参数有两个作用:指定用户将设置的属性,以及指定 API 响应中包含的属性。可选值包括:contentDetails、id、localizations、player、snippet、status。
onBehalfOfContentOwner字符串可选用于标识已认证的用户正在代表内容所有者进行更改。
snippet.title字符串必填用于传递用户希望分配给播放列表的标题。
snippet.description字符串可选用于传递用户希望分配给播放列表的描述。
1import fetch from 'node-fetch'; 2 3const endpointUrl = new URL('https://www.googleapis.com/youtube/v3/playlists'); 4 5// 定义请求头参数 6const headerParameters = { 7 Authorization: 'Bearer {{ACCESS_TOKEN}}', 8 Accept: 'application/json', 9}; 10 11const queryParameters = new URLSearchParams({ 12 part: 'snippet', 13}); 14 15// 定义请求体参数 16const bodyParameters = JSON.stringify({ 17 snippet: { 18 channelId: '{{CHANNEL_ID}}', 19 title: '这是一个播放列表的示例标题', 20 description: '这是一个播放列表的示例描述', 21 }, 22}); 23 24const options = { 25 method: 'POST', 26 headers: headerParameters, 27 body: bodyParameters, 28}; 29 30async function createPlaylist() { 31 try { 32 endpointUrl.search = queryParameters; 33 const response = await fetch(endpointUrl, options); 34 printResponse(response); 35 } catch (error) { 36 printError(error); 37 } 38} 39 40createPlaylist();

响应字段

字段名类型描述
kind字符串反映 API 调用的资源类型。
etagETag包含资源的 ETag 标识。
id字符串包含正在更新的播放列表的 ID。
snippet.description字符串包含播放列表的描述。
snippet.title字符串包含播放列表的标题。
channelTitle字符串包含频道的标题。

代码示例

1https://www.googleapis.com/youtube/v3/playlists
1import fetch from 'node-fetch'; 2 3const endpointUrl = new URL('https://www.googleapis.com/youtube/v3/playlists'); 4 5// 定义请求头参数 6const headerParameters = { 7 Authorization: 'Bearer {{ACCESS_TOKEN}}', 8 Accept: 'application/json', 9}; 10 11const queryParameters = new URLSearchParams({ 12 part: 'snippet', 13}); 14 15// 定义请求体参数 16const bodyParameters = JSON.stringify({ 17 id: '{{PLAYLIST_ID}}', 18 snippet: { 19 channelId: '{{CHANNEL_ID}}', 20 title: '这是播放列表的更新标题', 21 description: '这是播放列表的更新描述', 22 }, 23}); 24 25const options = { 26 method: 'PUT', 27 headers: headerParameters, 28 body: bodyParameters, 29}; 30 31async function updatePlaylist() { 32 try { 33 endpointUrl.search = queryParameters; 34 const response = await fetch(endpointUrl, options); 35 printResponse(response); 36 } catch (error) { 37 printError(error); 38 } 39} 40 41updatePlaylist();

代码示例

1https://www.googleapis.com/youtube/v3/playlists

请求参数

参数名类型必填/可选描述
channelId字符串可选用于筛选特定频道的播放列表。
id字符串可选用于传递用户希望列出的播放列表 ID。
mine布尔值可选如果用户希望获取自己的播放列表,则使用此参数。
1// 导入所需库 2import fetch from 'node-fetch'; 3 4// 定义接口地址 5const endpointUrl = new URL('https://www.googleapis.com/youtube/v3/playlists'); 6 7// 定义请求头参数 8const headerParameters = { 9 Authorization: 'Bearer {{ACCESS_TOKEN}}', 10 Accept: 'application/json', 11}; 12 13// 定义查询参数 14const queryParameters = new URLSearchParams({ 15 part: 'snippet,contentDetails,status', 16 id: '{{PLAYLIST_ID}}', 17}); 18 19// 设置 API 请求选项 20const options = { 21 method: 'GET', 22 headers: headerParameters, 23}; 24 25// 定义 API 调用函数 26async function getPlaylist() { 27 try { 28 endpointUrl.search = queryParameters; 29 const response = await fetch(endpointUrl, options); 30 31 // 输出响应结果 32 printResponse(response); 33 } catch (error) { 34 // 输出错误信息 35 printError(error); 36 } 37} 38 39// 调用函数发起请求 40getPlaylist();

响应字段

字段名类型描述
id字符串包含正在更新的播放列表的 ID。
items[]列表包含播放列表的列表。
snippet.description字符串包含播放列表的描述。
snippet.title字符串包含播放列表的标题。
snippet.channelId字符串包含频道的 ID。

视频

playlistItems 资源:添加、更新和列出