¿Qué es la API de YouTube?

La API de YouTube es una familia de interfaces que Google publica para desarrolladores: la Data API para leer información de videos, canales y listas de reproducción, y la IFrame Player API para controlar un reproductor insertado con JavaScript (reproducir, pausar, buscar y escuchar eventos).

¿La necesitas para una inserción sencilla?

No. Una inserción simple, del tipo que produce el generador de código de inserción de este sitio, no necesita nada más que un <iframe> estándar y no requiere una clave de API, un proyecto de Google Cloud ni JavaScript.

Cuándo se vuelve útil

Vale la pena recurrir a la IFrame Player API en cuanto necesitas un comportamiento personalizado, como un botón de reproducción controlado por JavaScript, el seguimiento del progreso de visualización en analítica, o sincronizar varios reproductores insertados juntos.

Las dos API que componen “la API de YouTube”

Lo que la gente suele referir con “la API de YouTube” son en realidad dos cosas relacionadas pero distintas. La YouTube Data API permite a una desarrolladora leer mediante programación (y, con los permisos adecuados, escribir) información sobre videos, canales, listas de reproducción y comentarios, útil para construir cosas como una herramienta de búsqueda de video personalizada o un panel de canal. La YouTube IFrame Player API es diferente: permite a una desarrolladora controlar un reproductor ya insertado con JavaScript, reproducir, pausar, buscar, ajustar el volumen y escuchar eventos como “video terminado”, sin necesitar el sistema de autenticación o cuota de la Data API.

Un ejemplo práctico de cuándo se necesita realmente cada API

Un sitio que simplemente muestra un video fijo en una página no necesita ninguna de las dos API; un código de inserción estándar, como los que produce nuestro generador de código de inserción, basta por sí solo. Un sitio que necesita un botón personalizado de “reproducir todo” que controle varios reproductores insertados a la vez, o que quiere registrar eventos de analítica cuando un visitante realmente termina de ver un video, recurriría específicamente a la IFrame Player API. Un sitio que construye una biblioteca de video buscable extrayendo metadatos de muchos canales usaría en su lugar, o además, la Data API.

API de YouTube frente a una inserción simple

La distinción práctica es control frente a simplicidad. Una inserción simple, sin API, es un único fragmento HTML sin dependencia de JavaScript, sin clave de API y sin cuota de uso que gestionar, por lo que sigue siendo la opción correcta para la inmensa mayoría de sitios que solo necesitan mostrar un video. Recurrir a cualquiera de las dos API de YouTube solo tiene sentido cuando los requisitos de un proyecto van realmente más allá de lo que pueden lograr los parámetros de cadena de consulta en una URL de inserción estándar, como un control de reproducción personalizado guiado por código o la obtención masiva de metadatos.

Si no estás seguro de en qué categoría se encuentra tu proyecto, el punto de partida más seguro es una inserción simple; siempre puedes añadir más adelante un control guiado por API si surge una necesidad específica para ello.

Preguntas frecuentes