Metadados do YouTube

O que o oEmbed retorna e omite

oEmbed é um pequeno padrão público que os sites usam para descrever um link, permitindo que outro site o incorpore. Para um vídeo do YouTube, ele fornece o título, o nome do canal e sua URL, um player pronto em <iframe> e uma miniatura: a imagem hqdefault de 480 × 360. Isso basta para criar um cartão de link ou verificar a qual canal um link pertence.

Ele não inclui o número de visualizações, a data de envio, a duração, as tags nem a descrição. Esses dados vêm da YouTube Data API, que exige uma chave de API; apenas para a descrição, o extrator de descrição a lê na página pública de exibição.

Quando a consulta falha

Um vídeo privado, excluído ou digitado incorretamente não retorna nada. O mesmo acontece com um vídeo cujo proprietário desativou a incorporação, porque o oEmbed só descreve vídeos que podem ser incorporados em outros sites. Vídeos não listados geralmente funcionam, já que qualquer pessoa com o link pode assisti-los. Se um link que funciona no YouTube falhar aqui, as restrições de incorporação são a causa mais provável; o gerador de incorporação produzirá então um player que também exibirá um erro em outros sites.

Como usar

1. Cole uma URL pública do YouTube ou o ID do vídeo.
2. Escolha “Ler metadados”.
3. Veja o título, o canal, a miniatura, o ID do vídeo e os links.

Privacidade e limitações

A URL é enviada para a API da TOEA e para o endpoint público de metadados do YouTube. A TOEA não a armazena, não faz login no YouTube nem expõe informações privadas de vídeos.