如何正确使用 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: %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。

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