教學影片 (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>
如何新增結構化資料
結構化資料是一種標準化格式，能夠提供網頁相關資訊並分類網頁內容。如果您是第一次使用結構化資料，請參閱這篇文章，進一步瞭解結構化資料的運作方式。
以下簡要說明如何建立、測試及發布結構化資料。
- 新增必要屬性。根據您使用的格式，瞭解要在網頁中的什麼位置插入結構化資料。
- 遵循指南規範。
- 使用複合式搜尋結果測試驗證程式碼，並修正所有重大錯誤。此外，我們也建議您修正工具中可能標記的任何非重大問題，因為這有助於改善結構化資料的品質 (但並非符合複合式搜尋結果的顯示條件)。
- 部署幾個包含結構化資料的網頁，並使用網址檢查工具測試 Google 轉譯網頁的情形。請確認 Google 可以存取您的網頁，且網頁並未遭到 robots.txt 檔案或
noindex標記封鎖，也未設有登入規定。如果網頁看起來沒問題，您可以要求 Google 重新檢索您的網址。 - 為了讓 Google 掌握日後的異動內容，建議您提交 Sitemap。您可以使用 Search Console Sitemap API 自動執行這項操作。
指南規範
您必須遵守以下指南規範，才能讓網頁顯示教學影片複合式搜尋結果：
技術指南
- 除了教學影片標記之外，您還必須新增
VideoObject必要屬性和建議屬性。 - 影片必須公開，讓使用者不需訂閱即可觀看。
- 影片總長度必須至少為 30 秒。
- 教學影片標記必須新增到使用者可以觀看影片的網頁中。如果將使用者導向無法觀看影片的網頁，會導致使用者體驗不佳。
結構化資料類型定義
VideoObject 和 LearningResource 的完整定義可以在 schema.org VideoObject 和 LearningResource 上取得。
您的內容必須包含必要的屬性，才能以教學影片複合式搜尋結果的形式呈現。您也可以加入建議的屬性，為內容增添更多相關資訊，提供更優質的使用者體驗。
教學影片 [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 物理 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 |
影片中的內容類型取決於影片的目的。如果是問題逐步操作說明影片，這個欄位必須設為「Problem walkthrough」。 "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 搜尋中的成效。 Google 會主動將您的網頁納入搜尋結果，您無需為此申請使用 Search Console，但是您可以藉由這項服務瞭解並改善 Google 檢索您網站的方式。建議在下列情況查看 Search Console：
首次部署結構化資料後
在 Google 為網頁建立索引後，請透過相關的複合式搜尋結果狀態報告查看是否存在任何問題。理想情況下，有效項目會增加，但無效項目不會變多。如果您在結構化資料中發現問題，請依下列步驟操作：
發布新範本或更新程式碼後
當您對網站進行大幅變更時，請留意結構化資料中無效項目是否增加。- 如果無效項目增加，代表您推出的新範本可能無法正常運作，或者您的網站採用新方式與現有範本互動，但效果不佳。
- 如果有效項目減少，但錯誤並未隨之增加，代表您的網頁可能已不再內嵌結構化資料。請使用網址檢查工具找出問題的成因。
定期分析流量
透過成效報表分析您的 Google 搜尋流量。 這些資料會顯示您的網頁在 Google 搜尋中呈現為複合式搜尋結果的頻率、使用者點擊的頻率，以及您的搜尋結果平均排名。您也可以使用 Search Console API 自動提取這些結果。疑難排解
如果無法順利導入結構化資料，或是偵錯時遇到困難，請參考下列資源。
- 如果您使用內容管理系統 (CMS) 或者有他人代您處理網站事務，請向對方尋求協助。請務必將所有與問題相關的 Search Console 訊息都轉寄給對方，這些訊息會針對問題提供詳細說明。
- Google 不保證採用結構化資料的功能一定會顯示在搜尋結果中。如要瞭解為何 Google 無法將您的內容顯示為複合式搜尋結果，請參閱結構化資料通用指南裡的常見原因清單。
- 結構化資料可能含有錯誤。請查看結構化資料錯誤清單。
- 如果您的網頁遭到結構化資料專人介入處理處置，系統會忽略網頁上的結構化資料，但該網頁仍然會出現在 Google 搜尋結果中。請使用專人介入處理報告來修正結構化資料問題。
- 再次查看指南規範，確認您的內容是否符合規定。問題可能是因為垃圾內容或不當使用的標記所引起。不過，因為問題可能與語法無關，所以複合式搜尋結果測試無法找出問題所在。
- 疑難排解：未出現複合式搜尋結果/複合式搜尋結果總數減少。
- 請等待一段時間，讓系統執行重新檢索和重新建立索引作業。在發布網頁後，Google 可能需要幾天時間才會找到網頁並進行檢索。如有關於檢索和索引建立作業的一般問題，請參閱 Google 搜尋檢索和索引常見問題。
- 前往 Google 搜尋中心論壇發文提問。
內容與結構化資料不符
error 問題發生原因：網頁上的內容與網頁的結構化資料不相符。舉例來說，網頁上的影片標題與 name 屬性所列的值不相符。此外，也可能包含垃圾資訊內容 (例如誘騙點擊的標題和說明)，或是標記與實際影片有所出入。您可能已收到 Search Console 寄來的郵件：「違反結構化資料政策 - 系統發現頁面上的內容與頁面的結構化資料不同」。
done 修正問題