Nota: En Cumplimiento de las Políticas para Desarrolladores de YouTube, se proporcionan lineamientos y ejemplos que te ayudarán a garantizar que tus clientes de la API sigan partes específicas de las Condiciones y las Políticas de los Servicios de la API de YouTube. Esta 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 API que implementan o brindan acceso a funciones específicas de los servicios de la API de YouTube (“Clientes de API”).
Estos requisitos y lineamientos garantizan que los clientes de la API brinden una experiencia del usuario coherente que proteja los intereses de los usuarios, propietarios del contenido y anunciantes de YouTube. Estas reglas son una parte integral de las Condiciones del Servicio de la API de YouTube y deben seguirse en el desarrollo y la implementación de todos los Clientes de la API.
Es posible que los requisitos que se mencionan en este documento cambien para que podamos garantizar mejores experiencias del usuario con las funciones existentes de YouTube. También cambiarán en respuesta a las funciones nuevas y actualizadas de YouTube. En ocasiones, es posible que esos cambios requieran que actualices tus clientes de API para abordar nuevos requisitos. En el historial de revisión de las Condiciones del Servicio, se documentarán los cambios. Por lo tanto, revisa ese documento con frecuencia o suscríbete a su feed RSS para asegurarte de aprender rápidamente sobre 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 servicios de la API de YouTube y que se tratan en otras secciones de la documentación de los servicios de la API de YouTube. Incluso cuando no sean estrictamente obligatorias, estas prácticas ayudan a tus clientes de la API a recuperarse más rápido de los errores y a optimizar el uso de la cuota si utilizan los servicios de la API de YouTube que asignan cuotas. Al mismo tiempo, estas prácticas ayudan a garantizar el buen 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.
Reproducción de video y reproductor incorporado de YouTube
Los requisitos de esta sección se refieren específicamente a los reproductores incorporados de YouTube. Las Políticas de 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 describen las reproducciones automáticas. Se aplica a los reproductores incorporados de YouTube que usan el parámetro del reproductor autoplay o que inician la reproducción automática de manera programática mediante el servicio de la API del reproductor IFrame de YouTube, el servicio de la API del reproductor de YouTube para Android o algún otro servicio de la API de YouTube.
-
Los reproductores incorporados que reproducen un video automáticamente deben comenzar 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 pantalla.
-
Una página o pantalla no debe tener más de un reproductor de YouTube que reproduzca contenido de forma simultánea y automática.
-
Cualquier miniatura de YouTube que inicie una reproducción debe 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, por ejemplo, la apariencia de la marca de YouTube en el reproductor, se especifican en la documentación y especificaciones de la API de YouTube (https://developers.google.com/youtube). No debes realizar cambios en el reproductor de YouTube que no se describan explícitamente en la documentación de la API.
Superposiciones y marcos
No está permitido mostrar superposiciones, fotogramas ni otros elementos visuales frente a ninguna parte del reproductor incorporado de YouTube, incluidos sus controles. Del mismo modo, no debe usar superposiciones, marcos ni otros elementos visuales para ocultar ninguna parte de un reproductor incorporado, incluidos sus controles.
Deslizamientos del mouse sobre zonas activas
No debes desplazar el mouse sobre un anuncio ni eventos táctiles en un reproductor de YouTube para iniciar acciones en nombre del usuario, como abrir una ventana o suscribirse 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 la API que permiten a los usuarios subir videos a YouTube deben habilitar la opción users para establecer los valores de la siguiente lista. Las propiedades que no estén en la lista son opcionales.
| Nombre | Descripción | |
|---|---|---|
| Propiedades de los recursos | ||
snippet.title |
Obligatorio: Título del video. YouTube mostrará 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 mostrará 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 que subieron será público, privado o no listado. | |
| Parámetros de la solicitud | ||
onBehalfOfContentOwnerChannel |
Condicionalmente obligatorio. 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 está subiendo el video. |
|
Mostrando comentarios
| Nombre | Descripción | |
|---|---|---|
| Propiedades de los 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 de comentario, o (b) truncar el texto y permitir que el usuario acceda fácilmente a todo el texto desde la versión truncada. Este requisito se aplica a todos los comentarios y respuestas a comentarios, independientemente del tipo de recurso con el que estén asociados (videos, canales, etc.). Ten en cuenta que el valor de propiedad snippet.topLevelComment del recurso commentThread es un recurso comment y la propiedad replies.comments[] es un recurso 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). Título del canal.
|
|
snippet.title( video) |
Condicionalmente obligatorio (sugerencia). Título del video. Este valor se debe mostrar si el comentario está relacionado 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 está pendiente de revisión"), un encabezado (p.ej. "Pendiente de revisión") o cualquier otro lenguaje que no dé lugar a ambigüedades. 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 los recursos | ||
snippet.title( channel) |
Obligatorio: 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. |
|
Agregando respuestas a los comentarios
| Nombre | Descripción | |
|---|---|---|
| Propiedades de los recursos | ||
snippet.textDisplay |
Obligatorio: El texto del comentario. El cliente de la API debe mostrar el texto del comentario al que el usuario responde según las reglas definidas en la sección Cómo mostrar comentarios de este documento. | |
snippet.title( channel) |
Obligatorio: Título del canal.
|
|
snippet.title( video) |
Obligatorio: Si el usuario responde a 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 los recursos | ||
snippet.textDisplay |
Obligatorio: El texto del comentario. El cliente de la API debe mostrar el texto del comentario que el usuario está editando o borrando según las reglas definidas en la sección Mostrar comentarios de este documento. | |
snippet.title( channel) |
Obligatorio: Título del canal.
|
|
snippet.title( video) |
Obligatorio: Si el usuario está editando o borrando 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. | |
Bloquear a un usuario en el chat en vivo (o quitarle la prohibición)
| Nombre | Descripción | |
|---|---|---|
| Propiedades de los recursos | ||
snippet.title( channel) |
Obligatorio: El nombre del canal de YouTube que se bloqueó o se desbloqueó. Además, el nombre debe vincularse al canal o también se debe mostrar 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 utiliza para agregar o quitar el bloqueo. | |