DocumentaciónCommerceAdministración de catálogos

Añadir vídeos del producto

Last update: Mon Jan 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Principiante
  • Intermedio
  • Administrador
  • Líder
  • Usuario

Para añadir un vídeo de producto, primero debe obtener una clave de API de su cuenta de Google e introducirla en la configuración de su tienda. A continuación, puede vincular al vídeo desde el producto.

Paso 1: Obtención de la clave de API de YouTube

  1. Inicie sesión en su cuenta de Google y visite Google Developers Console.

  2. En el campo de búsqueda en la parte superior, ingrese YouTube Data API v3 y haga clic en el icono de búsqueda.

  3. Cuando se muestre la página de la API, asegúrese de que esté activada.

  4. En el panel izquierdo, elija Credentials.

  5. Dependiendo de si tiene credenciales o no, realice una de las siguientes acciones:

    • Si ya tiene las credenciales necesarias, copie la clave en la tabla claves API.

    • Si todavía no tiene credenciales para esta API, haga clic en Create Credentials en la parte superior y siga las indicaciones para crear las credenciales necesarias. En Obtener sus credenciales, copie la clave de API y haga clic en Done.

  6. Copie la clave de API en el portapapeles.

  7. Haga clic en el icono Editar de la derecha y establezca las restricciones para asegurarse de que la clave de API esté limitada a los referentes correctos.

  8. Espere unos momentos mientras se genera la clave y, a continuación, cópiela en el portapapeles.

    En el siguiente paso, pegará la clave en la configuración de la tienda.

Paso 2: Configuración de la clave en Commerce

  1. En la barra lateral Admin, vaya a Stores > Settings>Configuration.

  2. En el panel izquierdo, expanda Catalog y elija Catalog debajo.

  3. Expanda Selector de expansión en la sección Product Video​y pegue su YouTube API key.

    Configuración de vídeo del producto {width="600" modal="regular"}

  4. Una vez finalizado, haga clic en Save Config.

  5. Cuando se le solicite, actualice la caché.

Paso 3: vincular al vídeo

  1. Abra un producto en modo de edición.

  2. Desplácese hasta y expanda la sección Images and Videos.

    Imágenes y vídeos {width="600" modal="regular"}

  3. haga clic en Add Video.

    Si todavía no ha configurado su clave de API de YouTube, haga clic en OK para continuar. No puede vincular a un vídeo de YouTube, pero puede pasar por el proceso.

  4. Para Url, ingrese la URL del video de YouTube o Vimeo.

    Nuevo vídeo para el producto {width="600" modal="regular"}

  5. Haga clic fuera del campo y espere comentarios sobre la clave de API o el vídeo.

    Si todo se desprotege, YouTube proporciona información básica del vídeo

  6. Escriba Title y Description del vídeo.

  7. Para cargar un(a) Preview Image, busque la imagen y seleccione el archivo.

    note note
    NOTE
    Después de la carga, un proveedor de servicios de vídeo externo genera automáticamente la imagen de vista previa que se muestra. No puede editar la imagen desde el administrador de Adobe Commerce.

  8. Si prefiere usar los metadatos del vídeo, haga clic en Get Video Information.

  9. Para determinar cómo se usa el vídeo en la tienda, active la casilla de verificación de cada Role que corresponda:

    • Base Image
    • Small Image
    • Swatch Image
    • Thumbnail
    • Hide from Product Page

  10. Una vez finalizado, haga clic en Save.

    note note
    NOTE
    Si la opción de configuración Autostart base video​se establece en Yes pero el vídeo no empieza a reproducirse automáticamente, podría deberse a las políticas de reproducción automática que aplica el explorador y que Adobe Commerce no puede controlar. Cada navegador compatible tiene sus propias políticas de reproducción automática que pueden cambiar con el tiempo y es posible que el vídeo no se reproduzca automáticamente en el futuro. Como práctica recomendada, no debe depender de la reproducción automática para la funcionalidad empresarial crítica y debe probar el comportamiento de reproducción automática de vídeo en su tienda con cada explorador compatible.

Mantener acceso a API

Según los Términos y condiciones del desarrollador de Google, YouTube puede deshabilitar el acceso a la API para cuentas que hayan estado inactivas durante más de 90 días. Esto podría provocar que sus vídeos no se muestren. Para mantener el acceso a la API actualizado, utilice un trabajo cron para hacer ping a la API a intervalos regulares:

30 10 1 * * curl -i -G -e https://yourdomain.com/ -d "part=snippet&maxResults=1&q=test&key=YOUTUBEAPIKEY" https://www.googleapis.com/youtube/v3/search >/dev/null 2>&1

Referencia de campo

Campo
Descripción
URL
La URL del vídeo asociado.
Title
El título del vídeo.
Description
La descripción del vídeo.
Preview Image
Una imagen cargada que se utiliza como previsualización del vídeo en su tienda.
Get Video Information
Recupera los metadatos de vídeo almacenados en el servidor host. Puede utilizar los datos originales o actualizarlos según sea necesario.
Role
Determina cómo se utiliza la imagen de vista previa en la tienda. Puede elegir cualquier combinación de opciones: Base Image, Small Image, Thumbnail, Swatch Image, Hide from Product Page
recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071