Guía de aspectos generales del API

Las herramientas y las API de YouTube permiten incluir la experiencia de YouTube en tu página web, en tu aplicación o en tu dispositivo. El API de datos permite realizar la mayoría de las acciones que un usuario normal de YouTube puede llevar a cabo en el sitio web de YouTube. Las API del reproductor permiten controlar el reproductor de YouTube a través de JavaScript o de ActionScript. Existe un reproductor insertado básico, que es el que sueles ver, y un reproductor sin bordes con el que podrás crear tus propios controles del reproductor. Por último, se incluyen los widgets y un reproductor personalizado que puedes insertar en tu página web aunque no seas programador web.

Lo primero que debes hacer es decidir cuál de nuestras API y de nuestras herramientas se adapta mejor a tus necesidades. Si estás familiarizado con el lenguaje HTML, pero no has utilizado mucho JavaScript, puedes consultar los widgets y el reproductor personalizado. Si te sientes cómodo con JavaScript o con Flash, consulta las API del reproductor. Si vas a programar un dispositivo o una lógica de servidor para un sitio web, consulta el API de datos. En la siguiente tabla se intenta proporcionar una descripción del nivel de experiencia de un desarrollador para cada opción:

Widgets

Los widgets son componentes de JavaScript que puedes incluir en tu página web para mejorarla con una amplia colección de contenido de YouTube. A diferencia del reproductor personalizado, los widgets están destinados a aquellos usuarios que estén familiarizados con el leguaje HTML y con JavaScript, pero que es posible que no lo estén con la programación de servidor. Actualmente los dos widgets que están disponibles son la barra de vídeos y el control de búsqueda de vídeos.

Barra de vídeos

La barra de vídeos es una manera sencilla de disponer de una tira de miniaturas de vídeo en tu sitio. Una vez que hayas hecho clic en una miniatura de vídeo, se abrirá un reproductor flotante para poder reproducir el vídeo en tu sitio. Existe un asistente sencillo con el que puedes empezar a trabajar, así como una guía de programación que te ayudará a realizar los ajustes que desees. Asegúrate de leer la sección sobre las funciones específicas de YouTube.

Control de búsqueda de vídeos

El control de búsqueda de vídeos añade a tu sitio las funciones del API AJAX de Google para búsquedas y te permite buscar en todo el contenido de YouTube. Cada cuadro de búsqueda está configurado previamente con un conjunto de etiquetas definidas por el usuario y muestra las miniaturas de los resultados de vídeos. De este modo, es posible reproducir los vídeos sin salir de la página. Utiliza el asistente para empezar y, a continuación, consulta la guía de programación para saber cómo personalizar el reproductor con CSS, realizar búsquedas automáticas basadas en enlaces de sitios, guardar búsquedas de usuarios y otras muchas cosas.

Reproductor personalizado

En ocasiones, conviene controlar tu sitio web sin tener que editarlo. Muchos sitios web se benefician del contenido de vídeo que ofrecen, pero la actualización de este contenido puede resultar una tarea difícil. Aquí es donde entra en juego el reproductor personalizado de YouTube. Puedes personalizar un reproductor de YouTube e incluir en él los vídeos que especifiques. Una vez que el reproductor personalizado se encuentre en tu sitio, podrás actualizar fácilmente su aspecto o su contenido. Para ello, deberás acceder a tu cuenta de YouTube y hacer clic en Reproductores de vídeo personalizados.

Al crear un reproductor personalizado, puedes elegir entre distintos temas para el reproductor. El reproductor personalizado puede reproducir todos los vídeos de tu canal de YouTube, todos tus vídeos favoritos o cualquier lista de reproducción personalizada que hayas creado. Al crear listas de reproducción y al cargarlas en un reproductor personalizado, puedes controlar fácilmente el contenido que aparece en tu sitio web sin salir de YouTube.

API del reproductor

