# YouTube 的视频 ID、频道 ID（UC 开头）和 @handle 分别是什么？

> YouTube 的三种标识：11 位视频 ID、以 UC 开头的 24 位频道 ID，以及可以修改的 @handle。各自的格式、对应的网址、该存哪个，以及怎么互相换算。

网页版：https://okdata.online/zh/answers/youtube-video-channel-id-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 视频详情](/zh/apis/youtube/videos/get/)可以传 `id`，也可以把上面任一种视频链接作为 `url` 传进去，返回的 `author.id` 是频道 ID（`UC…`），`author.username` 是不带 @ 的 handle。[YouTube 视频搜索](/zh/apis/youtube/videos/search/)的每条结果也带着同样的作者字段。接口目录里没有频道类接口，所以从 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 |

## 示例

```bash
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` 只剩这几个字段：

```json
{ "id": "Xk3_9fQpL2w",
  "author": { "id": "UCq7mT2vXbN4rLk9sHd0aWzE", "username": "trailkitgear", "name": "Trail Kit" } }
```

## 限制

- 视频 ID 本身不会变，但视频可能被删除或设为私享，这时详情接口返回 `not_found`，这次调用照常计费。
- 播放列表 ID（`PL…`）或频道链接都不是视频链接，视频详情读不了。
- 非拉丁文字的 handle 规则不一样，YouTube 的 handle 帮助页列出了中文、韩文等文字的长度要求。

拿到 ID 之后想查播放和点赞，见[怎么从链接拿到 YouTube 视频的播放量和点赞](/zh/answers/youtube-view-count-api/)。

## 用到的接口

- [YouTube 视频详情](https://okdata.online/zh/apis/youtube/videos/get/) `youtube.videos.get`：$0.002/次
- [YouTube 视频搜索](https://okdata.online/zh/apis/youtube/videos/search/) `youtube.videos.search`：$0.004/次 · 每页约 20 条视频

## 更多YouTube内容

- [YouTube API](https://okdata.online/zh/apis/youtube/)
- [怎么导出某个话题下所有 YouTube 视频的评论](https://okdata.online/zh/guides/youtube-comments-export/)
- [怎么按关键词搜 YouTube 视频并拿到字幕](https://okdata.online/zh/guides/youtube-video-transcript/)
- [怎么用 API 拿到 YouTube 视频的标签和简介？](https://okdata.online/zh/answers/youtube-video-tags-api/)
- [怎么用 API 按关键词搜 YouTube 频道，顺带拿到订阅数？](https://okdata.online/zh/answers/youtube-channel-search-api/)
- [几百个 YouTube 视频的字幕怎么批量下载？](https://okdata.online/zh/answers/bulk-youtube-transcripts/)
- [跑一个社媒数据任务之前，怎么提前知道要花多少钱？](https://okdata.online/zh/answers/estimate-data-api-cost-before-running/)
- [用平台官方 API 还是第三方社媒数据接口？](https://okdata.online/zh/answers/official-api-vs-third-party-social-data/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)

## 资料来源

- [YouTube 帮助：了解 YouTube 频道的网址](https://support.google.com/youtube/answer/6180214?hl=en) (读取于 2026-11-12)
- [YouTube 帮助：了解 YouTube 名称（handle）](https://support.google.com/youtube/answer/11585688?hl=en) (读取于 2026-11-12)
- [YouTube Data API：Channels list（forHandle 参数）](https://developers.google.com/youtube/v3/docs/channels/list) (读取于 2026-11-12)
- [Base64（维基百科）：YouTube 使用的 URL 安全字母表](https://en.wikipedia.org/wiki/Base64) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://stackoverflow.com/questions/14366648
- https://stackoverflow.com/questions/75805219
- https://stackoverflow.com/questions/47096243

更新于 2026-11-12
