Servicios de la API de YouTube: Funcionalidad mínima requerida

Nota: La nueva guía Cómo satisfacer las Políticas para Desarrolladores de YouTube proporciona orientación y ejemplos que te ayudarán a garantizar que los clientes de las API cumplan con partes específicas de las Condiciones y las Políticas de los Servicios de la API de YouTube (Condiciones del Servicio de la API). En esta guía, se proporcionan estadísticas sobre la forma en que YouTube aplica ciertos aspectos de las Condiciones del Servicio de la API, pero no reemplaza ningún documento existente.

Este documento define los requisitos funcionales mínimos para los clientes de API que implementan o proporcionan acceso a funciones específicas de los servicios de API de YouTube ("Clientes de API").

Estos requisitos y lineamientos garantizan que los clientes de la API brinden una experiencia de usuario coherente que proteja los intereses de los usuarios, los propietarios de contenido y los anunciantes de YouTube. Estas reglas forman parte integral de las Condiciones del servicio de la API de YouTube y deben seguirse en el desarrollo y la implementación de cualquier cliente de la API.

Los cambios en este documento deberían cambiar 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. A veces, tales cambios pueden requerir que actualices tus clientes de la API para abordar los nuevos requisitos. En el historial de revisión de las Condiciones del Servicio, se documentará cualquier cambio, por lo que debes consultarlo con frecuencia o suscribirte a su feed RSS para asegurarte de que puedas obtener información rápidamente sobre los cambios que pueden afectar a tus clientes de la API.

Además de los requisitos de este documento, te sugerimos que sigas las prácticas recomendadas que se describen en las Políticas de los servicios de la API de YouTube y que se analizan en otra sección de la documentación de los servicios de la API de YouTube. Incluso cuando no sean estrictamente necesarias, 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 la cuota. Al mismo tiempo, estas prácticas ayudan a asegurar el estado del ecosistema de YouTube y, sobre todo, a proporcionar la mejor experiencia posible para los usuarios de tus Clientes de API y de las Aplicaciones de YouTube.

Reproductor insertado de YouTube y reproducción de video

Los requisitos de esta sección se relacionan específicamente con 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 reproducciones con guion

Esta sección trata sobre las reproducciones automáticas. Se aplica a los reproductores incorporados de YouTube que usan el parámetro autoplay del reproductor o que inician la reproducción automática de manera programática con el servicio de la API del reproductor de IFrame de YouTube, el servicio de la API del reproductor de YouTube para Android u otro servicio de la API de YouTube.

  • Los reproductores insertados que reproducen un video automáticamente deben iniciar la reproducción inmediatamente después de cargar la página o del reproductor insertado. Sin embargo, un cliente de la 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 puede tener más de un reproductor de YouTube que reproduzca contenido de manera automática y simultánea.

  • 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, incluido, por ejemplo, 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 estén descritos explícitamente en la documentación de la API.

Superposiciones y marcos

No debes mostrar superposiciones, marcos ni otros elementos visuales delante de ninguna parte del reproductor incorporado de YouTube, incluidos los controles del reproductor. Del mismo modo, no debes usar superposiciones, marcos u otros elementos visuales para ocultar parte de un reproductor insertado, incluidos los controles de reproductor.

Deslizamientos del mouse sobre zonas activas

No debes desplazar el mouse sobre un elemento o realizar eventos táctiles en un reproductor de YouTube para iniciar una acción en nombre del usuario, como abrir una ventana o suscribirte a un canal.

Sube videos

Si los Clientes de API permiten que los usuarios suban contenido a varias plataformas, los usuarios 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 que los usuarios suban 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 los 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 la 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 cual 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 del comentario, o bien (b) truncar el texto y proporcionar una manera para que el usuario pueda acceder 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 asociado con los comentarios (videos, canales, etc.).

Ten en cuenta que el valor snippet.topLevelComment de la propiedad snippet.topLevelComment es un recurso comment y la propiedad replies.comments[]. 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.
  • Si el comentario pertenece a un canal, el cliente de la API debe mostrar el nombre del canal.
  • Si el comentario está relacionado con un video, el cliente de API debe mostrar el nombre del canal que subió el video.
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 mediante el valor de la propiedad, un lenguaje similar (p.ej., "Este comentario está en espera de revisión"), un encabezado (p.ej., "Pendientes de revisión") u otro lenguaje 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 los recursos
snippet.title
(channel)
Obligatorio: El título del canal.
  • Si el usuario agrega un comentario sobre un canal, el cliente de la API debe mostrar el nombre del canal.
  • Si el usuario agrega un comentario acerca de un video, el cliente de la API debe mostrar el nombre del canal que subió el video.
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 cual 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 especificar el canal de YouTube al que se atribuirá el comentario.

Cómo agregar 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 que responde el usuario de acuerdo con las reglas definidas en la sección Muestra comentarios de este documento.
snippet.title
(channel)
Obligatorio: El título del canal.
  • Si el usuario responde a un comentario sobre un canal, el cliente de API debe mostrar el nombre del canal.
  • Si el usuario responde a un comentario sobre un video, el cliente de API debe mostrar el nombre del canal que subió el video.
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 cual se atribuirá la respuesta del comentario. 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 especificar el canal de YouTube al que se atribuirá la respuesta del comentario.

Edición o eliminación de las 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 que el usuario está editando o borrando de acuerdo con las reglas definidas en la sección Muestra comentarios de este documento.
snippet.title
(channel)
Obligatorio: El título del canal.
  • Si el usuario está editando o eliminando un comentario sobre un canal, el cliente de la API debe mostrar el nombre del canal.
  • Si el usuario está editando o eliminando un comentario sobre un video, el cliente de la API debe mostrar el nombre del canal que subió el video.
snippet.title
(video)
Obligatorio: Si el usuario está editando o eliminando 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 cual se atribuye el comentario.

Bloquear a un usuario del chat en vivo (o quitar al usuario como prohibición)

  Nombre Descripción
Propiedades de los recursos
snippet.title
(channel)
Obligatorio: El nombre del canal de YouTube que se prohibió o bloqueó. Además, el nombre debe vincular al canal, o bien la URL del canal debe mostrarse.
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 eliminar el bloqueo.