Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Dados estruturados de Speakable (Article, WebPage) (BETA)
A propriedade speakable do schema.org (em inglês)
identifica as seções de um artigo ou uma página da Web que são mais adequadas para transmissão de áudio por
conversão de texto em voz (TTS, na sigla em inglês). O acréscimo de marcação permite que mecanismos de pesquisa e outros aplicativos identifiquem conteúdos
para ler em voz alta nos dispositivos com Google Assistente que usam TTS. Páginas da Web com dados estruturados speakable
podem usar o Google Assistente para distribuir o conteúdo por meio de novos canais
e alcançar uma base maior de usuários.
O Google Assistente usa dados estruturados speakable para responder a consultas de notícias temáticas
em alto-falantes inteligentes. Quando os usuários solicitam notícias sobre um assunto específico, o
Google Assistente retorna até três artigos de toda a Web e é compatível com a transmissão de áudio usando
TTS para as seções do artigo com dados estruturados speakable. Quando o
Google Assistente lê em voz alta uma seção speakable, ele atribui a origem e envia
o URL completo do artigo ao dispositivo móvel do usuário por meio do app Google Assistente.
Exemplo
Veja a seguir um exemplo de dados estruturados speakable que usa o código JSON-LD e o 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>
Disponibilidade de país e idioma
A propriedade speakable funciona para usuários nos EUA que têm dispositivos Google Home
configurados para o inglês, assim como para editores que publicam conteúdo em inglês. Esperamos fazer o lançamento em outros
países e idiomas assim que houver um número suficiente de editores que tenham implementado
a propriedade speakable.
Primeiros passos
Para que o conteúdo apareça como resposta a consultas de notícias temáticas, siga estas etapas:
Siga estas diretrizes ao implementar a marcação speakable para o Google Assistente.
Não adicione dados estruturados speakable a conteúdos que possam soar confusos em
situações que contenham somente voz ou encaminhamento de voz, como linhas de data (local onde a história foi relatada),
legendas de fotos ou atribuições de fonte.
Em vez de destacar um artigo inteiro com dados estruturados speakable,
concentre-se nos pontos principais. Isso permite que os ouvintes tenham uma ideia da matéria e que a leitura de TTS
não corte detalhes importantes.
Diretrizes de conteúdo
Siga estas diretrizes ao escrever conteúdo que você pretende marcar com
dados estruturados speakable.
O conteúdo indicado pelos dados estruturados speakable precisa ter títulos
e/ou resumos concisos que forneçam aos usuários informações compreensíveis e úteis.
Se você incluir o início da matéria nos dados estruturados speakable, sugerimos
que o reescreva dividindo as informações em frases individuais
para que elas sejam lidas pelo TTS de maneira mais clara.
Para otimizar as experiências do usuário com áudio, recomendamos cerca de 20 a 30 segundos de conteúdo por
seção de dados estruturados speakable, ou aproximadamente duas a três frases.
Definições de tipos de dados estruturados
Speakable é usado pelo objeto
Article ou
Webpage (links em inglês).
A definição completa de speakable está disponível em
schema.org/speakable (em inglês). Você precisa
incluir as propriedades obrigatórias para que o conteúdo seja qualificado para esse recurso.
A propriedade speakable pode ser repetida qualquer número de vezes, com dois
tipos de valores possíveis de content-locator: seletores CSS e xPaths. Use uma das
seguintes propriedades:
Se você tiver problemas para implementar ou depurar dados estruturados, veja alguns recursos que
podem ajudar.
Se você usa um sistema de gerenciamento de conteúdo (CMS) ou se alguém está cuidando do seu site,
peça ajuda para o prestador de serviço. Não se esqueça de encaminhar todas as mensagens do Search Console com os detalhes do problema.
O Google não garante que os recursos que consomem dados estruturados vão ser exibidos nos resultados da pesquisa.
Para ver uma lista de motivos comuns por que o Google pode não exibir seu conteúdo na pesquisa aprimorada, consulte as
diretrizes gerais de dados estruturados.
Se você recebeu uma ação manual de dados estruturados relacionada à sua página, esses dados
serão ignorados, embora a página ainda possa aparecer nos resultados da Pesquisa Google. Para corrigir
problemas de dados estruturados, use o Relatório de ações manuais.
Consulte as diretrizes novamente para identificar se o conteúdo não está em conformidade
com elas. O problema pode ser causado por conteúdo com spam ou uso de marcação com spam.
No entanto, talvez o problema não seja de sintaxe e, por isso, o teste de pesquisa aprimorada não poderá
identificá-lo.
Aguarde algum tempo antes de voltar a rastrear e reindexar. Pode levar vários dias depois da publicação de uma página para que o Google a localize e rastreie. Para perguntas gerais sobre rastreamento e indexação, consulte as Perguntas frequentes sobre rastreamento e indexação da Pesquisa Google.
errorProblema: não é possível acionar seu conteúdo
pelo Google Assistente usando áudio TTS.
doneCorrigir o problema
Teste os seguintes comandos de voz:
"Quais são as notícias mais recentes sobre $topic?"
"Quais são as novidades sobre $topic?"
"Tocar notícias sobre $topic."
Se os problemas persistirem, isso pode estar acontecendo porque a classificação é determinada por algoritmos.
O Google Assistente fornece até três artigos de diferentes publicações de notícias usando
a transmissão de áudio com TTS. Para ver mais informações sobre como o Google classifica os artigos, consulte
Como funciona a Pesquisa.
Mais soluções de áudio
Além dos dados estruturados speakable, você pode usar outras soluções de áudio do Google Assistente
no conteúdo de notícias, como a integração avançada
com seus aplicativos personalizados. Por exemplo, você pode permitir que os usuários interajam com o app usando o
Google Assistente. Para ver mais informações, consulte o guia do
desenvolvedor do Actions on Google.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
