问答
YouTube 的视频 ID、频道 ID(UC 开头)和 @handle 分别是什么?
简短回答
视频 ID 是 watch?v= 或 youtu.be/ 后面那 11 位码;频道 ID 是以 UC 开头、永不变化的 24 位 ID;@handle 是频道对外的名字,可以改。okdata 的 YouTube 视频详情接口传视频 ID 或任意视频链接,返回的 author.id 是频道 ID,author.username 是 handle,每次 $0.002。
YouTube 的链接里混着三种标识,不同工具要的还不一样。视频 ID 指一个视频;频道 ID 永久指向一个频道;handle 是频道的 @名字,由频道主自己起,也可以改。分清楚它们,就不会把会失效的那个存成主键。
三者对比
| 视频 ID | 频道 ID | handle | |
|---|---|---|---|
| 例子 | Xk3_9fQpL2w |
UCq7mT2vXbN4rLk9sHd0aWzE |
@trailkitgear |
| 格式 | 11 个字符,取自 A-Z、a-z、0-9、- 和 _ |
UC 加 22 个字符,共 24 位 |
3 到 30 个字符,中间可以有 _、- 和 . |
| 出现在网址里 | watch?v=、youtu.be/、/shorts/、/live/ |
youtube.com/channel/UC… |
youtube.com/@handle |
| 会不会变 | 不会 | 不会 | 频道主可以改 |
视频 ID 和频道 ID 用的是 base64 的 URL 安全字母表,所以会出现 - 和 _。/c/名字、/user/名字 这种老链接还在,YouTube 说明新的自定义网址已经不能再设置,这些旧链接现在会跳转到 handle 网址。handle 不区分大小写。
该存哪个
视频按视频 ID 存,频道按频道 ID 存。handle 和频道名称当标签,定期刷新。去年表格里记下的 handle,现在可能已经打不开,或者指向了别的频道。
怎么互相换算
YouTube 视频详情可以传 id,也可以把上面任一种视频链接作为 url 传进去,返回的 author.id 是频道 ID(UC…),author.username 是不带 @ 的 handle。YouTube 视频搜索的每条结果也带着同样的作者字段。接口目录里没有频道类接口,所以从 handle 换到频道 ID,可以走这几条路:
- 找这个频道的任意一个视频,调视频详情,读
author.id; - 按频道名称搜一次,留下
author.username对得上的结果; - 如果你有 Google Cloud 项目和密钥,用 YouTube 官方 Data API 的
channels.list,传forHandle=@名字就能拿到频道资源。
| 要做的事 | 调用次数 | 费用 |
|---|---|---|
| 视频链接换成视频 ID、频道 ID 和 handle | 1 | $0.002 |
| 通过一页搜索把 handle 换成频道 ID | 1 | $0.004 |
| 表格里的 200 个视频链接 | 200 | $0.40 |
示例
curl -G "https://api.okdata.online/v1/youtube/videos/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'url=https://youtu.be/Xk3_9fQpL2w' \
--data-urlencode 'fields=id,author.id,author.username,author.name'
返回里的 data.item 只剩这几个字段:
{ "id": "Xk3_9fQpL2w",
"author": { "id": "UCq7mT2vXbN4rLk9sHd0aWzE", "username": "trailkitgear", "name": "Trail Kit" } }
限制
- 视频 ID 本身不会变,但视频可能被删除或设为私享,这时详情接口返回
not_found,这次调用照常计费。 - 播放列表 ID(
PL…)或频道链接都不是视频链接,视频详情读不了。 - 非拉丁文字的 handle 规则不一样,YouTube 的 handle 帮助页列出了中文、韩文等文字的长度要求。
拿到 ID 之后想查播放和点赞,见怎么从链接拿到 YouTube 视频的播放量和点赞。
资料来源
- YouTube 帮助:了解 YouTube 频道的网址
- YouTube 帮助:了解 YouTube 名称(handle)
- YouTube Data API:Channels list(forHandle 参数)
- Base64(维基百科):YouTube 使用的 URL 安全字母表
这个问题出现过的地方(读取于 2026-11-12)
更新于