Vídeo do YouTube Não Incorpora? 8 Soluções que Realmente Funcionam

Um vídeo do YouTube que não incorpora é uma das frustrações mais comuns ao adicionar vídeo a um site. Aqui estão oito soluções que resolvem realmente o problema, mais ou menos pela ordem que vale a pena experimentar.

1. Verifique se o proprietário do vídeo desativou a incorporação

Os criadores podem desativar completamente a incorporação de um vídeo específico a partir do YouTube Studio. Se esta opção estiver desligada, nenhum código correto fará a incorporação funcionar; o leitor mostrará um erro em vez disso. Não existe forma de contornar isto do lado da incorporação; é uma definição controlada apenas pelo proprietário do vídeo.

2. Confirme que está a usar o URL de incorporação, não o URL de visualização

Um URL de visualização (youtube.com/watch?v=…) não pode ser colocado diretamente no atributo src de um iframe; precisa de ser convertido para o formato de incorporação (youtube.com/embed/ID_DO_VIDEO). Este é o erro mais comum, e o nosso gerador de código de incorporação trata da conversão automaticamente a partir de qualquer link que cole.

3. Procure um erro de digitação no ID do vídeo

Os IDs de vídeo do YouTube são uma sequência exata de 11 caracteres; um único caráter errado ou em falta produz um estado de “vídeo não encontrado” no leitor, em vez de uma mensagem de erro clara, o que pode parecer idêntico a um vídeo com incorporação desativada à primeira vista.

4. Procure uma Content Security Policy a bloquear iframes

Se o seu site define um cabeçalho Content-Security-Policy que restringe frame-src, isso pode bloquear silenciosamente o carregamento do iframe do YouTube, mesmo que o seu código de incorporação esteja correto. Verifique as definições de segurança do seu site ou CMS quanto a uma política que precise de ter youtube.com e youtube-nocookie.com adicionados às suas fontes de frame permitidas.

5. Procure um plugin ou tema a remover iframes

Alguns plugins de segurança ou desempenho do WordPress removem tags iframe e script do conteúdo dos artigos por predefinição, como medida de segurança. Se uma incorporação desaparece especificamente depois de guardar um artigo, verifique as definições de filtragem de HTML do seu plugin quanto a uma opção de lista de permissões.

6. Verifique o estado da restrição de idade

Os vídeos com restrição de idade têm, historicamente, suporte de incorporação limitado ou bloqueado fora da própria interface do YouTube com sessão iniciada. Se um vídeo reproduz normalmente no YouTube.com mas nunca carrega quando incorporado, vale a pena verificar uma restrição de idade como causa.

7. Exclua uma restrição de região

Um vídeo bloqueado no país do seu visitante por motivos de licenciamento não conseguirá incorporar-se especificamente para essa pessoa, mesmo que funcione perfeitamente quando testado a partir de outra localização. Isto é definido pelo detentor dos direitos, não por nada do lado do site que faz a incorporação.

8. Teste numa janela anónima ou noutro navegador

Bloqueadores de anúncios, extensões de privacidade e definições rigorosas de proteção contra rastreamento ocasionalmente bloqueiam por completo os iframes incorporados do YouTube. Testar numa janela privada/anónima com as extensões desativadas indica rapidamente se o problema está na configuração do seu próprio navegador, e não no código de incorporação em si.

Tabela de diagnóstico rápido

Sintoma	Causa provável
Mensagem “Vídeo indisponível”	Incorporação desativada pelo proprietário, ou ID de vídeo incorreto
Espaço em branco, sem erro	Content Security Policy ou plugin a remover o iframe
Funciona para si, não para outros	Restrição de região ou definições do navegador/bloqueador de anúncios deles
Funciona no YouTube.com, não incorporado	Restrição de idade

Como testar uma incorporação isoladamente

Quando uma incorporação falha no seu site em produção, ajuda excluir a configuração específica da sua página antes de assumir que o problema é o próprio vídeo. Crie um ficheiro HTML local simples, apenas com o código de incorporação, e abra-o diretamente num navegador; se funcionar aí mas não na sua página em produção, a causa é quase certamente algo no ambiente do seu site, como uma Content Security Policy, um plugin ou um conflito de tema, e não o vídeo ou o código de incorporação em si.

Ler o erro real que o leitor apresenta

O leitor incorporado do YouTube frequentemente mostra um motivo específico quando falha, em vez de um espaço em branco genérico, se observar com atenção. “Vídeo indisponível”, “A reprodução noutros sites foi desativada pelo proprietário do vídeo” e “Este vídeo é privado” são três mensagens visivelmente diferentes que apontam para três causas diferentes: um vídeo removido ou restrito, incorporação especificamente desativada e uma definição de privacidade, respetivamente. Ler o texto exato ajuda a identificar qual das oito soluções acima é realmente relevante, em vez de adivinhar.

