URL de incorporação vs URL de visualização: qual a diferença?

Os vídeos do YouTube têm pelo menos dois URLs diferentes, e trocar um pelo outro é um dos erros de incorporação mais comuns.

O URL de visualização

Tem o aspeto https://www.youtube.com/watch?v=ID_DO_VIDEO. Esta é a página normal onde aterra quando navega no YouTube, com comentarios, recomendações e toda a interface do site. Destina-se a partilhar por ligação, não a colocar dentro de um iframe.

O URL de incorporação

Tem o aspeto https://www.youtube.com/embed/ID_DO_VIDEO. E uma versão simplificada do leitor, concebida especificamente para funcionar dentro de um <iframe> no site de outra pessoa, e aceita parâmetros extra como autoplay, start e controls.

Porque isto importa

Colocar um URL de visualização no atributo src de um iframe muitas vezes falha ou mostra um erro, porque o YouTube bloqueia a incorporação do site completo numa moldura. Ferramentas como o gerador de código de incorporação deste site tratam da conversao automaticamente, por isso só precisa da ligação normal que copiou do navegador.

Porque o YouTube mantém dois formatos de URL separados

Manter a experiência de visualização e a experiência de incorporação em estruturas de URL separadas da ao YouTube espaço para incluir funcionalidades diferentes em cada uma. A página de visualização transporta comentarios, recomendações, avisos de subscrição e toda a navegação do site, tudo coisas que fazem sentido quando alguém está ativamente a navegar no próprio YouTube, mas que seriam ruido indesejado, e um risco de segurança, se permitidas dentro de um iframe arbitrário de terceiros. O URL de incorporação retira tudo isso, expondo apenas o leitor e os parâmetros relevantes para controlar a reprodução, o que é simultaneamente mais simples e mais seguro de permitir dentro de sites de outras pessoas.

Um exemplo prático da conversao

Uma ligação de visualização partilhada como https://www.youtube.com/watch?v=dQw4w9WgXcQ transforma-se em https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ para incorporação: o domínio muda opcionalmente para a versão respeitadora da privacidade, o caminho muda de /watch para /embed/, e o valor do parâmetro de consulta v= passa diretamente para o caminho. Ligações youtu.be encurtadas e ligações de Shorts passam pela mesma conversao subjacente, apenas partindo de um formato original diferente.

Formatos de URL relacionados a conhecer

Além dos URLs de visualização e incorporação, o YouTube usa também um formato distinto para playlists (/playlist?list=ID para navegar, /embed/videoseries?list=ID para incorporar) e para canais. Trocar estes formatos, por exemplo tentar incorporar um URL de canal como se fosse um único vídeo, produz um erro em vez de um leitor a funcionar, já que cada formato e tratado por lógica diferente do lado do YouTube. O nosso gerador de código de incorporação trata da conversao a partir de qualquer um destes formatos comuns automaticamente, por isso não precisa de memorizar as regras exatas de transformação para cada caso.

Manter esta distinção clara é mais importante na resolução de problemas: uma incorporação que mostra um leitor em branco ou um erro genérico e frequentemente apenas o formato de URL errado colado no sitio errado, e não uma restrição genuína ao próprio vídeo.

Perguntas frequentes