Gerador de incorporação do YouTube
Introdução
O gerador de incorporação do YouTube da Toollect transforma qualquer URL de vídeo do YouTube ou ID de vídeo avulso em código iframe pronto a copiar com um clique. Cole a ligação, escolha o comportamento do leitor, gere, pré-visualize, copie, cole, todo o fluxo leva segundos e cada opção corresponde a um parâmetro real do YouTube ainda suportado hoje.
O problema que resolve é o trabalhoso. O diálogo oficial de partilha dá um único iframe fixo sem controlo sobre tamanho, proporção ou comportamento, e cada tutorial de "como incorporar YouTube" envia-o para uma lista de parâmetros que tem de escrever à mão no URL. Esta ferramenta faz essa montagem por si, escolha uma proporção e a dimensão oposta calcula-se sozinha, ative o modo sem cookies, a repetição, os controlos, e corte um vídeo numa hora de início e fim sem nunca abrir um editor.
O gerador é deliberadamente uma ferramenta de vídeo único. Aceita a gramática completa das ligações reais do YouTube, URLs watch, ligações curtas youtu.be, Shorts, diretos, e até um ID de vídeo avulso, e normaliza todos para um URL de incorporação canónico. Tudo acontece no seu navegador, sem chave de API, sem conta, e nada sobre a sua ligação sai do seu dispositivo. O único pedido de rede é o honesto, a pré-visualização ao vivo, que carrega um iframe real do leitor para que possa verificar o resultado antes de o copiar.
Casos de uso
A incorporação de vídeos do YouTube aparece em mais sítios do que um artigo de blogue, e as opções contam de forma diferente em cada contexto.
- Páginas de blogue e artigos. A predefinição 16:9 a 560×315 corresponde ao que a maioria dos temas de CMS espera, e o domínio sem cookies mantém a incorporação amiga do RGPD por padrão.
- Páginas de cursos e documentação. start e end mostram aos estudantes um trecho preciso de uma longa aula, e o código gerado funciona em qualquer plataforma de aprendizagem que aceite HTML bruto.
- Shorts e conteúdo vertical. A predefinição 9:16 produz um leitor em forma de telefone de 360×640 para vídeos verticais, algo que a maioria dos outros geradores nem oferece.
- Quiosques e ecrãs de sinalização. Desative os controlos do leitor para obter uma superfície de reprodução limpa sem distrações, opcionalmente com o interruptor de repetição para exibição contínua.
- Protótipos de design. Coloque um vídeo num protótipo Figma ou HTML num tamanho exato em píxeis, o modo de proporção personalizada aceita qualquer largura e altura entre 144 e 3840 píxeis.
- Sites atentos à privacidade. O domínio sem cookies é aqui o padrão, enquanto o diálogo oficial produz sempre um URL www.youtube.com, a menos que saiba que tem de o mudar à mão.
Como funciona
O gerador é um pipeline de duas fases, e ambas correm inteiramente no seu navegador.
Fase 1, extração do ID. O analisador de URLs reconhece todas as formas comuns de ligação do YouTube e extrai o ID de vídeo de 11 caracteres. Esse ID é tudo o que o leitor de incorporação do YouTube precisa. Também é aceite um ID avulso, para que possa colar um ID copiado da barra de endereços ou de uma base de dados.
Fase 2, montagem do código. O ID é inserido no modelo de URL de incorporação, e cada opção ativada adiciona um parâmetro de consulta:
https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ?autoplay=1&start=30
A etiqueta iframe é montada com atributos explícitos de largura e altura, o título de acessibilidade, a lista de permissões allow padrão e allowfullscreen. Uma peculiaridade do YouTube é tratada automaticamente, um único vídeo em repetição deve ser apresentado como uma lista de reprodução de um elemento, portanto o interruptor de repetição adiciona loop=1 e playlist=VIDEO_ID juntos. Sem o segundo parâmetro, o YouTube ignora a repetição silenciosamente.
A pré-visualização é o mesmo iframe que o código gerado contém, a ferramenta renderiza o leitor real, não uma imitação. O que vê na pré-visualização é exatamente o que os seus visitantes verão, incluindo a forma como o próprio YouTube reporta um vídeo eliminado, privado ou indisponível.
Formatos de URL compatíveis
O analisador aceita toda a forma que identifique um único vídeo e rejeita toda a forma que não o faça.
Aceites
| Formato de URL | Exemplo |
|---|---|
| URL watch | https://www.youtube.com/watch?v=dQw4w9WgXcQ |
| Ligação curta | https://youtu.be/dQw4w9WgXcQ |
| URL embed | https://www.youtube.com/embed/dQw4w9WgXcQ |
| URL Shorts | https://www.youtube.com/shorts/dQw4w9WgXcQ |
| URL live | https://www.youtube.com/live/dQw4w9WgXcQ |
| URL /v/ | https://www.youtube.com/v/dQw4w9WgXcQ |
| Domínio sem cookies | https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ |
| ID de vídeo avulso | dQw4w9WgXcQ |
Os URLs watch com parâmetros de consulta adicionais como &t=42s ou &list=PL... são analisados corretamente, o gerador extrai o ID e ignora o resto, pois os parâmetros de incorporação são reconstruídos a partir das suas definições em vez de copiados da ligação.
Rejeitados
| Formato de URL | Porque é rejeitado |
|---|---|
| Ligação de lista de reprodução | youtube.com/playlist?list=PL... identifica uma lista, não um único vídeo |
| Página de canal | youtube.com/@canal não tem ID de vídeo |
| URL de pesquisa | youtube.com/results?search_query=... não tem ID de vídeo |
| Página de utilizador | youtube.com/user/nome não tem ID de vídeo |
| Shorts sem ID | youtube.com/shorts/ é uma página de índice, não um vídeo |
Anatomia do código de incorporação
O iframe gerado é compacto e cada parte tem um papel. Esta é a saída padrão em 16:9:
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/dQw4w9WgXcQ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
| Atributo | Papel |
|---|---|
| width / height | O tamanho do leitor em píxeis. A altura é recalculada a partir da proporção escolhida quando altera a largura, e vice-versa. |
| src | O URL de incorporação. O anfitrião padrão é www.youtube-nocookie.com, desativar o modo sem cookies muda para www.youtube.com. Os parâmetros de consulta transportam as opções do leitor. |
| title | O nome acessível que os leitores de ecrã anunciam para o quadro. Mantém o valor oficial padrão do YouTube para que o código gerado corresponda ao que o próprio YouTube publica. |
| frameborder | Atributo legado para compatibilidade com validadores HTML antigos, sem efeito visual nos navegadores modernos. |
| allow | A política de permissões do leitor incorporado, com capacidade de ecrã inteiro e reprodução automática, como a incorporação oficial do YouTube. |
| referrerpolicy | Diz ao navegador o que enviar no cabeçalho referer. strict-origin-when-cross-origin é o valor moderno padrão, que revela apenas a origem, nunca o URL completo da página. |
| allowfullscreen | Ativa o botão de ecrã inteiro do leitor. |
Os parâmetros de consulta do src são a parte configurável. autoplay=1, loop=1&playlist=ID, controls=0, start=SEGUNDOS e end=SEGUNDOS aparecem apenas se ativar a opção correspondente, portanto uma incorporação mínima não carrega nenhum parâmetro.
Opções de incorporação
Cada opção do painel de definições corresponde a um parâmetro do URL final.
| Definição | Parâmetro | Padrão | Notas |
|---|---|---|---|
| Proporção | – | 16:9 | As predefinições são 16:9, 4:3, 3:4, 9:16 e 1:1, mais personalizada. Uma predefinição preenche o tamanho canónico para essa proporção, 16:9 torna-se 560×315, 9:16 torna-se 360×640. |
| Largura / Altura | – | 560×315 | Editar um campo recalcula o outro a partir da proporção ativa. O modo personalizado desativa o cálculo e mantém ambos os valores independentes. Intervalo 144–3840 px. |
| Modo sem cookies | Mudança de anfitrião | ativado | Usa www.youtube-nocookie.com, onde o YouTube não guarda informações sobre visitantes enquanto o vídeo não é reproduzido. |
| Reprodução automática | autoplay=1 | desativado | Nota, os navegadores bloqueiam na mesma a reprodução automática com som, veja as perguntas frequentes. |
| Repetição | loop=1&playlist=ID | desativado | O parâmetro playlist é adicionado automaticamente, sem ele o YouTube ignora a repetição. |
| Mostrar controlos do leitor | controls=0 ao desativar | ativado | Desativado oculta a barra de controlos e dá uma superfície de reprodução limpa. |
| Iniciar em | start=SEGUNDOS | desativado | Campos de horas, minutos e segundos, o valor é convertido em segundos no URL. |
| Terminar em | end=SEGUNDOS | desativado | Para a reprodução no momento indicado e corta um trecho sem editar o vídeo de origem. |
O cálculo automático largura/altura arredonda para píxeis inteiros e limita ao intervalo 144–3840. Como as predefinições são proporções exatas, os pares canónicos como 560×315 e 360×640 são exatos ao píxel, não há portanto deriva de arredondamento contra a qual lutar quando precisa de um tamanho exato.
Referência de parâmetros: o que ainda funciona em 2026
O YouTube retirou mais parâmetros de incorporação do que a maioria dos sites sabe, e os tutoriais antigos continuam a recomendar parâmetros mortos. Este é o estado de 2026 dos parâmetros que encontrará na internet, verificado contra a documentação oficial do leitor.
Ainda funcionam
| Parâmetro | Efeito em 2026 |
|---|---|
| autoplay | Inicia a reprodução, sujeito à política de som do navegador |
| loop + playlist | Repete o vídeo, o par deve permanecer junto |
| controls | 0 oculta a barra de controlos, 2 oculta também o botão de ecrã inteiro |
| start / end | Pontos de entrada e corte em segundos |
| cc_load_policy | 1 força a ativação das legendas |
| cc_lang_pref | Define o idioma das legendas |
| hl | Define o idioma da interface do leitor |
| color | color=white muda a barra de progresso para branco (apenas com controlos visíveis) |
| fs | 0 oculta o botão de ecrã inteiro |
| disablekb | 1 desativa os controlos de teclado do leitor |
| rel | 0 limita os vídeos relacionados ao mesmo canal, não pode eliminá-los |
Retirados e sem efeito
| Parâmetro | O que aconteceu |
|---|---|
| modestbranding | Retirado em agosto de 2023, o logótipo é sempre mostrado |
| showinfo | Retirado em setembro de 2018, os títulos são sempre mostrados |
| autohide | Retirado, o parâmetro é ignorado |
| theme | Retirado, só existe o leitor escuro |
| vq | Morto há anos, a qualidade inicial já não pode ser forçada |
| iv_load_policy | As anotações foram removidas do YouTube, o parâmetro já não tem nada para controlar |
O gerador expõe deliberadamente apenas os parâmetros que ainda funcionam e que a maioria de quem incorpora realmente precisa. A coleção funcional mas de nicho, fs, hl, color, disablekb, cc_load_policy, fica fora da interface de propósito, pois a saída é um URL simples, qualquer pessoa pode adicionar &fs=0 ou &cc_load_policy=1 à mão sem partir nada do que o gerador criou.
Uso
- Cole um URL de vídeo do YouTube ou um ID de vídeo avulso no campo de entrada e prima Gerar, ou prima Enter.
- O código de incorporação aparece na área de saída e a pré-visualização ao vivo abre automaticamente por baixo.
- Ajuste as opções, proporção, largura ou altura, modo sem cookies, reprodução automática, repetição, controlos, hora de início e fim. O código e a pré-visualização atualizam-se instantaneamente a cada mudança.
- Verifique a pré-visualização. É o leitor real, portanto pode premir reproduzir, avançar e verificar visualmente os pontos de início e fim.
- Clique em Copiar e cole o iframe na sua página, no seu CMS ou no seu bloco HTML.
Se o URL não contiver um ID de vídeo, uma mensagem de erro vermelha explica o que era esperado. Limpar repõe a entrada, o código e a pré-visualização de uma vez.
Tutorial
Exemplo 1, um trecho de aula com corte e repetição. Uma página de curso precisa de uma aula de 12 minutos, mas o vídeo de origem dura 40, e a parte relevante vai de 3:05 a 12:30, em repetição para os estudantes que a quiserem rever.
- Cole o URL watch no campo de entrada e prima Gerar.
- A proporção 16:9 e a largura 560 já estão corretas, deixe-as.
- Escreva 3 no campo de minutos de início e 5 no campo de segundos de início.
- Escreva 12 no campo de minutos de fim e 30 no campo de segundos de fim.
- Ative Repetição.
- O código conterá agora start=185&end=750&loop=1&playlist=VIDEO_ID.
- Copie o iframe e cole-o na página do curso.
Exemplo 2, um vídeo Shorts em formato vertical. Um artigo pensado para telemóvel incorpora um Shorts em 9:16.
- Cole o URL de Shorts, https://www.youtube.com/shorts/... é reconhecido como qualquer outra ligação.
- Escolha a proporção 9:16. A largura passa automaticamente para 360 e a altura para 640.
- Deixe a reprodução automática desativada, os navegadores móveis bloqueá-la-iam na mesma.
- Gere, pré-visualize, copie. O iframe tem forma de telefone e cabe em colunas de conteúdo feitas para meios verticais.
Dicas de profissional
- Corte sem editar. start e end criam um clipe por trecho sem recodificação, sem novo carregamento e sem perda de qualidade, o leitor salta para o ponto de entrada e para no de saída.
- Mantenha o anfitrião sem cookies para tráfego da UE. youtube-nocookie.com não guarda informações sobre visitantes enquanto o vídeo não é reproduzido, o que alivia as formalidades de consentimento face ao domínio normal.
- Combine reprodução automática e silêncio à mão. Se precisar mesmo de autoplay, adicione &mute=1 à src gerada, os navegadores permitem reprodução automática em silêncio e os visitantes podem ativar o som com um toque.
- Use a pré-visualização como passo de controlo de qualidade. Como a pré-visualização é o leitor real, um vídeo eliminado ou privado mostra lá a mensagem de erro do próprio YouTube, em vez de enviar um iframe morto para produção.
- Mini-incorporações para cartões e listas. O mínimo de 144 px suporta leitores do tamanho de uma miniatura para cartões com pré-visualização ao passar o rato, onde um leitor grande partiria o layout.
- Proporção personalizada para layouts invulgares. Barras laterais, colunas verticais de artigo e secções de prova social pedem frequentemente tamanhos não padrão, o modo personalizado mantém largura e altura independentes.
- Geração em lote. Mantenha o URL no campo e mude as opções, cada mudança regenera instantaneamente, portanto um iframe repetido cortado e uma variante simples saem em segundos, não em minutos.
Alternativas
| Alternativa | Ponto forte | Ponto fraco |
|---|---|---|
| Diálogo oficial de partilha do YouTube | Oficial, sempre atualizado | Tamanho 16:9 fixo, sem predefinições de proporção, sem campos início/fim, sempre anfitrião www.youtube.com |
| oEmbed do YouTube | Entrega um iframe com título do vídeo automático | Precisa de um servidor ou de um fetch, sem controlo de parâmetros, exige infraestrutura JavaScript |
| Copiar o URL à mão | Nada para aprender | Cada opção é uma edição manual do URL, propensa a erros, e os parâmetros mortos espreitam |
| Este gerador | Um clique, predefinições de proporção, anfitrião sem cookies padrão, campos início/fim, pré-visualização imediata | Apenas vídeo único por conceção, sem incorporações de listas |
Contra o diálogo de partilha do YouTube
O fluxo próprio "Partilhar → Incorporar" do YouTube é bom quando quer exatamente um iframe fixo. O diálogo dá um leitor de 560×315, uma caixa para alternar e um URL em www.youtube.com. Esse é todo o seu alcance.
O gerador cobre os casos que o diálogo simplesmente não aborda, um leitor de Shorts 9:16, um azulejo 3:4 ou 1:1, um tamanho exato em píxeis, um anfitrião respeitador da privacidade por padrão, um corte início/fim sem editar o URL à mão e uma repetição que funciona mesmo porque o parâmetro playlist é adicionado por si. Tudo o que o diálogo produz, o gerador também produz, mais a pré-visualização ao vivo que ele não oferece.
Gerador de incorporação contra verificador de incorporação
O site também aloja o verificador de incorporação do YouTube, e as duas ferramentas complementam-se em vez de competir.
| Pergunta | Verificador de incorporação | Gerador de incorporação |
|---|---|---|
| Este vídeo é sequer incorporável? | Responde com um veredito, testes de oEmbed, leitor e reprodução | Assume que sim e produz o código |
| Quais são o título, autor e duração do vídeo? | Mostra-os | Não obtém metadados por conceção |
| Dá-me o código de incorporação | Não, só diagnóstico | Sim, com controlo total das opções |
| Verificar primeiro uma ligação suspeita? | Sim, é o seu trabalho | Cole o resultado de novo se precisar |
Passe uma ligação pelo verificador primeiro quando precisar de certeza sobre a incorporabilidade, depois pelo gerador quando precisar do código. Partilham o mesmo analisador de URLs, portanto tudo o que o verificador aceita, o gerador também analisa.
O que ele não faz
- Obter metadados. O gerador nunca chama a API do YouTube e não pode portanto pré-preencher um título ou autor. É uma ferramenta de código, não de informação, o verificador é a sua ferramenta gémea para isso.
- Incorporar listas de reprodução. Uma ligação de lista é rejeitada. A incorporação de listas é outra função com o seu próprio conjunto de parâmetros, deliberadamente fora do âmbito de uma ferramenta de vídeo único.
- Editar o título do iframe. O atributo title mantém o "YouTube video player" oficial do YouTube. Os leitores de ecrã obtêm um rótulo consistente e a saída corresponde ao que o próprio YouTube publica.
- Eliminar os vídeos relacionados. Nenhum parâmetro pode fazê-lo, veja as perguntas frequentes.
- Forçar a reprodução automática. Os navegadores bloqueiam-na, e a ferramenta não adicionará mute à sua incorporação em silêncio.
- Carregar ou guardar algo. A geração é 100 % local, veja a secção seguinte.
Solução de problemas
| Problema | Causa provável | Solução |
|---|---|---|
| A pré-visualização mostra a mensagem "vídeo indisponível" do YouTube | O vídeo foi eliminado, é privado ou tem restrição regional | A incorporação falhará igualmente no seu site, escolha outro vídeo |
| A reprodução automática não arranca | Os navegadores bloqueiam a reprodução automática com som | Adicione &mute=1 à src gerada |
| O vídeo reproduz-se uma vez e para | loop=1 perdeu o seu parceiro playlist numa edição manual | Mantenha loop=1&playlist=VIDEO_ID juntos ou regenere |
| A hora de início ou fim é ignorada | O fim vem antes do início, ou o trecho excede a duração do vídeo | Verifique a ordem das suas horas e a duração do vídeo |
| O leitor não renderiza no meu site | A política de segurança de conteúdo do seu site bloqueia iframes | Adicione frame-src https://www.youtube-nocookie.com https://www.youtube.com à sua CSP |
| O leitor renderiza mas faltam os controlos | O interruptor de controlos está desativado | Ative "Mostrar controlos do leitor" e regenere |
| Premir Gerar não faz nada | O URL não contém um ID de vídeo | Use um dos formatos aceites da tabela acima |
Privacidade e tratamento de dados
A ferramenta situa-se na categoria mais limpa do espetro de privacidade do site, zero pedidos durante a geração.
- A geração é totalmente local. O URL é analisado no seu navegador e o iframe é montado lá. Nenhum pedido é enviado para um servidor Toollect e nada é registado.
- A pré-visualização carrega um leitor real. Enquanto a pré-visualização está aberta, o seu navegador fala com o domínio de incorporação do YouTube, como em qualquer página que incorpore o vídeo.
- O anfitrião padrão é respeitador da privacidade. O código gerado usa www.youtube-nocookie.com, onde o YouTube não guarda informações sobre visitantes a menos que reproduzam o vídeo. Desativar a opção de privacidade muda para www.youtube.com, o mesmo leitor com o comportamento de rastreio habitual, que é o que o diálogo oficial produz sempre.
Especificações técnicas
- Formatos de entrada – URLs watch, embed, Shorts, live e /v/, youtu.be, URLs do domínio sem cookies e IDs de vídeo avulsos de 11 caracteres.
- Saída – uma única etiqueta iframe com dimensões explícitas, título de acessibilidade, política de permissões e allowfullscreen.
- Parâmetros suportados – autoplay, loop + playlist, controls, start, end e a mudança de anfitrião do modo sem cookies.
- Proporções – predefinições 16:9, 4:3, 3:4, 9:16 e 1:1, mais um modo personalizado livre, a dimensão oposta é calculada com arredondamento ao píxel.
- Intervalo de tamanhos – de 144 a 3840 píxeis em ambos os eixos.
- Processamento – totalmente no navegador, sem pedidos de rede durante a geração.
- Compatibilidade de navegadores – qualquer navegador moderno, e o código gerado funciona em qualquer navegador que renderize iframes, ou seja, todos.
Recursos
- Gera código iframe de incorporação do YouTube a partir de qualquer URL de vídeo ou de um ID de vídeo avulso com um clique
- Predefinições de proporção, como 16:9, 4:3, 3:4, 9:16 para Shorts, 1:1 e personalizada, com a dimensão oposta calculada automaticamente
- Domínio youtube-nocookie.com respeitador da privacidade como padrão
- Corta vídeos sem edição, com hora de início e fim em horas:minutos:segundos
- Opções de reprodução automática, repetição e controlos do leitor, com pré-visualização ao vivo antes de copiar
- Geração 100 % no navegador, sem chave de API, sem conta, sem carregamentos