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 } ] }`}