Video

描述单个视频（通常在嵌入式媒体对象的上下文中）。

触发条件

应作为图谱中的顶级节点添加，当其他节点需要时。例如，当 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
        }
    ]
}

触发条件​

必需属性​

失败场景​

可选属性​

条件属性​

在 AMP 模板上​

Examples​

Minimum criteria​

Extended criteria​