可朗读（Article、WebPage）结构化数据（Beta 版）

speakableschema.org 属性可用于标识报道或网页中最适合使用文字转语音 (TTS) 功能进行音频播放的版块。添加标记后，搜索引擎和其他应用可以识别出相应内容，并在内置 Google 助理的设备上使用 TTS 功能朗读这些内容。包含 speakable 结构化数据的网页可以使用 Google 助理来通过新渠道分发内容，并将内容呈现给更多的用户。

Google 助理会使用 speakable 结构化数据在智能音箱设备上对时事新闻查询进行回复。当用户询问有关特定主题的新闻时，Google 助理会从网络上返回最多 3 篇报道，并支持使用 TTS 功能对报道中包含 speakable 结构化数据的版块进行音频播放。当 Google 助理朗读某个 speakable 版块时，它会寻找内容的来源，并通过 Google 助理应用将完整的报道网址发送到用户的移动设备。

示例

下面是一个使用了 JSON-LD 代码和 xPath content-locator 值的 speakable 结构化数据示例：

<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>

适用的国家/地区和语言

speakable 属性适用于将 Google Home 设备的语言设为“英语”的美国用户以及使用英语发布内容的发布商。我们希望，一旦实施 speakable 属性的发布商数量足够多，就能将它推广到其他国家/地区和语言版本。

使用入门

为了使您的新闻内容能够在用户查询时事新闻时作为答案呈现，请按以下步骤操作：

  1. 确保遵循我们的指南。
  2. 将 speakable 结构化数据添加到您的网页中。

指南

如需让您的 speakable 内容能够显示在新闻搜索结果中，您必须遵循以下指南。

技术指南

在为 Google 助理实施 speakable 标记时，请遵循以下指南。

  • 不要将 speakable 结构化数据添加到在纯语音和语音转发的情况下听起来可能会令人困惑的内容中，如新闻电头（报道新闻的地点）、照片说明或信息来源说明。
  • 应抓住重点，而不是使用 speakable 结构化数据强调整篇报道。这样能让听众明白报道的主旨，不会因为使用了 TTS 朗读功能而漏掉重要细节。

内容指南

在编写打算使用 speakable 结构化数据标记的内容时，请遵循以下指南。

  • 用 speakable 结构化数据标记的内容必须具有简明扼要的资讯标题和/或摘要，可为用户提供易懂且有用的信息。
  • 如果您将报道的开头包含在 speakable 结构化数据中，我们建议您重写报道的开头，将信息拆分成多个句子，以便通过 TTS 功能更清楚地朗读。
  • 为确保能够向用户提供最佳音频体验，我们建议每段 speakable 结构化数据包含大约 20-30 秒的内容，或者大概 2-3 个句子。

结构化数据类型定义

Speakable 属性供 Article 或 Webpage 对象使用。 如需了解 speakable 的完整定义，请访问 schema.org/speakable。为了能够使用此功能，您必须为内容添加必要属性。

speakable 属性可以重复任意次数使用，有两种可能的 content-locator 值：CSS 选择器和 xPath。请使用下列属性之一：

必要属性
cssSelector

Text

对带注释的网页中的内容（如类属性）寻址。使用 cssSelector 或 xPath，但不要同时使用这两者。例如：

"speakable":
  {
  "@type": "SpeakableSpecification",
  "cssSelector": [
    ".headline",
    ".summary"
  ]
}
xPath

Text

使用 xPath 对内容寻址（假设该内容使用 XML 视图）。使用 cssSelector 或 xPath，但不要同时使用这两者。例如：

"speakable":
  {
  "@type": "SpeakableSpecification",
  "xPath": [
    "/html/head/title",
    "/html/head/meta[@name='description']/@content"
  ]
}

Troubleshooting

If you're having trouble implementing or debugging structured data, here are some resources that may help you.

  • 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.
  • 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.
  • You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report.
  • 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, use the Manual Actions report.
  • Review the 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.
  • Troubleshoot missing rich results / drop in total rich results.
  • 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.
  • Post a question in the Google Search Central forum.

无法触发内容

问题：您无法通过 Google 助理使用 TTS 音频触发您的内容。

解决问题

  1. 尝试以下语音指令：
    • “与 $topic 相关的最新消息是什么？”
    • “与 $topic 相关的最新资讯是什么？”
    • “播放与 $topic 相关的新闻。”
  2. 如果问题仍然存在，可能是因为排名是通过算法确定的。通过 TTS 音频播放，Google 助理可提供最多 3 篇来自不同新闻发布来源的报道。有关 Google 如何对报道进行排名的详情，请参阅 Google 搜索的运作方式。

更多音频解决方案

除了 speakable 结构化数据之外，您还可以将其他 Google 助理音频解决方案用于您的新闻内容，比如实现 Google 助理与您自定义应用的高级集成。例如，允许用户通过 Google 助理与应用进行互动。有关详情，请参阅 Actions on Google 开发者指南。