Las API del reproductor permiten controlar cómo se ven los vídeos de YouTube en tu sitio. Lo primero que debes tener en cuenta es que existen dos tipos de reproductores: el reproductor "insertado" normal, que es el que se ve en la Web, y el reproductor "sin bordes", que es solo un cuadro de vídeo que no tiene controles. El reproductor sin bordes está diseñado para programadores web con experiencia que quieren diseñar su propio reproductor de vídeo. Estos dos reproductores tienen las mismas API que aparecen en JavaScript y en ActionScript.

En las siguientes secciones se describe cada tipo de reproductor y su uso:

Reproductor insertado

El reproductor insertado es la forma más sencilla de incluir un vídeo de YouTube en una página web. Para personalizar el comportamiento y el color del reproductor, puedes utilizar los parámetros del reproductor que se describen en la documentación. El código para mostrar este reproductor se puede generar rápidamente desde un programa, lo que permite buscar un vídeo mediante el API de datos y, a continuación, mostrarlo con el reproductor insertado.

Una vez que el reproductor insertado se haya incluido en una página web, se podrá controlar mediante JavaScript. Además, si insertas el reproductor en una aplicación Flash, puedes utilizar ActionScript en su lugar. El uso de cualquiera de estos sistemas permite realizar acciones similares a las que puede llevar a cabo el usuario al hacer clic en los controles como, por ejemplo, poner en pausa el vídeo, avanzar su reproducción o silenciarlo. También puedes conocer el estado del reproductor y detectar eventos para que tu código pueda reaccionar ante cualquier acción que realice el reproductor.

Reproductor sin bordes

En ocasiones, los controles y los elementos de interfaz situados alrededor del contenido se conocen como "borde" (por ejemplo, los botones del navegador de la parte superior de una página web). Por definición, el reproductor sin bordes es un vídeo de YouTube sin controles. Por ello, resulta fácil personalizarlo en Flash o en HTML.

El reproductor sin bordes muestra las mismas API de JavaScript y de ActionScript que el reproductor insertado. La demostración del reproductor permite obtener una vista previa de los reproductores sin bordes e insertado a través de JavaScript, así como algunos controles HTML sencillos. También puedes utilizar Google Code Playground para depurar y ejecutar el código del reproductor JavaScript.

API de datos

El API de datos permite a un programa realizar muchas de las operaciones disponibles en el sitio web de YouTube. Es posible realizar búsquedas de vídeos, recuperar feeds estándar y ver contenido relacionado. Un programa también se puede autenticar como un usuario para subir vídeos y modificar las listas de reproducción de un usuario, entre otras muchas cosas.

El API de datos está diseñada principalmente para desarrolladores acostumbrados a programar en lenguajes de servidor. Resulta muy útil para los sitios o para las aplicaciones que quieren una mayor integración con YouTube. Esta integración puede ser una aplicación web que permita a los usuarios subir vídeos a YouTube. También puede ser un dispositivo o una aplicación de escritorio que incluya la experiencia de YouTube en una nueva plataforma. El API de datos ofrece acceso automático a la información sobre vídeos y sobre usuarios almacenada en YouTube. Con esta API, puedes personalizar tu sitio o tu aplicación con la información existente del usuario, así como llevar a cabo acciones en su nombre (por ejemplo, realizar comentarios y puntuar vídeos).

Para obtener más información sobre cómo funciona el API de datos en un nivel básico con XML y con HTTP, consulta la guía de protocolo. En esta guía podrás encontrar información detallada sobre las solicitudes y sobre las respuestas que los servidores del API de YouTube esperan y devuelven. Para obtener más información sobre la estructura de estas solicitudes y de estas respuestas, consulta la Guía de referencia. En esta guía se definen los tipos de feeds del API, los parámetros de solicitud HTTP, los códigos de respuesta HTTP y los elementos XML. También puedes consultar el protocolo de datos de Google y el protocolo de publicación de contenido Atom Publishing Protocol, que son los estándares en los que se ha basado la creación del API de datos.

Para facilitar el trabajo con el API, disponemos de varias bibliotecas cliente que resumen el API en un modelo de objeto específico del lenguaje. Estas bibliotecas cliente son de software libre y se pueden utilizar y modificar en virtud de la licencia de Apache 2.0. Existen guías para desarrolladores para Java, para .NET, para PHP y para Python, así como códigos de ejemplo.