Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Datos estructurados de Speakable (Article, WebPage) (BETA)
La propiedad speakable de schema.org identifica las secciones de un artículo o una página web más adecuadas para la reproducción de audio con texto a voz (TTS). Si agregas lenguaje de marcado, permitirás a los motores de búsqueda y a otras aplicaciones identificar el contenido para leer en voz alta en los dispositivos compatibles con el Asistente de Google por medio de funciones de TTS. Las páginas web con datos estructurados de speakable podrán usar el Asistente para distribuir contenido mediante canales nuevos y llegar a una mayor cantidad de usuarios.
El Asistente de Google usa datos estructurados de speakable para responder consultas sobre temas del momento en dispositivos con bocinas inteligentes. Cuando los usuarios piden noticias sobre un tema específico, el Asistente muestra hasta tres artículos de la Web y admite la reproducción de audio con TTS para las secciones de artículos con datos estructurados de speakable. Cuando el Asistente lee una sección con speakable en voz alta, hace atribución a la fuente y envía la URL del artículo completo al dispositivo móvil del usuario mediante la app del Asistente de Google.
Ejemplo
El siguiente es un ejemplo de datos estructurados de speakable que usan el código JSON-LD y el valor content-locator de xPath:
<html>
<head>
<title>Speakable markup example</title>
<meta name="description" content="This page is all about the quick brown fox" />
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "WebPage",
"name": "Quick Brown Fox",
"speakable":
{
"@type": "SpeakableSpecification",
"xPath": [
"/html/head/title",
"/html/head/meta[@name='description']/@content"
]
},
"url": "https://www.example.com/quick-brown-fox"
}
</script>
</head>
<body>
</body>
</html>
Disponibilidad de idiomas y países
La propiedad speakable funciona para usuarios de EE.UU. que tienen dispositivos Google Home configurados en inglés, y para editores que publican contenido en ese idioma. Esperamos lanzarla en otros idiomas y países cuando más editores comiencen a implementar speakable.
Cómo empezar
Para que tu contenido de noticias pueda considerarse como respuesta a búsquedas de noticias temáticas, sigue estos pasos:
Sigue estos lineamientos cuando implementes lenguaje de marcado speakable para el Asistente de Google.
No agregues datos estructurados de speakable al contenido que pueda sonar confuso en situaciones en las que solo haya voz y de reenvío de voz, como la fecha y la hora (ubicación en donde ocurrió la noticia), las leyendas de fotos o las atribuciones de fuentes.
En lugar de destacar un artículo completo con datos estructurados speakable, enfócate en los puntos principales. De esta manera, los usuarios que estén escuchando podrán tener una idea de la noticia y evitarás que la lectura con TTS corte los detalles importantes.
Lineamientos de contenido
Sigue estos lineamientos cuando escribas contenido que quieras marcar con datos estructurados de speakable.
El contenido indicado con datos estructurados de speakable debe tener titulares y resúmenes concisos que brinden a los usuarios información útil y comprensible.
Si incluyes datos estructurados de speakable en la parte superior de la noticia, te sugerimos que la vuelvas a escribir y dividas la información en oraciones individuales a fin de que sea más fácil de leer para la función TTS.
Para brindar experiencias de audio óptimas, se recomienda que el contenido por sección con datos estructurados de speakable sea de alrededor de 20 o 30 segundos, o bien, de aproximadamente dos o tres oraciones.
Definiciones de tipos de datos estructurados
Los objetos Article y Webpage usan Speakable.
La definición completa de speakable está disponible en schema.org/speakable. Debes incluir las propiedades obligatorias a fin de que tu contenido sea apto para esta función.
La propiedad speakable se puede repetir una cantidad arbitraria de veces, con dos tipos de valores de content-locator posibles: selectores de CSS y xPaths. Usa una de las siguientes propiedades:
Si tienes problemas para implementar o depurar datos estructurados, te brindamos algunos recursos que podrían resultarte útiles.
Si usas un sistema de administración de contenido (CMS), o si alguien más se encarga de tu sitio, pídele que te ayude. Asegúrate de reenviarle cualquier mensaje de Search Console que detalle el problema.
Google no garantiza que se muestren en los resultados de la búsqueda las funciones que consumen datos estructurados.
Para obtener una lista de los motivos comunes por los que Google podría no mostrar tu contenido en un resultado enriquecido, consulta los Lineamientos generales de datos estructurados.
Si recibiste una acción manual de datos estructurados en tu página, estos datos se ignorarán (aunque la página puede seguir apareciendo en los resultados de la Búsqueda de Google). Para solucionar
los problemas con datos estructurados, usa el Informe de acciones manuales.
Vuelve a consultar los lineamientos para determinar si tu contenido no cumple con ellos. El problema puede deberse a contenido generador de spam o a un uso fraudulento del lenguaje de marcado.
Sin embargo, es posible que no sea un problema de sintaxis, por lo que la prueba de resultados enriquecidos no podrá identificar estos problemas.
Espera un tiempo suficiente para que se vuelvan a realizar el rastreo y la indexación. No olvides que pueden transcurrir varios días después de publicar una página para que Google la encuentre y la rastree. Si tienes preguntas generales sobre el rastreo y la indexación, consulta las Preguntas frecuentes sobre el rastreo y la indexación de la Búsqueda de Google.
errorProblema: No puedes activar tu contenido a través del Asistente de Google con audio TTS.
doneCómo solucionarlo
Prueba los siguientes comandos por voz:
"¿Cuáles son las últimas noticias sobre $topic?".
"¿Cuáles son las novedades sobre $topic?".
"Reproduce noticias sobre $topic".
Si persisten los problemas, podrían deberse a que la clasificación se determina con algoritmos.
El Asistente de Google proporciona hasta tres artículos desde diferentes publicaciones de noticias mediante la reproducción de audio con TTS. Para obtener más información sobre cómo Google clasifica los artículos, consulta Cómo funciona la Búsqueda.
Más soluciones de audio
Además de los datos estructurados de speakable, puedes usar otras soluciones de audio de Asistente de Google para el contenido de noticias, como la integración avanzada de Asistente de Google para tus aplicaciones personalizadas. Por ejemplo, cuando permites que los usuarios interactúen con la app mediante el Asistente. Puedes obtener más información en la guía para desarrolladores de Actions on Google.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-04 (UTC)"],[[["\u003cp\u003eSpeakable structured data enables Google Assistant to read aloud sections of your web page or article using text-to-speech (TTS).\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently in beta and is available for English content in the U.S. on Google Home devices.\u003c/p\u003e\n"],["\u003cp\u003eBy implementing speakable structured data, you can reach a wider audience and make your content accessible through voice search.\u003c/p\u003e\n"],["\u003cp\u003eYou need to follow technical and content guidelines to ensure your content is eligible for this feature and provides an optimal user experience.\u003c/p\u003e\n"],["\u003cp\u003eContent marked as speakable should be concise, focus on key points, and ideally contain around 20-30 seconds of audio per section.\u003c/p\u003e\n"]]],["The `speakable` property, currently in beta, identifies sections of web pages or articles suitable for text-to-speech (TTS) playback. Publishers should add this structured data to enable Google Assistant to read aloud specific content sections, especially for topical news queries. Key actions include following technical and content guidelines, marking up content with either `cssSelector` or `xPath` properties, and focusing on concise, clear headlines and summaries. Content should be 20-30 seconds per section for optimal TTS experience.\n"],null,["# Speakable (BETA) Schema Markup | Google Search Central\n\nSpeakable (`Article`, `WebPage`) structured data (BETA)\n=======================================================\n\n| This feature is in beta and subject to change. We're currently developing this feature and you may see changes in requirements or guidelines.\n\nThe `speakable` [schema.org](https://schema.org/) property\nidentifies sections within an article or webpage that are best suited for audio playback using\ntext-to-speech (TTS). Adding markup allows search engines and other applications to identify content\nto read aloud on Google Assistant-enabled devices using TTS. Web pages with `speakable`\nstructured data can use the Google Assistant to distribute the content through new channels and\nreach a wider base of users.\n\nThe Google Assistant uses `speakable` structured data to answer topical news queries\non smart speaker devices. When users ask for news about a specific topic, the\nGoogle Assistant returns up to three articles from around the web and supports audio playback using\nTTS for sections in the article with `speakable` structured data. When the\nGoogle Assistant reads aloud a `speakable` section, it attributes the source and sends\nthe full article URL to the user's mobile device through the Google Assistant app.\n\nExample\n-------\n\nThe following is an example of `speakable` structured data using JSON-LD code and the\nxPath `content-locator` value: \n\n```text\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eSpeakable markup example\u003c/title\u003e\n \u003cmeta name=\"description\" content=\"This page is all about the quick brown fox\" /\u003e\n \u003cscript type=\"application/ld+json\"\u003e\n {\n \"@context\": \"https://schema.org/\",\n \"@type\": \"WebPage\",\n \"name\": \"Quick Brown Fox\",\n \"speakable\":\n {\n \"@type\": \"SpeakableSpecification\",\n \"xPath\": [\n \"/html/head/title\",\n \"/html/head/meta[@name='description']/@content\"\n ]\n },\n \"url\": \"https://www.example.com/quick-brown-fox\"\n }\n \u003c/script\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003c/body\u003e\n\u003c/html\u003e\n```\n\nCountry and language availability\n---------------------------------\n\nThe `speakable` property works for users in the U.S. that have Google Home devices\nset to English, and publishers that publish content in English. We hope to launch in other\ncountries and languages as soon as sufficient number of publishers have implemented\n`speakable`.\n\n\nGetting started\n---------------\n\nFor your news content to be eligible as answers to topical news queries, follow these steps:\n\n1. Make sure that you follow [our guidelines](#guidelines).\n2. Add [`speakable` structured data](#structured-data-type-definitions) to your web page.\n\nGuidelines\n----------\n\nYou must follow these guidelines for `speakable` content to be eligible to appear\nin news results.\n\n- [Technical guidelines](#technical-guidelines)\n- [Content guidelines](#content-guidelines)\n- [Search Essentials](/search/docs/essentials)\n- [Structured data general guidelines](/search/docs/appearance/structured-data/sd-policies)\n\n### Technical guidelines\n\nFollow these guidelines when implementing `speakable` markup for Google Assistant.\n\n- Don't add `speakable` structured data to content that may sound confusing in voice-only and voice-forward situations, like datelines (location where the story was reported), photo captions, or source attributions.\n- Rather than highlighting an entire article with `speakable` structured data, focus on key points. This allows listeners to get an idea of the story and not have the TTS readout cut off important details.\n\n### Content guidelines\n\nFollow these guidelines when writing content that you intend to mark up with\n`speakable` structured data.\n\n- Content indicated by `speakable` structured data must have concise headlines and/or summaries that provide users with comprehensible and useful information.\n- If you include the top of the story in `speakable` structured data, we suggest that you rewrite the top of the story to break up information into individual sentences so that it reads more clearly for TTS.\n- For optimal audio user experiences, we recommend around 20-30 seconds of content per section of `speakable` structured data, or roughly two to three sentences.\n\nStructured data type definitions\n--------------------------------\n\n[Speakable](https://pending.schema.org/speakable) is used by the\n[`Article`](https://pending.schema.org/Article) or\n[`Webpage`](https://pending.schema.org/WebPage) object.\nThe full definition of `speakable` is available at\n[schema.org/speakable](https://schema.org/speakable). You must\ninclude the required properties for your content to be eligible for this feature.\n\nThe `speakable` property can be repeated an arbitrary number of times, with two\nkinds of possible `content-locator` values: CSS selectors and xPaths. Use one of\nthe following properties:\n\n| Required properties ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `cssSelector` | [Text](https://schema.org/Text) Addresses content in the annotated pages (such as class attribute). Use either `cssSelector` or `xPath`; don't use both. For example: ```carbon \"speakable\": { \"@type\": \"SpeakableSpecification\", \"cssSelector\": [ \".headline\", \".summary\" ] } ``` |\n| `xPath` | [Text](https://schema.org/Text) Addresses content using xPaths (assuming an XML view of the content). Use either `cssSelector` or `xPath`; don't use both. For example: ```carbon \"speakable\": { \"@type\": \"SpeakableSpecification\", \"xPath\": [ \"/html/head/title\", \"/html/head/meta[@name='description']/@content\" ] } ``` |\n\nTroubleshooting\n---------------\n\n\nIf you're having trouble implementing or debugging structured data, here are some resources that\nmay help you.\n\n- If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.\n- Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the [General Structured Data Guidelines](/search/docs/appearance/structured-data/sd-policies).\n- You might have an error in your structured data. Check the [list of structured data errors](https://support.google.com/webmasters/answer/7552505#error_list) and the [Unparsable structured data report](https://support.google.com/webmasters/answer/9166415).\n- If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix [structured data issues](https://support.google.com/webmasters/answer/9044175#zippy=%2Cstructured-data-issue), use the [Manual Actions report](https://support.google.com/webmasters/answer/9044175).\n- Review the [guidelines](#guidelines) again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.\n- [Troubleshoot missing rich results / drop in total rich results](https://support.google.com/webmasters/answer/7552505#missing-jobs).\n- Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the [Google Search crawling and indexing FAQ](/search/help/crawling-index-faq).\n- Post a question in the [Google Search Central forum](https://support.google.com/webmasters/community).\n\n### Can't trigger content\n\n*error* **Problem**: You can't trigger your content\nthrough the Google Assistant using TTS audio.\n\n*done* **Fix the issue**\n\n1. Try the following voice commands:\n - \"What's the latest news about $topic?\"\n - \"What's the latest on $topic?\"\n - \"Play news about $topic.\"\n2. If you're still having trouble, it may be because ranking is determined algorithmically. The Google Assistant provides up to three articles from different news publications through TTS audio playback. For more information about how Google ranks articles, see [How Search works](https://www.google.com/search/howsearchworks/).\n\nMore audio solutions\n--------------------\n\nIn addition to `speakable` structured data, you can use other Google Assistant\naudio solutions for your news content, such as advanced integration of Google Assistant for\nyour own custom applications. For example, allowing users to interact with the app through\nGoogle Assistant. For more information, see the [Actions on Google developer\nguide](/actions)."]]
