O que é a API do YouTube?

A API do YouTube e uma familia de interfaces que a Google pública para programadores: a Data API para ler informação de vídeos, canais e playlists, e a IFrame Player API para controlar um leitor incorporado com JavaScript (reproduzir, pausar, avancar, e escutar eventos).

Precisa dela para uma incorporação simples?

Não. Uma incorporação simples, do tipo produzido pelo gerador de código de incorporação deste site, não precisa de mais nada além de um <iframe> padrão e não exige uma chave de API, um projeto Google Cloud ou qualquer JavaScript.

Quando se torna útil

Vale a pena recorrer a IFrame Player API assim que precisar de comportamento personalizado, como um botao de reproduzir controlado por JavaScript, seguir o progresso de visualização em análises, ou sincronizar vários leitores incorporados em conjunto.

As duas APIs que compoem “a API do YouTube”

O que as pessoas geralmente querem dizer com “a API do YouTube” é na verdade duas coisas relacionadas mas distintas. A YouTube Data API permite a um programador ler (e, com as permissões certas, escrever) informação programaticamente sobre vídeos, canais, playlists e comentarios, útil para construir coisas como uma ferramenta de pesquisa de vídeo personalizada ou um painel de canal. A YouTube IFrame Player API é diferente: permite a um programador controlar um leitor já incorporado com JavaScript, reproduzindo, pausando, avancando, ajustando o volume, e escutando eventos como “vídeo terminou,” sem precisar de nenhuma da autenticação ou sistema de quota da Data API.

Um exemplo prático de quando cada API e realmente necessária

Um site que simplesmente mostra um vídeo fixo numa página não precisa de nenhuma API; um código de incorporação padrão, como os produzidos pelo nosso gerador de código de incorporação, e suficiente por si só. Um site que precisa de um botao personalizado “reproduzir tudo” controlando vários leitores incorporados em conjunto, ou que quer registar eventos de análise quando um visitante realmente termina de ver um vídeo, recorreria especificamente a IFrame Player API. Um site a construir uma biblioteca de vídeo pesquisável, extraindo metadados de muitos canais, usaria a Data API em vez disso, ou adicionalmente.

API do YouTube vs. uma incorporação simples

A distinção prática e controlo versus simplicidade. Uma incorporação simples, sem API envolvida, é um único trecho HTML sem dependência de JavaScript, sem chave de API, e sem quota de uso a gerir, razão pela qual contínua a ser a escolha certa para a esmagadora maioria dos sites que apenas precisam de mostrar um vídeo. Recorrer a qualquer uma das APIs do YouTube só faz sentido quando os requisitos de um projeto realmente vao além do que os parâmetros de consulta num URL de incorporação padrão conseguem alcançar.

Perguntas frequentes