{"id":25423,"date":"2026-05-26T15:17:44","date_gmt":"2026-05-26T13:17:44","guid":{"rendered":"https:\/\/www.seopress.org\/es\/?post_type=documentation&#038;p=25423"},"modified":"2026-05-26T15:17:44","modified_gmt":"2026-05-26T13:17:44","slug":"autocompletar-el-esquema-de-video-a-partir-del-primer-video-de-youtube","status":"publish","type":"documentation","link":"https:\/\/www.seopress.org\/es\/soporte\/guias\/autocompletar-el-esquema-de-video-a-partir-del-primer-video-de-youtube\/","title":{"rendered":"Autocompletar el schema de V\u00eddeo a partir del primer v\u00eddeo de YouTube"},"content":{"rendered":"<h2>Qu\u00e9 hace esta caracter\u00edstica<\/h2>\n<p>Cuando activas esta opci\u00f3n, SEOPress detecta el primer v\u00eddeo de YouTube insertado en el contenido de una entrada, p\u00e1gina o tipo de contenido personalizado, y lo utiliza para rellenar autom\u00e1ticamente los datos estructurados de V\u00eddeo (<code>VideoObject<\/code>) en esa URL.<\/p>\n<p>En lugar de abrir cada entrada para copiar el t\u00edtulo del v\u00eddeo, la descripci\u00f3n, la URL de la miniatura, la fecha de publicaci\u00f3n y la duraci\u00f3n en la metabox del schema de V\u00eddeo, SEOPress lee esos valores directamente desde el v\u00eddeo de YouTube y genera un bloque JSON-LD\u00a0<code>VideoObject<\/code>\u00a0v\u00e1lido en el c\u00f3digo fuente de la p\u00e1gina.<\/p>\n<p>La caracter\u00edstica solo act\u00faa sobre el primer v\u00eddeo de YouTube encontrado en el contenido. Si una entrada contiene varias inserciones, las dem\u00e1s se ignoran para la generaci\u00f3n del schema.<\/p>\n<h2>Por qu\u00e9 importa el schema de V\u00eddeo<\/h2>\n<p><code>VideoObject<\/code>\u00a0es el tipo de datos estructurados que Google utiliza para entender el contenido de v\u00eddeo en una p\u00e1gina web. Cuando el marcado es v\u00e1lido y completo, Google puede:<\/p>\n<ul>\n<li>Mostrar el v\u00eddeo como resultado enriquecido en la b\u00fasqueda.<\/li>\n<li>Mostrar una miniatura junto al enlace azul est\u00e1ndar.<\/li>\n<li>Posicionar la p\u00e1gina en la pesta\u00f1a V\u00eddeos y en Discover.<\/li>\n<li>Indexar momentos clave y clips cuando las propiedades correspondientes est\u00e1n presentes.<\/li>\n<\/ul>\n<p>Sin marcado\u00a0<code>VideoObject<\/code>, una p\u00e1gina que inserta un v\u00eddeo sigue siendo indexable, pero los motores de b\u00fasqueda tienen que deducir por s\u00ed mismos la relaci\u00f3n entre la p\u00e1gina y el v\u00eddeo. Unos datos estructurados expl\u00edcitos eliminan esa ambig\u00fcedad.<\/p>\n<h2>Requisitos<\/h2>\n<p>Antes de activar la caracter\u00edstica, comprueba que:<\/p>\n<ul>\n<li>Utilizas <a href=\"https:\/\/www.seopress.org\/es\/complementos-wordpress-seo\/seopress-pro\/\">SEOPress PRO<\/a> (&gt;= 9.9).<\/li>\n<li>Tu contenido incluye al menos una inserci\u00f3n de YouTube (bloque de inserci\u00f3n, URL oEmbed en su propia l\u00ednea o iframe que apunte a\u00a0<code>youtube.com<\/code>\u00a0o\u00a0<code>youtu.be<\/code>).<\/li>\n<li>Tu sitio puede realizar peticiones HTTP salientes al endpoint oEmbed de YouTube y a las URLs de miniaturas de YouTube. Los alojamientos que bloquean las peticiones salientes impedir\u00e1n que SEOPress obtenga los metadatos del v\u00eddeo.<\/li>\n<\/ul>\n<h2>C\u00f3mo activarla<\/h2>\n<ol>\n<li>En la administraci\u00f3n de WordPress, ve a\u00a0<strong>SEO, Pro, pesta\u00f1a Tipos de datos estructurados<\/strong>.<\/li>\n<li>Activa <strong>Autocompletar el esquema de v\u00eddeo a partir del primer v\u00eddeo de YouTube<\/strong>.<\/li>\n<li>Guarda los cambios.<\/li>\n<\/ol>\n<p>A partir de ese momento, cualquier entrada que coincida con esta regla y contenga una inserci\u00f3n de YouTube generar\u00e1 un bloque JSON-LD\u00a0<code>VideoObject<\/code>\u00a0en el front-end.<\/p>\n<h2>Qu\u00e9 propiedades se rellenan<\/h2>\n<p>Cuando la caracter\u00edstica se ejecuta, SEOPress intenta rellenar las propiedades est\u00e1ndar de\u00a0<code>VideoObject<\/code>:<\/p>\n<ul>\n<li><code>name<\/code>: el t\u00edtulo del v\u00eddeo de YouTube.<\/li>\n<li><code>description<\/code>: la descripci\u00f3n del v\u00eddeo de YouTube.<\/li>\n<li><code>thumbnailUrl<\/code>: la miniatura de alta resoluci\u00f3n servida por YouTube.<\/li>\n<li><code>uploadDate<\/code>: la fecha de publicaci\u00f3n devuelta por YouTube.<\/li>\n<li><code>duration<\/code>: la duraci\u00f3n en formato ISO 8601 (por ejemplo,\u00a0<code>PT4M13S<\/code>).<\/li>\n<li><code>contentUrl<\/code>\u00a0y\u00a0<code>embedUrl<\/code>: las URLs can\u00f3nicas de YouTube.<\/li>\n<\/ul>\n<p>Si YouTube no devuelve un valor concreto, SEOPress omite esa propiedad en lugar de emitir una cadena vac\u00eda.<\/p>\n<h2>Verificar el resultado<\/h2>\n<p>Despu\u00e9s de guardar una entrada, comprueba que el schema se renderiza correctamente:<\/p>\n<ol>\n<li>Carga la entrada en el front-end.<\/li>\n<li>Visualiza el c\u00f3digo fuente de la p\u00e1gina y busca\u00a0<code>\"@type\":\"VideoObject\"<\/code>. Deber\u00edas ver un bloque con las propiedades listadas m\u00e1s arriba.<\/li>\n<li>Pasa la URL por la\u00a0<a class=\"text-[var(--accent)] hover:underline underline-offset-[1px] outline-none hide-focus-ring ring-focus rounded-r2\" href=\"https:\/\/search.google.com\/test\/rich-results\" target=\"_blank\" rel=\"nofollow noopener\">Prueba de resultados enriquecidos<\/a>\u00a0y confirma que el resultado de V\u00eddeo se detecta sin errores.<\/li>\n<li>Si usas Google Search Console, supervisa el informe\u00a0<strong>V\u00eddeos<\/strong>\u00a0durante las semanas siguientes para confirmar que las URLs son elegibles.<\/li>\n<\/ol>\n<p>Si\u00a0<code>VideoObject<\/code>\u00a0no aparece en el front-end, verifica que la entrada contenga realmente una inserci\u00f3n de YouTube, que la regla del schema se aplique al tipo de contenido y que nada en el servidor est\u00e9 bloqueando las peticiones a\u00a0<code>youtube.com<\/code>.<\/p>\n<h2>Cu\u00e1ndo seguir rellenando los campos manualmente<\/h2>\n<p>La caracter\u00edstica autom\u00e1tica es una herramienta de productividad, no un sustituto del criterio editorial. Hay casos en los que conviene seguir escribiendo los campos a mano:<\/p>\n<ul>\n<li>El t\u00edtulo de YouTube es gen\u00e9rico o sensacionalista y quieres una descripci\u00f3n alineada con el tema de la p\u00e1gina.<\/li>\n<li>La primera inserci\u00f3n de YouTube en el contenido no es el v\u00eddeo principal de la p\u00e1gina (por ejemplo, aparece en una barra lateral o en un bloque de contenido relacionado por encima del tema principal).<\/li>\n<\/ul>\n<p>En estos casos, rellena los campos correspondientes en la metabox del schema de V\u00eddeo y deja que SEOPress los combine con el resto de los datos obtenidos.<\/p>\n<h2>Preguntas frecuentes<\/h2>\n<p><strong>\u00bfFunciona esta caracter\u00edstica con Vimeo, Wistia o v\u00eddeos auto-alojados?<\/strong><br \/>\nNo. La implementaci\u00f3n actual est\u00e1 limitada a YouTube. Para otros proveedores, rellena la metabox del schema de V\u00eddeo manualmente.<\/p>\n<p><strong>\u00bfQu\u00e9 ocurre si cambio el v\u00eddeo insertado m\u00e1s adelante?<\/strong><br \/>\nEn el siguiente guardado de la entrada, SEOPress vuelve a leer la primera inserci\u00f3n de YouTube y refresca los valores autocompletados. Los campos rellenados manualmente se conservan.<\/p>\n<p><strong>\u00bfEsto ralentizar\u00e1 mi sitio?<\/strong><br \/>\nLa consulta se produce en el momento del guardado, no en cada petici\u00f3n del front-end. El JSON-LD generado se cachea junto con la entrada, por lo que los visitantes no pagan ning\u00fan coste en latencia.<\/p>\n","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","_seopress_robots_follow":"","_seopress_robots_imageindex":"","_seopress_robots_snippet":"","_seopress_robots_primary_cat":"","_seopress_robots_breadcrumbs":"","_seopress_robots_freeze_modified_date":"","_seopress_robots_custom_modified_date":"","_seopress_robots_canonical":"","_seopress_social_fb_title":"","_seopress_social_fb_desc":"","_seopress_social_fb_img":"","_seopress_social_fb_img_attachment_id":0,"_seopress_social_fb_img_width":0,"_seopress_social_fb_img_height":0,"_seopress_social_twitter_title":"","_seopress_social_twitter_desc":"","_seopress_social_twitter_img":"","_seopress_social_twitter_img_attachment_id":0,"_seopress_social_twitter_img_width":0,"_seopress_social_twitter_img_height":0,"_seopress_redirections_value":"","_seopress_redirections_enabled":"","_seopress_redirections_enabled_regex":"","_seopress_redirections_logged_status":"","_seopress_redirections_param":"","_seopress_redirections_type":0,"_seopress_analysis_target_kw":"","_seopress_news_disabled":"","_seopress_video_disabled":"","_seopress_video":[],"_seopress_pro_schemas_manual":[],"_seopress_pro_rich_snippets_disable_all":"","_seopress_pro_rich_snippets_disable":[],"_seopress_pro_schemas":[],"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","editor_notices":[],"footnotes":""},"class_list":{"0":"post-25423","1":"documentation","2":"type-documentation","3":"status-publish","5":"documentation_type-guias","6":"product-seopress-pro"},"acf":[],"_links":{"self":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/25423","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":2,"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/25423\/revisions"}],"predecessor-version":[{"id":25425,"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/25423\/revisions\/25425"}],"wp:attachment":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/media?parent=25423"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}