Vídeo e legendas · Downloader de miniaturas do YouTube e visualizador de metadados
Como funciona uma solicitação de miniatura do YouTube: ID do vídeo, nome do tamanho e i.ytimg.com
· Como funciona
YouTube miniaturas http
As miniaturas do YouTube ficam em endereços previsíveis criados a partir do ID do vídeo e de um nome de tamanho. Este post explica como essas solicitações são formadas, o que volta e por que uma ferramenta pode listar todos os tamanhos sem mexer no vídeo em si.
Você tem um link e precisa da imagem – a tarefa diária por trás dos downloads de miniaturas
Um editor de boletim informativo geralmente começa com um link de exibição e precisa de uma imagem de visualização confiável, não do stream de vídeo. A unidade útil é o ID do vídeo de onze caracteres, porque cada endereço de miniatura pública é montado a partir desse ID e de um nome de arquivo conhecido. Registrar esse ID permite que o editor vincule cada verificação de tamanho a um vídeo, mesmo quando o compartilhamento original URL contém parâmetros de rastreamento ou carimbo de data/hora.
ToolAcre analisa o link colado no navegador antes de qualquer solicitação ser feita. Essa etapa local separa a compreensão da entrada da busca de ativos públicos, de modo que um host inválido ou um ID malformado possa ser rejeitado sem entrar em contato com o Google. Em um log de solicitação, uma colagem inválida não deve, portanto, produzir nenhuma entrada i.ytimg.com; apenas um ID validado avança para a sondagem de imagem.
O host da imagem: i.ytimg.com — onde as miniaturas são veiculadas e por que é separado de youtube.com
Os arquivos de imagem vêm de i.ytimg.com e não do host da página de observação. Manter pôsteres estáticos em um host de imagem permite que um cliente solicite um JPEG diretamente, sem carregar o player, recomendações, comentários ou a página JavaScript. Conseqüentemente, a resposta pode ser avaliada como uma imagem por si só, sem interpretar a marcação do jogador ou aguardar a inicialização de uma página de exibição completa.
Um host de imagem direto ainda é um serviço de rede, não um processamento local. Bloqueadores de anúncios, modo off-line, proxies gerenciados ou política DNS podem interromper a solicitação, e o Google recebe a solicitação mais o cabeçalho Origin fornecido pelo navegador. O DevTools pode provar para onde foi a solicitação, enquanto a decodificação da resposta fornece a evidência separada necessária para distinguir a arte do pequeno substituto do YouTube.
O padrão de endereço — ID do vídeo mais um nome de tamanho como default, mqdefault, hqdefault, sddefault ou maxresdefault
O padrão implementado é https://i.ytimg.com/vi/VIDEO_ID/VARIANT.jpg. ToolAcre substitui um de maxresdefault, sddefault, hqdefault, mqdefault, default, hq1, hq2 ou hq3 após validar o formato do ID. Sondar todos os nomes evita que uma resposta 200 carregue um pequeno substituto de conquistar prematuramente uma variante diferente que contém arte utilizável.
Esses oito nomes incluem cinco opções de pôsteres e três fotos. O catálogo registra dimensões nominais e finalidade, mas o navegador ainda verifica o arquivo retornado porque nem todo vídeo publica todos os tamanhos opcionais. Uma linha informa o que o vídeo realmente retornou para esse nome, o que pode ser diferente do tamanho que o catálogo associa a um upload totalmente preenchido.
O que a resposta prova: status, bytes e dimensões decodificadas juntos
O esboço tratou o status HTTP como prova de que existe um tamanho, mas a implementação corrige essa afirmação. Um candidato ausente pode ser um erro 404, outro erro HTTP ou uma resposta 200 bem-sucedida contendo o espaço reservado 120×90 do YouTube. Um relatório datado captura a resposta fornecida a um navegador desconectado nessa execução; não pode reconstruir um cartaz mais antigo que anteriormente ocupou o mesmo caminho previsível.
ToolAcre lê o corpo como um Blob e decodifica suas verdadeiras dimensões. Um corpo não decodificável é um erro, enquanto um resultado 120×90 para uma variante maior é marcado como ausente; status, dimensões e bytes descrevem, portanto, evidências diferentes. Como a imagem vem diretamente do Google, essa validação melhora a precisão sem tornar a pesquisa secreta do serviço que a forneceu.
Exemplo resolvido: criação de todas as oito solicitações JPEG para um vídeo
Para um ID válido, a ferramenta cria oito URLs JPEG em vez dos cinco indicados na descrição. Ele investiga os nomes dos cinco pôsteres mais hq1, hq2 e hq3, preservando a ordem do catálogo para que o maior pôster pretendido seja considerado primeiro. Um editor pode, portanto, comparar a arte principal do upload com suas três posições de quadro capturadas, em vez de confundir essas fotos com resoluções alternativas de pôster.
Uma solicitação pode gerar 1280×720, outra 480×360 e uma opcional pode retornar um espaço reservado ou 404. A listagem relata cada resultado, em vez de fingir que uma sequência substituta pode certificar cada upload. Essa evidência lado a lado é especialmente útil quando um upload mais antigo tem um pôster de definição padrão, mas nenhum arquivo genuíno de resolução máxima.
Por que isso nunca afeta o vídeo – as miniaturas são arquivos públicos separados, não fazem parte do stream
Uma solicitação de miniatura nunca solicita bytes de vídeo ou áudio. Ele aborda um arquivo de imagem pública separado e a ferramenta não contém token de player, decifração de assinatura de mídia ou caminho de download de fluxo. Mesmo o maior candidato é uma resposta JPEG comum, portanto, a inspeção desses URLs não diz nada sobre formatos de mídia disponíveis, taxas de bits ou autorização de reprodução.
A separação não cria acesso. Vídeos privados, excluídos e com restrição de idade não expõem nenhum registro utilizável de usuário desconectado, e uma convenção pública de miniaturas não pode ignorar essas restrições ou recuperar um arquivo que o YouTube não publicou. O caminho previsível é apenas uma convenção de endereço; a permissão e a disponibilidade ainda são decididas por isso o host da imagem serve no momento da solicitação.
O que isso não cobre: vídeos privados, conteúdo bloqueado por região e miniaturas que foram alteradas desde a última vez que você visualizou
As miniaturas alteradas são outro limite: o previsível URL refere-se à imagem veiculada atualmente, não a uma revisão histórica. A política regional e a disponibilidade de desconectado também podem afetar o que um visitante pode obter no momento da pesquisa. Qualquer pessoa que documente uma campanha deve datar a imagem baixada, pois solicitar o mesmo caminho após uma reformulação pode retornar pixels diferentes sob um URL inalterado.
As sondagens de miniatura podem falhar na rede, por meio de respostas HTTP sem sucesso, por meio de um espaço reservado 200 ou porque o corpo não pode decodificar como uma imagem. A interface mantém essas classes de falha distintas para que a ausência não seja exagerada. Uma interrupção de proxy exige uma nova tentativa, enquanto um espaço reservado 120×90 decodificado mostra especificamente que a variante maior solicitada não foi entregue.
Conclusão: endereços previsíveis, anunciados com antecedência – como o YouTube Thumbnail Downloader lista todos os tamanhos de um link
A análise acontece antes do Fetch. Após o Fetch, o navegador envia solicitações GET anônimas, sem credenciais, sem referenciador, sem armazenamento em cache e redirecionamentos seguidos diretamente para i.ytimg.com e www.youtube.com; O Google vê essas solicitações e o cabeçalho Origin, mas nenhum servidor ToolAcre ou proxy fica entre eles. Portanto, o DevTools deve mostrar o tráfego de imagens saindo do navegador para o Google, mas nenhuma chamada ToolAcre API carregando o ID do vídeo colado.
A pesquisa oEmbed que acompanha usa um relógio canônico URL contendo o mesmo ID mais format=json. Ele pode falhar por rede, resposta HTTP ou JSON inválido, e nenhuma solicitação recupera material privado, excluído ou com restrição de idade. A evidência de miniatura e a evidência de metadados permanecem separadas: um JPEG pode estar disponível mesmo quando o registro estruturado falha e nenhuma das ramificações prova acesso duradouro.