`video`

A video or music video with provider and id.

Version 1 · schema video.v1.schema.json

Layouts

Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.

Fields

The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.

Field	Type	Required	Notes
`kind`	`enum`	yes	video · music
`provider`	`enum`	yes	youtube
`video_id`	`string`	yes
`title`	`string`	yes
`channel`	`string`	yes
`thumbnail_url`	`url`	yes	WebKnox media URL: https://webknox.com/media/v1/<host>/<path>. Treat it as opaque.
`duration_s`	`integer \| null`	yes
`watch_url`	`url`	yes
`embed_allowed`	`boolean`	yes	false when the owner blocks embedding; link out instead.

Example

A recorded answer to “Play Bohemian Rhapsody”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_98b0273223e4",
4  "matched": true,
5  "locale": "en",
6  "skill": "music",
7  "confidence": 0.9,
8  "text": "Playing Queen – Bohemian Rhapsody. https://www.youtube.com/watch?v=fJ9rUzIMcZQ",
9  "speech": "Playing Queen – Bohemian Rhapsody.",
10  "card": {
11    "type": "video",
12    "version": 1,
13    "data": {
14      "kind": "music",
15      "provider": "youtube",
16      "video_id": "fJ9rUzIMcZQ",
17      "title": "Queen – Bohemian Rhapsody (Official Video Remastered)",
18      "channel": "Queen Official",
19      "thumbnail_url": "https://webknox.com/media/v1/i.ytimg.com/vi/fJ9rUzIMcZQ/hqdefault.jpg",
20      "duration_s": null,
21      "watch_url": "https://www.youtube.com/watch?v=fJ9rUzIMcZQ",
22      "embed_allowed": true
23    }
24  },
25  "sources": [
26    {
27      "name": "YouTube",
28      "url": "https://www.youtube.com/watch?v=fJ9rUzIMcZQ",
29      "license": null
30    }
31  ],
32  "follow_ups": [],
33  "actions": [],
34  "usage": {
35    "billable": true
36  }
37}