适用于含嵌入视频的页面。常见类型：VideoObject、Clip、BroadcastEvent。视频能否被编入索引和观看页要求详见《Google 视频索引条件与视频 SEO 做法》。
| 属性 | 类型 | 必需/推荐 | 说明 |
|---|---|---|---|
| name | Text | 必需 | 视频标题 |
| thumbnailUrl | URL 或 URL 数组 | 必需 | 缩略图 |
| uploadDate | DateTime | 必需 | 上传或发布时间 |
| description | Text | 推荐 | 摘要说明 |
| creator（或 author） | Person 或 Organization | 推荐 | 视频创作者，2026-09 加入文档 |
| contentUrl | URL | 推荐 | 直链媒体文件 |
| embedUrl | URL | 推荐 | 嵌入播放器地址 |
| duration | Duration | 推荐 | ISO 8601，如 PT1M33S |
| interactionStatistic | InteractionCounter | 推荐 | 如观看次数 |
| expires | DateTime | 推荐 | 过期时间 |
| hasPart | Clip 数组 | 推荐 | 关键片段（Key Moments） |
| publication | BroadcastEvent | 推荐 | 直播场次信息 |
| regionsAllowed | Text | 推荐 | 允许播放的地区 |
完整 JSON-LD 示例（含关键片段 Clip）：
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "How to Setup a Smart Security Camera",
"description": "Step-by-step guide to setting up your smart security camera at home.",
"thumbnailUrl": [
"https://example.com/photos/video-thumb-1x1.jpg",
"https://example.com/photos/video-thumb-4x3.jpg",
"https://example.com/photos/video-thumb-16x9.jpg"
],
"uploadDate": "2024-03-31T08:00:00+08:00",
"duration": "PT5M33S",
"contentUrl": "https://example.com/videos/setup-camera.mp4",
"embedUrl": "https://example.com/embed/setup-camera",
"interactionStatistic": {
"@type": "InteractionCounter",
"interactionType": { "@type": "WatchAction" },
"userInteractionCount": 48230
},
"regionsAllowed": "US,CA,GB",
"hasPart": [
{
"@type": "Clip",
"name": "Unboxing",
"startOffset": 0,
"endOffset": 60,
"url": "https://example.com/videos/setup-camera?t=0"
},
{
"@type": "Clip",
"name": "Mounting the Camera",
"startOffset": 60,
"endOffset": 180,
"url": "https://example.com/videos/setup-camera?t=60"
},
{
"@type": "Clip",
"name": "Connecting to WiFi",
"startOffset": 180,
"endOffset": 333,
"url": "https://example.com/videos/setup-camera?t=180"
}
]
}直播 BroadcastEvent 示例：
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Product Launch Livestream 2024",
"description": "Watch our latest product launch event live.",
"thumbnailUrl": "https://example.com/photos/livestream-thumb.jpg",
"uploadDate": "2024-06-15T10:00:00+08:00",
"duration": "PT2H",
"embedUrl": "https://example.com/embed/launch-live",
"publication": {
"@type": "BroadcastEvent",
"isLiveBroadcast": true,
"startDate": "2024-06-15T10:00:00+08:00",
"endDate": "2024-06-15T12:00:00+08:00"
}
}来源
- Video (VideoObject, Clip, BroadcastEvent) structured data，https://developers.google.com/search/docs/appearance/structured-data/video（2026-10-05 核对）
