Nota: Cumplir con las Políticas para Desarrolladores de YouTube proporciona orientación y ejemplos para ayudarte a asegurarte de que tus clientes de la API sigan partes específicas de las Condiciones y las Políticas (Condiciones del Servicio de la API) de los Servicios de la API de YouTube. La guía ofrece información sobre cómo YouTube aplica ciertos aspectos de las Condiciones del Servicio de la API, pero no reemplaza ningún documento existente.
En este documento, se definen los requisitos funcionales mínimos para los clientes de la API que implementan o proporcionan acceso a funciones específicas de los servicios de la API de YouTube ("Clientes de la API").
Estos requisitos y lineamientos garantizan que los clientes de la API proporcionen una experiencia del usuario coherente que proteja los intereses de los usuarios, los propietarios de contenido y los anunciantes de YouTube. Estas reglas son una parte integral de las Condiciones del Servicio de la API de YouTube y se deben seguir en el desarrollo y la implementación de cualquier cliente de API.
Es posible que los requisitos de este documento cambien para garantizar una mejor experiencia del usuario con las funciones existentes de YouTube. También cambiarán en función de las funciones nuevas y actualizadas de YouTube. En ocasiones, es posible que estos cambios requieran que actualices tus clientes de API para abordar nuevos requisitos. En el historial de revisiones de las Condiciones del Servicio, se documentarán todos los cambios, por lo que debes consultar ese documento con frecuencia o suscribirte a su feed RSS para asegurarte de conocer rápidamente los cambios que puedan afectar a tus clientes de la API.
Además de los requisitos de este documento, te recomendamos que sigas las prácticas recomendadas que se describen en las Políticas de los Servicios de la API de YouTube y que se mencionan en otros lugares de la documentación de los servicios de la API de YouTube. Incluso cuando no son estrictamente necesarias, estas prácticas ayudan a que tus clientes de la API se recuperen más rápido de los errores y optimicen el uso de la cuota si usan servicios de la API de YouTube que asignan cuota. Al mismo tiempo, estas prácticas ayudan a garantizar el estado del ecosistema de YouTube y, sobre todo, a proporcionar la mejor experiencia posible a los usuarios de tus clientes de API y de las aplicaciones de YouTube.
Reproductor incorporado de YouTube y reproducción de video
Los requisitos de esta sección se relacionan específicamente con los reproductores de YouTube incorporados. Las Políticas de los Servicios de la API de YouTube también incluyen varias políticas relevantes para los clientes de la API que reproducen contenido audiovisual de YouTube.
Tamaño del reproductor de YouTube incorporado
Los reproductores insertados deben tener una ventana gráfica de al menos 200 px por 200 px. Si el reproductor muestra controles, debe tener el tamaño suficiente para mostrar los controles por completo, sin reducir la ventana gráfica por debajo del tamaño mínimo. Recomendamos que los reproductores de 16:9 tengan al menos 480 píxeles de ancho y 270 píxeles de alto.
Reproducción automática y con secuencias de comandos
En esta sección, se abordan las reproducciones automáticas. Se aplica a los reproductores incorporados de YouTube que usan el parámetro del reproductor autoplay o inician la reproducción automática de forma programática con el servicio de la API de YouTube IFrame Player o con otro servicio de la API de YouTube.
-
Los reproductores incorporados que reproducen un video automáticamente deben iniciar la reproducción de inmediato cuando se carga la página o en cuanto el reproductor incorporado esté completamente visible. Sin embargo, un cliente de API no debe iniciar una reproducción automática hasta que el reproductor esté visible y más de la mitad del reproductor esté visible en la página o la pantalla.
-
Una página o pantalla no debe tener más de un reproductor de YouTube que reproduzca contenido automáticamente de forma simultánea.
-
Las miniaturas de YouTube que inician una reproducción deben tener al menos 120 píxeles de ancho y 70 píxeles de alto.
Atributos del reproductor de YouTube
Los atributos y parámetros del reproductor de YouTube, incluida la apariencia del desarrollo de la marca de YouTube en el reproductor, se especifican en la documentación y las especificaciones de la API de YouTube (https://developers.google.com/youtube). No debes realizar cambios en el reproductor de YouTube que no se describan de forma explícita en la documentación de la API.
Superposiciones y marcos
No debes mostrar superposiciones, marcos ni otros elementos visuales frente a ninguna parte de un reproductor de YouTube incorporado, incluidos los controles del reproductor. Del mismo modo, no debes usar superposiciones, marcos ni otros elementos visuales para ocultar ninguna parte de un reproductor incorporado, incluidos los controles del reproductor.
Deslizamientos del mouse sobre zonas activas
No debes usar eventos de desplazamiento del mouse ni de toque en un reproductor de YouTube para iniciar ninguna acción en nombre del usuario, como abrir una ventana o suscribirte a un canal.
Sube videos
Si los clientes de la API permiten que los usuarios suban contenido a varias plataformas, estos deben poder seleccionar y anular la selección de las plataformas a las que desean subir sus videos.
Requisitos de los datos
Los clientes de API que permiten a los usuarios subir videos a YouTube deben permitir que los usuarios establezcan los valores de la siguiente lista. Las propiedades que no aparecen en la lista son opcionales.
| Nombre | Descripción | |
|---|---|---|
| Propiedades de recursos | ||
snippet.title |
Obligatorio. Título del video. YouTube muestra un error si el valor supera los 100 caracteres. YouTube admite todos los caracteres UTF-8 válidos, excepto < y >.
| |
snippet.description |
Obligatorio. Descripción del video. YouTube muestra un error si el valor supera los 5,000 bytes. YouTube admite todos los caracteres UTF-8 válidos, excepto < y >. |
|
status.privacyStatus |
Obligatorio. La configuración de privacidad del video Los usuarios deben poder elegir si el video subido será público, privado o no listado. | |
| Parámetros de solicitud | ||
onBehalfOfContentOwnerChannel |
Condicionalmente obligatorio. Si las credenciales de autorización de la solicitud identifican a un propietario de contenido y se establece el parámetro onBehalfOfContentOwner, el usuario de la API también debe poder especificar el canal de YouTube al que se subirá el video. |
|
Cómo mostrar comentarios
| Nombre | Descripción | |
|---|---|---|
| Propiedades de recursos | ||
snippet.textDisplay |
Obligatorio. El texto del comentario. El cliente de la API debe (a) mostrar el texto completo de un comentario o una respuesta a un comentario, o bien (b) truncar el texto y proporcionar una forma para que el usuario acceda fácilmente al texto completo desde la versión truncada. Este requisito se aplica a todos los comentarios y respuestas a los comentarios, independientemente del tipo de recurso con el que estén asociados (videos, canales, etcétera). Ten en cuenta que el valor de la propiedad snippet.topLevelComment del recurso commentThread es un recurso comment y la propiedad replies.comments[] es una lista de recursos comment. Por lo tanto, este requisito también se aplica a las propiedades snippet.topLevelComment.snippet.textDisplay y replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Obligatorio (sugerencia). El título del canal.
|
|
snippet.title( video) |
Condicionalmente obligatorio (sugerencia). Título del video. Este valor se debe mostrar si el comentario se relaciona con un video. | |
snippet.moderationStatus |
Condicionalmente obligatorio. Si el valor del parámetro moderationStatus en la solicitud a la API es heldForReview o likelySpam, la pantalla debe identificar claramente ese estado con el valor de la propiedad, un lenguaje similar (p.ej., "Este comentario se retendrá para su revisión"), un encabezado (p.ej., "Retendrá para su revisión") o cualquier otro lenguaje no ambiguo. El método commentThreads.list admite la capacidad de recuperar comentarios según su estado de moderación. |
|
Cómo agregar comentarios
| Nombre | Descripción | |
|---|---|---|
| Propiedades de recursos | ||
snippet.title( channel) |
Obligatorio. El título del canal.
|
|
snippet.title( video) |
Obligatorio. Si el usuario agrega un comentario sobre un video, el cliente de la API debe mostrar el título del video. | |
| Otros requisitos | ||
Comment author's channel name |
Obligatorio. El cliente de la API debe identificar claramente la cuenta de usuario de YouTube a la que se atribuirá el comentario. Si las credenciales de autorización de la solicitud identifican a un propietario del contenido y se establece el parámetro onBehalfOfContentOwner, el usuario de la API también debe poder especificar el canal de YouTube al que se atribuirá el comentario. |
|
Cómo agregar respuestas a los comentarios
| Nombre | Descripción | |
|---|---|---|
| Propiedades de recursos | ||
snippet.textDisplay |
Obligatorio. El texto del comentario. El cliente de la API debe mostrar el texto del comentario al que el usuario responde de acuerdo con las reglas definidas en la sección Cómo mostrar comentarios de este documento. | |
snippet.title( channel) |
Obligatorio. El título del canal.
|
|
snippet.title( video) |
Obligatorio. Si el usuario responde un comentario sobre un video, el cliente de la API debe mostrar el título del video. | |
| Otros requisitos | ||
Comment author's channel name |
Obligatorio. El cliente de la API debe identificar claramente la cuenta de usuario de YouTube a la que se atribuirá la respuesta al comentario. Si las credenciales de autorización de la solicitud identifican a un propietario del contenido y se establece el parámetro onBehalfOfContentOwner, el usuario de la API también debe poder especificar el canal de YouTube al que se atribuirá la respuesta al comentario. |
|
Cómo editar o borrar respuestas a comentarios
| Nombre | Descripción | |
|---|---|---|
| Propiedades de recursos | ||
snippet.textDisplay |
Obligatorio. El texto del comentario. El cliente de la API debe mostrar el texto del comentario que el usuario edita o borra de acuerdo con las reglas definidas en la sección Cómo mostrar comentarios de este documento. | |
snippet.title( channel) |
Obligatorio. El título del canal.
|
|
snippet.title( video) |
Obligatorio. Si el usuario edita o borra un comentario sobre un video, el cliente de la API debe mostrar el título del video. | |
| Otros requisitos | ||
Comment author's channel name |
Obligatorio. El cliente de la API debe identificar claramente la cuenta de usuario de YouTube a la que se atribuye el comentario. | |
Cómo bloquear a un usuario del chat en vivo (o quitar un bloqueo)
| Nombre | Descripción | |
|---|---|---|
| Propiedades de recursos | ||
snippet.title( channel) |
Obligatorio. Es el nombre del canal de YouTube que se banea o se desbanea. Además, el nombre debe vincularse al canal o debe mostrarse la URL del canal. | |
| Otros requisitos | ||
| Nombre del canal del autor del comentario | Obligatorio. El cliente de la API debe identificar claramente la cuenta de usuario de YouTube que se usa para agregar o quitar la prohibición. | |