如何通过YouTube Data API v3将视频保存到自定义播放列表

架构老林

2026-9-24

功能实现方案

你查阅的videos接口不支持该操作，对应功能由YouTube Data API v3的PlaylistItems资源的insert方法实现，操作步骤如下：

第一步：获取当前授权用户的自定义播放列表ID，你可以调用Playlists.list接口，传入参数mine=true拉取用户名下所有播放列表的ID和名称，匹配到你要添加的目标播放列表ID
第二步：调用PlaylistItems.insert接口，在请求体中传入对应参数即可完成视频添加，和网页端点击「save」按钮选择播放列表的效果完全一致

接口权限要求

调用该接口必须先获取用户的OAuth 2.0授权，授权范围可选以下任意一种：

https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

示例请求体（JSON格式）

{
  "snippet": {
    "playlistId": "替换为你的目标播放列表ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "替换为要保存的YouTube视频ID"
    }
  }
}