Handle do YouTube e ID do canal
O handle é o @name público alterável; o ID do canal é o identificador fixo usado por APIs e URLs /channel/. As URLs antigas funcionam por 14 dias após a mudança.
O handle é para pessoas. O ID do canal é para identificação duradoura.
Um handle do YouTube é o @name público exclusivo do canal e pode ser alterado. O ID é o identificador usado pelas APIs do YouTube e aparece na URL padrão /channel/CHANNEL_ID. O nome do canal é um terceiro campo: o rótulo visível, que não precisa coincidir com o handle.
01 · TRÊS CAMPOS DIFERENTES
Nome, handle e ID do canal resolvem tarefas diferentes
| Campo | Como aparece | Para que serve | O criador pode alterar? |
|---|---|---|---|
| Nome do canal | Kabo | O rótulo visível que os espectadores leem | Sim |
| Handle | @kabo | Identificador público exclusivo usado em menções e em uma URL compartilhável | Sim, dentro dos limites do YouTube |
| ID do canal | Hoje costuma começar com UC | Identificador do canal usado pelas APIs do YouTube e pela URL padrão | Não é apresentado como campo de perfil editável pelo criador |
Role na horizontal para ler todas as colunas.
Ajuda do YouTube: saiba mais sobre handlesAjuda do YouTube: encontrar seus IDs de usuário e canal
02 · TIPOS DE URL DE CANAL
Um canal pode ser acessado por vários formatos de URL
A URL com handle é fácil de ler e compartilhar. A URL com ID aponta diretamente ao canal pelo identificador. Canais antigos também podem ter URLs legadas personalizadas ou de nome de usuário. Os endereços podem levar ao mesmo canal sem representar o mesmo campo subjacente.
youtube.com/@handleMelhor para compartilhamento público, menções e identidade legível.
youtube.com/channel/CHANNEL_IDMelhor quando um sistema precisa do identificador do canal para a API.
youtube.com/c/... ou /user/...Pode continuar funcionando para um canal antigo, mas não é o campo de handle atual.
03 · QUANDO O HANDLE MUDA
O YouTube mantém por pouco tempo as URLs antiga e nova
O YouTube diz que um criador pode mudar o handle duas vezes em 14 dias. Após a mudança, as URLs antiga e nova funcionam por 14 dias, enquanto o handle anterior fica reservado. Esse período protege os links enquanto perfis e menções são atualizados em outros lugares.
- DIA 0
O criador salva um novo handle
O canal ganha uma nova URL legível; o nome do canal não precisa mudar junto.
- 14 DIAS
As URLs antiga e nova funcionam
O YouTube reserva o handle anterior nesse período para permitir que o criador volte a usá-lo se necessário.
- DEPOIS
O handle antigo pode ficar disponível
Não baseie a identidade permanente de um banco de dados só em um handle legível; o YouTube também reserva o direito de alterar, reivindicar ou remover handles.
04 · COMPORTAMENTO DA API
A Data API pode resolver um handle; isso não o torna o ID do canal
A documentação atual da YouTube Data API aceita o método channels.list com o filtro forHandle. O cliente pode enviar o handle com ou sem @ inicial, receber o recurso do canal e ler seu id. É um caminho de conversão, não prova de que todo campo que aceita ID também aceita handle.
channels.list({
part: "id,snippet",
forHandle: "@example"
})
→ response.items[0].idA documentação mostra hoje IDs começando com UC, enquanto a documentação de Analytics do Google alerta que o formato pode mudar. Valide o identificador retornado em vez de fixar “UC para sempre”. YouTube Data API: channels.list YouTube Analytics API: identificadores de relatórios de canal
05 · QUAL VOCÊ DEVE USAR?
Escolha pelo que precisa ser legível e pelo que deve ser resolvido com confiança
- Links públicos de perfil: use a URL com handle porque é fácil de ler e lembrar.
- Menções e colaborações: use o handle iniciado por
@. - Feeds RSS: use o ID do canal no parâmetro
channel_id. - Armazenamento de dados: mantenha o ID como identificador da API e o handle atual como metadado de exibição editável.
- Consulta da Data API: use
forHandlequando tiver o handle e leia o ID do recurso retornado. - Seu próprio ID de canal: encontre-o nas configurações avançadas do YouTube ou consulte um canal público com uma ferramenta específica.
06 · DOIS CAMINHOS DE CONSULTA
Encontre seu ID de canal ou confira um canal público
- SEU CANAL
Use as configurações avançadas da conta do YouTube
Entre como proprietário principal do canal em um navegador de computador ou celular. Abra foto do perfil → Configurações → Configurações avançadas e leia o campo ID do canal. ID do usuário é outro valor. Se gerencia vários canais, confirme qual está vendo antes de copiar.
Esse é o caminho documentado pelo YouTube; não é preciso enviar dados privados da conta a uma ferramenta de terceiros.
- PÚBLICO
Confirme o canal público e consulte seu ID
Abra o canal desejado no YouTube e copie seu
@handleexato ou URL da página. Use o Localizador de ID do canal abaixo e confira nome e identificador com o canal público. Nomes de exibição semelhantes não demonstram que dois canais são o mesmo.Se a consulta falhar ou apontar a outro canal, volte à página e corrija a entrada. Não adivinhe um ID pelo formato habitual. Um ID público identifica um canal; copiá-lo não dá acesso à conta nem às análises privadas.
Ajuda do YouTube: encontrar seus IDs de usuário e canalAjuda do YouTube: saiba mais sobre handles
Testamos @YouTube e https://www.youtube.com/@YouTube no localizador público da Kabo. Ambos retornaram UCBR8-60-B28hp2BmDPdntcQ. A URL pública com ID correspondente abriu o canal verificado @YouTube. Isso confere uma identidade pública, não configurações privadas nem permissão para gerenciar o canal.
@YouTubeUm handle legível ou a URL completa da página do canal.
UCBR8-60-B28hp2BmDPdntcQAs duas formas de entrada retornaram o mesmo ID do canal.
YouTube · @YouTubeA URL pública /channel/ abriu o canal verificado do YouTube durante a checagem registrada.
É um registro estruturado do teste histórico, não uma captura de tela ou consulta ao vivo. Não estabelece disponibilidade para todos os canais nem verifica o comportamento após uma futura mudança de handle.
Repita a verificação no seu canal
- ENTRADA
Comece no canal público desejado
Copie o handle exato e a URL completa. Use o localizador uma vez com cada forma e registre ambos os IDs e a data. Só o nome de exibição coincidir não basta para passar.
- COMPARAR
Abra no YouTube a URL baseada em ID
Acrescente o ID retornado a
https://www.youtube.com/channel/. Compare o handle e a identidade pública com a página inicial. Dois resultados iguais ajudam, mas a página pública é a checagem independente de identidade. - PARE SE
Não leve uma divergência ao seu fluxo
Se as entradas retornarem IDs diferentes, o resultado estiver vazio ou a URL abrir o canal errado, pare antes de usá-lo em um feed ou pedido de API. Copie a URL pública atual novamente; no seu canal, veja o ID nas configurações avançadas. Uma consulta falha não prova que o canal não tem ID.
07 · REGISTRO DE FONTES
Fontes oficiais de identificadores do YouTube
Tem um handle e precisa do ID do canal?
Cole um @handle público ou URL de canal, e a Kabo lê o identificador na página pública. Use o resultado onde um feed, fluxo de análise ou campo de API exigir um ID de canal.