Quando a solução está genuinamente fora do seu controlo

Vale a pena aceitar que algumas falhas de incorporação não têm solução possível do lado de quem incorpora: se o proprietário de um vídeo desativou a incorporação, apagou o vídeo ou tornou-o privado, nenhuma alteração de código muda esse resultado. Nestes casos, as opções práticas são contactar o proprietário do vídeo, se tiver uma relação com essa pessoa, encontrar um vídeo alternativo que cubra o mesmo conteúdo, ou colocar uma ligação direta para o vídeo em vez de o incorporar.

Criar uma lista de verificação simples de resolução de problemas

Quando uma incorporação falha, percorrer as causas por uma ordem fixa poupa tempo em comparação com adivinhar aleatoriamente. Comece pelas duas causas que não precisam de alterações de código para verificar: abra o URL de incorporação diretamente num separador do navegador para ver se o próprio YouTube devolve um erro, e confirme que o ID do vídeo está exatamente correto, caráter por caráter. Se ambos estiverem corretos, avance para o ambiente do seu próprio site: desative os plugins um de cada vez, verifique se existe um cabeçalho Content Security Policy nas respostas do seu site com as ferramentas de programador do navegador e, por fim, teste numa janela de navegação privada com extensões desativadas para excluir tudo o que seja do lado do cliente.

Um pequeno glossário sobre este tema

Termo	Significado
Content Security Policy (CSP)	Um cabeçalho de segurança que pode restringir que conteúdo externo, incluindo iframes, uma página pode carregar
Restrição de idade	Uma definição que limita a visibilidade e o suporte de incorporação de um vídeo com base na verificação de idade do YouTube
Restrição de região	Bloqueio baseado em licenciamento de um vídeo em países específicos, definido pelo detentor dos direitos

Prevenir problemas de incorporação antes de acontecerem

Alguns hábitos reduzem a frequência com que se depara com problemas de incorporação: gere sempre os códigos de incorporação a partir do link atual real, em vez de copiar um excerto antigo que possa referir-se a um vídeo entretanto restrito, mantenha os plugins de segurança e de cache atualizados para que a sua lógica de tratamento de HTML se mantenha atual, e verifique periodicamente páginas mais antigas do seu site, já que um vídeo que incorporava bem quando publicou uma página pode depois ser restringido, removido ou bloqueado por região sem qualquer alteração da sua parte.

Para onde ir a partir daqui

Para o panorama completo sobre como criar incorporações corretamente desde o início, consulte o nosso guia completo de incorporação do YouTube e a referência completa de parâmetros.

Como as restrições de incorporação mudaram ao longo do tempo

As regras de incorporação e o comportamento do leitor do YouTube não são estáticos; a plataforma ajustou várias vezes ao longo dos anos as restrições relacionadas com incorporação para conteúdo com restrição de idade, transmissões em direto e certas categorias de conteúdo, por vezes reforçando e por vezes aliviando limitações específicas. Um guia de resolução de problemas como este reflete o comportamento geral atual, mas se gere um site com muitas incorporações durante um longo período, vale a pena revisitar periodicamente páginas mais antigas, já que um vídeo ou categoria de vídeo que incorporava sem problemas quando uma página foi criada pode ser afetado por uma alteração de política ao nível da plataforma mais tarde, de forma totalmente independente de qualquer coisa no seu site.

Trabalhar com uma equipa de desenvolvimento em problemas persistentes

Se um problema de incorporação persistir depois de percorrer as soluções deste guia e parecer específico da configuração técnica do seu site, em vez do YouTube ou do próprio vídeo, o passo seguinte mais eficiente é fornecer a um programador o URL de incorporação exato, a mensagem de erro completa ou o comportamento observado, e o URL da página específica, em vez de uma descrição genérica de “o vídeo não aparece”. Isto permite que alguém técnico reproduza diretamente a Content Security Policy, o conflito de plugin ou o problema de markup, em vez de resolver o problema às cegas.

Uma nota sobre incorporar transmissões em direto especificamente

As transmissões em direto incorporadas comportam-se de forma ligeiramente diferente do vídeo pré-gravado incorporado: uma transmissão que ainda não começou, já terminou ou nunca foi tornada pública pode apresentar uma falha de incorporação que parece idêntica a um problema de permissões, mas é na verdade apenas um problema de tempo ou de estado. Se a incorporação de uma transmissão em direto falhar, verificar o estado atual da transmissão diretamente no YouTube antes de continuar a resolver o problema no código de incorporação pode poupar tempo ao excluir causas que não têm nada a ver com o seu site.

Com estas oito soluções e os hábitos de diagnóstico acima, a grande maioria das falhas de incorporação é resolúvel em poucos minutos de verificação concentrada.

Percorrer estas verificações de forma metódica, em vez de adivinhar, é sistematicamente o caminho mais rápido para voltar a ter uma incorporação funcional.

Perguntas frequentes