如何正确使用 YouTube Data API v3 获取频道上传视频列表

本文详解 youtube data api v3 go 客户端中获取频道上传播放列表 id 的正确方式，指出常见字段访问错误，并提供可运行的代码示例与关键注意事项。

在使用 google 官方 Go 客户端库（google-api-go-client/youtube/v3）调用 YouTube Data API v3 时，一个常见误区是误以为 ChannelContentDetails 结构体直接包含 Uploads 字段。实际上，YouTube API 的响应结构是嵌套的：上传视频所在的播放列表 ID 存储在 ContentDetails.RelatedPlaylists.Uploads 字段中，而非 ContentDetails.Uploads。

以下为正确用法示例：

package main  import (     "fmt"     "log"     "your-project-path/google.golang.org/api/youtube/v3" )  func main() {     // 假设已初始化 *youtube.Service 实例（如 youtubeService）     youtubeService := /* your initialized *youtube.Service */      apiCall := youtubeService.Channels.List("contentDetails").Mine(true)     response, err := apiCall.Do()     if err != nil {         log.Fatalf("Error making API call: %v", err)     }      if len(response.Items) == 0 {         log.Fatal("No channel found. Ensure credentials and authorization are correct.")     }      // ✅ 正确访问路径：RelatedPlaylists → Uploads     uploadsPlaylistID := response.Items[0].ContentDetails.RelatedPlaylists.Uploads     fmt.Printf("Uploads playlist ID: %sn", uploadsPlaylistID)      // 后续可据此获取上传视频列表，例如：     videosCall := youtubeService.PlaylistItems.List("snippet").         PlaylistId(uploadsPlaylistID).         MaxResults(25).         Fields("items/snippet/title,items/snippet/resourceId/videoId")     videosResp, err := videosCall.Do()     if err != nil {         log.Fatalf("Failed to fetch uploaded videos: %v", err)     }     for _, item := range videosResp.Items {         fmt.Printf("- %s (ID: %s)n",             item.Snippet.Title,             item.Snippet.ResourceId.VideoId)     } }

⚠️ 注意事项：

• 必须在 Channels.List() 调用中显式指定 fields 或 part=”contentDetails”（本例中已通过 .List(“contentDetails”) 满足），否则 ContentDetails 可能为空；
• Mine(true) 要求 OAuth 2.0 授权且 scope 包含 https://www.googleapis.com/auth/youtube.readonly；
• RelatedPlaylists 是一个结构体字段，Uploads 是其字符串类型子字段（即播放列表 ID），不是方法，不可加括号调用；
• 若使用较新版本客户端（如 google.golang.org/api/youtube/v3 替代已归档的 code.google.com/p/…），请确保导入路径和依赖版本一致——原 code.google.com/p/google-api-go-client 已废弃，应迁移至官方维护的 google.golang.org/api。

掌握该嵌套结构后，即可稳定获取频道上传内容入口，为后续视频列表拉取、分页遍历等操作奠定基础。