Video
import YoastSchemaExample from '../../../../src/components/YoastSchemaExample';
描述单个视频(通常在嵌入式媒体对象的上下文中)。
触发条件
应作为图谱中的顶级节点添加,当其他节点需要时。例如,当 WebPage 包含嵌入式视频时。
必需属性
一个有效的 VideoObject 必须包含以下属性。
@type: VideoObject。
@id: 网站的首页 URL 后追加 #/schema/VideoObject/{{ID}},其中 {{ID}} 是一个唯一标识符。
name: 视频的标题。
description: 视频的描述(回退到 caption,再回退到 'No description')。
thumbnail: 一个通过 ID 引用、代表视频内容的 ImageObject。
uploadDate: 视频发布的日期,采用 ISO 8601 格式(例如 2020-01-20)。
失败场景
如果任何必填字段缺失或无效,则不应输出该节点。
如果未输出节点,则任何原本会声明与 VideoObject 存在关系的实体(例如,作为 Article 的一部分)都应移除这些引用。
可选属性
以下属性应在可用且有效时添加:
caption:视频内容摘要说明。
contentUrl:直接指向视频文件的 URL。
embedUrl:指向视频播放器的 URL。
duration:视频时长,采用 ISO 8601 格式。
width:视频宽度,单位为像素。
height:视频高度,单位为像素。
isFamilyFriendly:视频是否应被视为“适合家庭观看”,默认为 true,可设为 false。
inLanguage:视频内容的语言代码;例如 en-GB。
条件属性
仅在满足必要条件时才应输出的可选属性。
在 AMP 模板上
publisher: 对视频发布者的 ID 引用。
Examples
Minimum criteria
{`{
"@context": "https://schema.org",
"@graph": [
{
"@type": "VideoObject",
"@id": "https://www.example.com/#/schema/VideoObject/abc123",
"name": "Example video",
"description": "Example video description",
"thumbnailUrl": {
"@id": "https://www.example.com/uploads/example-image.jpg"
},
"uploadDate": "2016-03-31T08:00:00+08:00"
}
]
}`}
Extended criteria
{`{
"@context": "https://schema.org",
"@graph": [
{
"@id": "https://www.example.com/#/schema/VideoObject/abc123",
"@type": "VideoObject",
"contentUrl": "https://www.example.com/videos/video123.mp4",
"description": "Example video description",
"duration": "PT1M54S",
"embedUrl": "https://www.example.com/videos/embed/video123/",
"height": 640,
"inLanguage": "en-US",
"isFamilyFriendly": true,
"name": "Example video",
"thumbnail": {
"@id": "https://www.example.com/uploads/example-image.jpg"
},
"uploadDate": "2016-03-31",
"width": 480
}
]
}`}