Video

Example of a video rich result and videos in image search

Mark up your video content with structured data to make Google Search an entry point for discovering and watching videos. You can provide details such as the description, thumbnail URL, upload date, and duration. Google may use your markup to power carousels (for example, the Top stories carousel with AMP). Video markup enables a badge on the image in mobile image search results, which can encourage more users to click your content.

Examples

Here's an example of video structured data for AMP using JSON-LD.

Here's an example of standard video markup using JSON-LD.

Here's an example of a video with clips using JSON-LD. Learn more about how to use clips with How-to structured data.

Structured data type definitions

The full definition of VideoObject is available at schema.org/VideoObject. You must include the required properties for your content to be eligible for display as a rich result. You can also include the recommended properties to add more information about your content, which could provide a better user experience.

Required properties
description

Text

The description of the video.

name

Text

The title of the video

thumbnailUrl

Repeated field of ImageObject or URL

A URL pointing to the video thumbnail image file.

其他圖片規範:

  • 每一頁都必須包含至少一張圖片 (無論是否已加上標記)。Google 會根據長寬比和解析度選擇最適當的圖片顯示在搜尋結果中。
  • 圖片網址必須可供檢索和建立索引
  • 圖片必須代表加上標記的內容。
  • 圖片必須採 .jpg、.png 或 .gif 格式。
  • 為獲得最佳效果,請提供多張高解析度圖片 (寬度乘以高度至少要 5 萬像素),長寬比分別為 16x9、4x3 和 1x1。

例如:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
uploadDate

Date

The date the video was first published, in ISO 8601 format.

Recommended properties
contentUrl

URL

A URL pointing to the actual video media file.

Make sure to follow our Video best practices.

duration

Duration

The duration of the video in ISO 8601 format.

embedUrl

URL

A URL pointing to a player for the specific video. Usually this is the information in the src element of an <embed> tag.

Make sure to follow our Video best practices.

expires

Text

If applicable, the date after which the video will no longer be available, in ISO 8601 format. Don't supply this information if your video does not expire.

hasPart

CreativeWork

A video clip that is part of the entire video. To add clips to steps in a how-to page, see How-to structured data.

hasPart.endOffset

Number

The end time of the clip expressed as the number of seconds from the beginning of the video.

hasPart.name

Text

The name of the clip. For example, "Pull and tighten" could be the name of the clip that shows how to pull and tighten a tie.

hasPart.startOffset

Number

The start time of the clip expressed as the number of seconds from the beginning of the video.

hasPart.url

URL

A link to the start time of the clip. The start time must match the value set in hasPart.startOffset. For example:

"startOffset": 30,
"endOffset": 45,
"url": "http://www.example.com/example&t=30"
interactionCount

Text

The number of times the video has been viewed.

傳送您對下列選項的寶貴意見...

這個網頁