学習用動画（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>複数のクリップを含む学習用動画
以下に、3 つのクリップを含む学習用動画の例を示します。問題のチュートリアルのクリップが 2 つ、コンセプトの概要を示すクリップが 1 つ含まれています。
<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 をご覧ください。
- 必須プロパティを追加します。使用している形式に基づいて、ページ上の構造化データを挿入する場所をご確認ください。
- ガイドラインに従います。
- リッチリザルト テストでコードを検証し、重大なエラーを修正します。ツールで報告される重大ではない問題の修正も検討してください。構造化データの品質向上に役立ちます（ただし、リッチリザルトの対象となるために必ずしも必要というわけではありません）。
- 構造化データが含まれているページを数ページ導入し、URL 検査ツールを使用して、Google でページがどのように表示されるかをテストします。Google がページにアクセスでき、robots.txt ファイル、
noindexタグ、ログイン要件によってページがブロックされていないことを確認します。ページが正常に表示されたら、Google に URL の再クロールを依頼できます。 - 今後の変更について Google に継続して情報を提供するために、サイトマップを送信することをおすすめします。これは、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 |
動画の目的に基づく、動画のコンテンツ タイプ。このプロパティは、動画レベル（動画のコンテンツ タイプが 1 つのみの場合）またはクリップレベル（動画に複数のコンテンツ タイプが存在する場合）で使用できます。使用可能な値の例を以下の一覧に示します。動画がいずれの値にも適合しない場合は、新しい値を作成できます。Google は新しい値のサポートを検討しています。ただし、以下のリストにない値が設定されている場合、学習タイプの情報はどの検索結果の機能にも表示されません。
"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 |
標準の説明の URL。 "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 |
クリップの目的に基づく、クリップのコンテンツ タイプ。問題の詳細な解答手順がクリップに含まれる場合は、値を 使用可能な値の例を以下の一覧に示します。クリップがいずれの値にも適合しない場合は、新しい値を作成できます。Google は新しい値のサポートを検討しています。ただし、以下のリストにない値が設定されている場合、学習タイプの情報はどの検索結果の機能にも表示されません。 使用できる値:
"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 検索におけるページのパフォーマンスを監視できるツールです。Search Console に登録していなくても Google 検索結果に表示されますが、登録することにより、Google がサイトをどのように認識しているかを把握して改善できるようになります。次の場合は Search Console を確認することをおすすめします。
構造化データを初めてデプロイした後
ページがインデックスに登録されたら、関連するリッチリザルトのステータス レポートを使用して、問題がないかどうかを確認します。有効な項目が増え、無効な項目が増えていない状態が理想的です。構造化データに問題が見つかった場合の手順は次のとおりです。
- 無効な項目を修正します。
- 一般公開 URL の検査を行い、問題が解決したかどうかを確認します。
- ステータス レポートを使用して検証をリクエストします。
新しいテンプレートをリリースした後やコードを更新した後
ウェブサイトに大幅な変更を加えた場合は、構造化データの無効な項目が増加しないかどうか監視します。- 無効な項目が増加した場合は、新しく公開したテンプレートが正常に機能していないか、既存のテンプレートの新しい操作方法に問題があると考えられます。
- 有効な項目が減少している（無効な項目の増加と一致しない）場合は、ページに構造化データが埋め込まれていない可能性があります。URL 検査ツールを使用して問題の原因を特定します。
トラフィックを定期的に分析する場合
パフォーマンス レポートを使用して Google 検索のトラフィックを分析します。このデータから、検索でページがリッチリザルトとして表示される頻度、ユーザーがページをクリックする頻度、検索結果におけるページの平均掲載順位がわかります。この結果は、Search Console API を使用して自動的に取得することもできます。トラブルシューティング
構造化データの実装またはデバッグで問題が発生した場合は、以下のリソースが参考になります。
- コンテンツ管理システム（CMS）を使用している場合や、サイトが他者によって管理されている場合は、それに応じて支援を依頼してください。その際は、問題の詳細を含む Search Console のメッセージを必ず転送してください。
- 構造化データを使用するコンテンツが必ず検索結果に表示されるとは限りません。コンテンツがリッチリザルトに表示されないときのよくある原因については、構造化データに関する一般的なガイドラインをご覧ください。
- 構造化データにエラーがある可能性があります。構造化データエラーの一覧を確認してください。
- 構造化データへの手動による対策をページに対して実施すると、ページ上の構造化データが無視されるようになります（ただし、Google 検索結果にはページは引き続き表示されます）。構造化データの問題を修正するには、手動による対策レポートを使用します。
- ガイドラインを再度確認し、コンテンツがガイドラインを遵守していないことを確認します。スパム コンテンツまたはスパム マークアップの使用が原因で、問題が発生する場合がありますが、これは構文の問題ではない可能性があり、リッチリザルト テストでは特定できません。
- リッチリザルトが見つからない場合またはリッチリザルトの合計数が不足している場合のトラブルシューティングをご覧ください。
- 再クロールとインデックスの再登録に要する時間を考慮してください。ページを公開した後、Google が対象のページを検出してクロールするまでに数日を要する場合があることに留意してください。クロールとインデックス登録に関する一般的な質問については、Google 検索のクロールとインデックス登録に関するよくある質問をご覧ください。
- Google 検索セントラル フォーラムでもご質問をお受けしています。
コンテンツが構造化データと一致しない
error 問題の原因: そのページの構造化データと一致しないコンテンツがページに含まれています。たとえば、ページ上での動画のタイトルが name プロパティで指定されている値と一致していない場合があります。クリックベイトのタイトルや説明文など、スパム行為が関連するコンテンツが含まれている可能性もあります。または、マークアップが実際の動画を表していないことが考えられます。このような場合、「構造化データのポリシー違反 - ページ上のコンテンツがページの構造化データと異なっています」という Search Console のメッセージが表示されることがあります。
done 問題の修正方法
- 構造化データがページ上の実際のコンテンツと一致していることを確認します。
- URL 検査ツールを使用して、レンダリングされたページにコンテンツが表示されていることを確認します（レンダリングされたページは Google から見えるページの状態です）。
- 問題を解決したら、再審査を受けるためにサイトを送信します。