学习视频（LearningResource、VideoObject、Clip）结构化数据
Google 搜索是学生和教师发现并观看教育性视频的切入点。有了您通过结构化数据明确提供的特定于学习的信息（例如视频中介绍的教育水平以及概念和技能），Google 可以更好地了解您的视频内容并提供更出色的体验，从而帮助学习者找到合适的内容。
此外，学习视频结构化数据还可以启用与学习视频相关的信息条状标签，例如教育水平和视频类型（例如概览或解决方案视频）。
功能可用性
在所有可以使用 Google 搜索的区域，学习视频富媒体搜索结果均以英语提供。仅当在桌面设备和移动设备上搜索学术学习内容时，才能使用此功能。
示例
单个学习视频
下面是一个单个学习视频示例。
<html>
<head>
<title>Learning video markup example</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "An introduction to Genetics",
"description": "Explanation of the basics of Genetics for beginners.",
"learningResourceType": "Concept Overview",
"educationalLevel": "High school (US)",
"contentUrl": "https://www.example.com/video/123/file.mp4",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>包含多个剪辑的学习视频
下面是一个包含三个剪辑的学习视频示例：其中两个剪辑用于演示问题，另一个剪辑用于概述概念。
<html>
<head>
<title>Learning video and clips markup example</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "An introduction to XYZ",
"description": "Solving equations using exponent properties",
"educationalLevel": "High school (US)",
"educationalAlignment": {
"@type": "AlignmentObject",
"educationalFramework": "Common Core",
"targetName": "HSA-SSE.B.3",
"targetUrl": "https://www.corestandards.org/Math/Content/HSA/SSE/#CCSS.Math.Content.HSA.SSE.B.3"
},
"contentUrl": "https://www.example.com/video/123/file.mp4",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"hasPart": [{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Concept Overview",
"name": "Understanding exponents",
"startOffset": 40,
"endOffset": 120,
"url": "https://www.example.com/example?t=501"
},{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 1: suspended wires",
"text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire.",
"startOffset": 150,
"endOffset": 225,
"url": "https://www.example.com/example?t=30"
},{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 2: exponents",
"text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.",
"startOffset": 275,
"endOffset": 500,
"url": "https://www.example.com/example?t=201"
}],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>问题演示视频
此示例展示了必须添加到学习视频标记以使其成为有效的问题演示视频的所有属性。
<html>
<head>
<title>Problem Walkthrough Learning Video example</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "Mechanics problem for Grade 10",
"description": "Video walks through solution for problems in mechanics.",
"learningResourceType": "Problem Walkthrough",
"text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.",
"contentUrl": "https://www.example.com/video/123/file.mp4",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>多问题演示剪辑
下面是一个包含多个问题演示剪辑的网页示例。此示例展示了为使学习视频标记成为有效的问题演示剪辑标记，必须在视频和剪辑级别添加到该标记的所有属性。
<html>
<head>
<title>Problem Walkthrough in clips in Learning Videos markup</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "An introduction to XYZ",
"description": "Solving equations using exponent properties",
"learningResourceType": "Problem Walkthrough",
"contentUrl": "https://www.example.com/video/123/file.mp4",
"text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"hasPart": [{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 1: suspended wires",
"text": "Consider a weight suspended from two wires. Find the tension in each wire.",
"startOffset": 150,
"endOffset": 225,
"url": "https://www.example.com/example?t=150"
},{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 2: exponents",
"text": "Consider a weight suspended from five wires. Find the tension in one wire.",
"startOffset": 275,
"endOffset": 500,
"url": "https://www.example.com/example?t=275"
}],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>如何添加结构化数据
结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据，可以详细了解结构化数据的运作方式。
下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南，请查看结构化数据 Codelab。
- 添加必要属性。根据您使用的格式，了解在网页上的什么位置插入结构化数据。
- 遵循指南。
- 使用富媒体搜索结果测试验证您的代码，并修复所有严重错误。此外，您还可以考虑修正该工具中可能会标记的任何非严重问题，因为这些这样有助于提升结构化数据的质量（不过，要使内容能够显示为富媒体搜索结果，并非必须这么做）。
- 部署一些包含您的结构化数据的网页，然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问，不会因 robots.txt 文件、
noindex标记或登录要求而被屏蔽。如果网页看起来没有问题，您可以请求 Google 重新抓取您的网址。 - 为了让 Google 随时了解日后发生的更改，我们建议您提交站点地图。Search Console Sitemap API 可以帮助您自动执行此操作。
指南
若想让您的网页可显示为学习视频富媒体搜索结果，您必须遵循以下指南：
技术指南
- 除了学习视频标记之外，您还必须添加
VideoObject的必需属性和建议属性。 - 视频必须是公开的，无需订阅即可观看。
- 视频总时长必须至少为 30 秒。
- 学习视频标记必须添加到能让用户观看视频的网页中。将用户引导至无法观看视频的网页会导致糟糕的用户体验。
不同结构化数据类型的定义
若要使您的内容能够显示为学习视频富媒体搜索结果，您必须为其添加必要属性。您还可添加建议属性，以便添加与您内容相关的更多信息，进而优化用户体验。
学习视频 [VideoObject, LearningResource]
学习视频标记旨在让用户更清楚地了解该视频的教育内容。此标记中可以包含视频中介绍的各种概念和技能的相关信息。
对学习视频使用 [VideoObject, LearningResource] 类型。除了 VideoObject 的必要属性和建议属性之外，您还可以为学习视频添加以下属性。
| 必要属性 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
与内容相关的正式标准代码、课程或考试。仅当您的内容符合特定标准或考试要求时，才使用此属性。否则，只能使用
虽然您可以提供多个 示例： "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "Common Core", "targetName": "CCSS.MATH.CONTENT.7.SP.B.4", "targetUrl": "https://www.corestandards.org/Math/Content/7/SP/B/4/" } "educationalAlignment": { "@type": "AlignmentObject", "educationalFramework": "NCERT", "targetUrl": "https://ncert.nic.in/" } |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
educationalLevel |
视频的目标教育水平。将目标教育水平设置为适用于特定国家/地区的值或通用值。 适用于特定国家/地区的值：
每个国家/地区都有自己的学术体系。根据视频的适用国家/地区，将
示例： "educationalLevel": "10th Grade (AR)" 通用值：
您只能将其中一个通用值指定为
"educationalLevel": "Beginner" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
learningResourceType |
视频中的内容类型，根据视频想要实现的目标而定。此属性可用在视频级别（如果视频只有一个内容类型），也可用在剪辑级别（如果视频有多个内容类型）。下面列举了一些可接受值的示例。如果您的视频与下面的所有值均不符，您可以创建新值，因为我们会考虑支持新的值。请注意，如果相应值未设为下列值之一，学习类型信息便不得用在任何搜索结果功能中。
"learningResourceType": "Problem walkthrough" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 建议属性 | |
|---|---|
educationalAlignment.educationalFramework
|
与内容相关联的正式标准的名称。 "educationalFramework": "Common Core" |
educationalAlignment.targetName |
标准代码或节点（例如 CCSS.MATH.CONTENT.7.SP.B.4、AP physics A、CCSS.MATH）。 "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
指向标准说明的网址。 "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
视频中的剪辑列表。每个剪辑都必须侧重于特定的主题或问题。
教育类 下面是一个问题演示剪辑示例： { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 1", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 201, "url": "https://www.example.com/example?t=201" } 下面是一个概述相关概念的剪辑的示例： { "@type": ["Clip","LearningResource"], "learningResourceType": "Concept Overview", "name": "ABC Law", "startOffset": 501, "url": "https://www.example.com/example?t=501" } |
text |
视频中要解决的问题的文字。该属性必须包含完整的问题，而不只是问题的标题。
如果您的视频解决多个问题，您可以使用相同的属性，但应选择 "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
学习剪辑 [Clip, LearningResource]
您可以在学习视频中将学习剪辑指定为 hasPart 属性的一部分。下面列出了针对剪辑提供的建议属性。
使用 [Clip, LearningResource] 类型标记学习剪辑。除了 Clip 的必要属性和建议属性之外，您还可以为学习剪辑添加以下属性。
| 建议属性 | |
|---|---|
learningResourceType |
剪辑中的内容类型，根据剪辑想要实现的目标而定。如果剪辑中提供了问题的分步解决方法，则可以将值设为 下面列举了一些可接受值的示例。如果您的剪辑与下面的所有值均不符，您可以创建新值，因为我们会考虑支持新的值。请注意，如果相应值未设为下列值之一，相关信息便不得用在任何搜索结果功能中。 可接受以下值：
"learningResourceType": "Problem walkthrough" |
问题演示视频 [VideoObject, LearningResource]
问题演示视频是学习视频的一种子类型，可提供问题的分步解决方法。
对问题演示视频使用 [VideoObject, LearningResource] 类型。
除了 VideoObject 的必要属性和建议属性之外，您还可以为问题演示视频添加以下属性。
| 必要属性 | |
|---|---|
learningResourceType |
视频中的内容类型，根据视频想要实现的目标而定。对于问题演示视频，必须将其设置为“问题演示”。 "learningResourceType": "Problem walkthrough" |
| 建议属性 | |
|---|---|
hasPart |
视频中的剪辑列表。每个剪辑都必须侧重于特定的问题。
教育类 下面是一个包含问题演示的剪辑的示例： [ { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 1", "text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.", "startOffset": 201, "url": "https://www.example.com/example?t=201" }, { "@type": ["Clip","LearningResource"], "learningResourceType": "Problem Walkthrough", "name": "Example 2", "text": "Consider two weights suspended from five wires as shown in Figure. Find the tension in all wires.", "startOffset": 501, "url": "https://www.example.com/example?t=501" } ] |
text |
视频中要解决的问题的文字。
如果视频解决多个问题，您可以在 "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
问题演示剪辑 [Clip, LearningResource]
您可以在学习视频中将问题演示剪辑指定为 hasPart 属性的一部分。问题演示剪辑是学习剪辑的子类型，其中包含问题的分步解决方法。下面列出了针对问题演示剪辑的必要属性。
对学习剪辑使用 [Clip, LearningResource] 类型。除了 Clip 的必要属性和建议属性之外，您还可以为问题演示剪辑添加以下属性。
| 必要属性 | |
|---|---|
learningResourceType |
如果剪辑中提供了问题的分步解决方法，则必须将值设为 "learningResourceType": "Problem walkthrough" |
| 建议属性 | |
|---|---|
text |
剪辑中要解决的问题的文字。 "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
使用 Search Console 监控富媒体搜索结果
Search Console 是一款工具，可帮助您监控网页在 Google 搜索结果中的显示效果。即使没有注册 Search Console，您的网页也可能会显示在 Google 搜索结果中，但注册 Search Console 能够帮助您了解 Google 如何查看您的网站并做出相应的改进。建议您在以下情况下查看 Search Console：
首次部署结构化数据后
等 Google 将网页编入索引后，请在相关的富媒体搜索结果状态报告中查看是否存在问题。 理想情况下，有效项目数量会增加，而无效项目数量不会增加。如果您发现结构化数据存在问题，请执行以下操作：
发布新模板或更新代码后
如果对网站进行重大更改，请监控结构化数据无效项目的增幅。- 如果您发现无效项目增多了，可能是因为您推出的某个新模板无法正常工作，或者您的网站以一种新的错误方式与现有模板交互。
- 如果您发现有效项目减少了（但无效项目的增加情况并不对应），可能是因为您的网页中未再嵌入结构化数据。请通过网址检查工具了解导致此问题的原因。
定期分析流量时
请使用效果报告分析您的 Google 搜索流量。数据将显示您的网页在 Google 搜索结果中显示为富媒体搜索结果的频率、用户点击该网页的频率以及网页在搜索结果中的平均排名。您还可以使用 Search Console API 自动提取这些结果。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.
内容与结构化数据不匹配
error 导致问题的原因：网页包含的内容与该网页上的结构化数据不匹配。例如，该网页上某个视频的标题与为 name 属性列出的值不匹配。此外，该网页上也可能存在垃圾内容，例如点击诱饵类的标题和说明，或者标记不代表实际视频。您可能收到了以下 Search Console 消息：“违反了结构化数据政策 - 我们发现网页上的内容与网页上的结构化数据不同。”
done 解决问题
- 确认结构化数据与网页上的实际内容一致。
- 使用网址检查工具确保相关内容在呈现的网页上可见（呈现的网页是指向 Google 呈现的网页）。
- 解决问题后，请提交网站以供重新审核。