本文详解 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。
以下为正确用法示例：
youtube-ultimate
下载
免费字幕、4K 视频下载与视频探索功能 —— 零 API 配额消耗。专为 TinkerClaw fork 构建 —— github.com/globalcaos/tinkerclaw。
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: %s\n", 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。
掌握该嵌套结构后，即可稳定获取频道上传内容入口，为后续视频列表拉取、分页遍历等操作奠定基础。
