Generador de schema de vídeo

Cómo generar el schema de vídeo

Tres propiedades obligatorias, un formato de fecha que casi todo el mundo escribe a medias y dos URLs que no son la página en la que estás. El generador escribe el marcado y la ficha visible con los mismos valores.

1. Primero, título y miniatura. Los dos son obligatorios y propios de este vídeo. La miniatura solo le sirve a Google si su URL sigue siendo la misma el mes que viene: una CDN que rota las URLs te cuesta la indexación.
2. Pon la hora de subida con su diferencia con UTC. La fecha sola es válida; con hora y diferencia es inequívoca. En la península, +02:00 de finales de marzo a finales de octubre y +01:00 el resto del año; en Canarias, una hora menos.
3. Escribe la duración como la piensas. Doce cuarenta y ocho, una hora dos minutos y treinta, un número de segundos o la forma ISO. Siempre sale la duración ISO 8601 que pide la propiedad.
4. contentUrl al archivo, embedUrl al reproductor. Ninguna de las dos es la página a la que llega el lector. El generador rechaza un contentUrl que parezca una página web: es el error más común del marcado de vídeo.
5. Añade capítulos y pega las dos salidas. Los enlaces de los capítulos salen de la URL de la página de visualización más un parámetro de tiempo, como exige Google. El JSON-LD va en esa página; la ficha visible, bajo el reproductor.

uploadDate en hora de España: +01:00, +02:00 y Canarias

Un generador de schema de vídeo convierte los datos de un vídeo en JSON-LD de VideoObject: los datos estructurados que Google lee para el título, la miniatura, la duración y los momentos clave de un vídeo. Hay tres propiedades obligatorias —name, thumbnailUrl y uploadDate— y la tercera es la que se escribe a medias.

Google define uploadDate como la fecha y la hora de la primera publicación, en ISO 8601, y añade: te recomendamos que proporciones información sobre la zona horaria; de lo contrario, se utilizará de forma predeterminada la zona horaria que utiliza el robot de Google. En España eso son dos respuestas. El Real Decreto 236/2002 fija la hora de verano desde el último domingo de marzo a las 02:00 hasta el último domingo de octubre a las 03:00 —en Canarias, a la 01:00 y a las 02:00—, y en ambos casos a la una de la madrugada en tiempo universal. Traducido a diferencias: toda España salvo Canarias va a +01:00 en invierno y +02:00 en verano; Canarias, a +00:00 (en el formulario, Z) y +01:00.

"uploadDate": "2026-09-18"                     // válido, pero sin hora
      "uploadDate": "2026-09-18T19:30:00"            // hora, pero ¿de qué reloj?
      "uploadDate": "2026-09-18T19:30:00+02:00"      // inequívoca

Hay una noche al año en que la diferencia lo es todo. Este año los relojes se retrasan el domingo 25 de octubre, un día que según la orden del BOE tiene una duración oficial de veinticinco horas: en la península, cada minuto entre las 02:00 y las 03:00 ocurre dos veces (en Canarias, entre la 01:00 y las 02:00). Un vídeo publicado a las 02:30 de esa madrugada es 02:30:00+02:00 o 02:30:00+01:00; el propio decreto pide que en los servicios públicos el cambio de hora se refleje «de modo exacto e inequívoco», y en ISO 8601 eso es la diferencia con UTC. La misma recomendación de zona horaria vale para expires, con una instrucción más: si el vídeo no caduca, no pongas expires.

YouTube, Vimeo o tu propio reproductor: qué indexa Google

Según el Panel de Hogares de la CNMC del cuarto trimestre de 2025, en España los usuarios más jóvenes dedicaron más tiempo a los contenidos bajo demanda y a plataformas como YouTube o TikTok, mientras los mayores se quedan con la televisión en abierto. Para el marcado importa dónde vive el vídeo que enseñas en tu web:

• Insertado desde YouTube, Vimeo o Facebook. Google puede indexar el vídeo tanto en tu página como en la página equivalente de la plataforma, y las dos versiones pueden aparecer si cumplen los criterios de indexación. Aun así, recomienda seguir poniendo datos estructurados en tu página de visualización.
• Capítulos de un vídeo alojado en YouTube. Se indican en la descripción del propio vídeo: marca de tiempo con formato [hora]:[minuto]:[segundo], la etiqueta en la misma línea, cada una en su línea y en orden cronológico. Las líneas de capítulos de este formulario usan ese mismo formato, así que puedes pegar las de tu descripción.
• En tu propio reproductor. Los momentos clave se marcan con Clip, disponible en todos los idiomas de la Búsqueda, o con SeekToAction, cuya lista de idiomas incluye el español. Google da prioridad a los momentos que le indicas.

En todos los casos rige lo mismo: la página de visualización tiene que estar indexada —y que lo esté no implica que el vídeo también—, el vídeo tiene que estar insertado y visible, sin elementos que lo tapen, y la miniatura, en una URL estable.

La duración es una duración, y contentUrl es un archivo

duration lleva una duración ISO 8601, no una hora del reloj ni un número de segundos: PT00H30M5S son treinta minutos y cinco segundos. Este formulario acepta lo que tengas —12:48, 1:02:30, 768 o la forma ISO— y escribe la ISO. Si no sabe leer el valor, lo rechaza en vez de pasarlo tal cual.

Las dos URLs son donde el marcado de vídeo falla sin avisar:

• contentUrl son los bytes del archivo de vídeo. Google lo escribe claro: no debe ser el enlace a la página en la que se encuentra el vídeo. Tiene que acabar en uno de los tipos de archivo que Google procesa —MP4, WebM, MOV, MKV y diecisiete más— y no puede ser una URL de datos.
• embedUrl es el reproductor, normalmente lo que va en el src del elemento insertado. Tampoco es la página.
• Google recomienda dar contentUrl siempre que puedas, porque es la forma más eficaz de obtener el archivo; embedUrl es la alternativa.

Este generador trata como error un contentUrl sin extensión o con una de página web. En una página que valida en todo lo demás, ese campo suele ser la razón de que el vídeo no aparezca nunca.

Miniaturas y capítulos, con las cifras que publica Google

Los capítulos son objetos Clip dentro de hasPart, con una regla que muchas herramientas se saltan: la URL del clip debe apuntar a la misma ruta de URL que el vídeo con parámetros de consulta adicionales que especifiquen la hora. Con la URL de tu página de visualización, cada capítulo sale como esa URL más ?t= y los segundos. Google pide además que el vídeo dure al menos 30 segundos y que dos clips del mismo vídeo no empiecen en el mismo momento; el formulario avisa si un capítulo no va después del anterior y rechaza el que empieza cuando el vídeo ya ha terminado.

Lo que el marcado no arregla: el vídeo tiene que estar en la página y a la vista. La ficha visible que genera esta herramienta —título, descripción, fecha, duración y tabla de capítulos con las mismas cifras— es la mitad legible del mismo dato, la que puede citar un motor de respuestas. Es la regla de todas las herramientas de esta serie, como el generador de schema FAQ.