구조·마크업 · 공식 문서
동영상 주요 순간 설정, Clip과 SeekToAction 선택 기준
영상이 있는 페이지의 VideoObject 구조화된 데이터 안에 Clip(구간마다 이름과 시작·끝 시각)이나 SeekToAction(URL의 시각 자리)을 넣으면 구글에 주요 순간을 알릴 수 있습니다. 유튜브에 올린 영상은 설명란에 타임스탬프와 이름을 적는 방법도 있습니다.
동영상 결과 아래에 장면별 시각과 이름이 붙어 나오는 것이 주요 순간입니다. 구글은 이 구간을 스스로 찾기도 하고, 사이트가 알려 준 구간을 먼저 쓰기도 합니다.
알리는 길은 Clip, SeekToAction, 유튜브 설명란 세 가지이고, 끄는 길이 하나 더 있습니다. 어느 쪽을 고를지는 영상 수와 URL 구조로 정해집니다.
발견 01
주요 순간을 알리는 길은 4가지이고, 직접 정한 구간이 먼저 쓰입니다
We will prioritize key moments set by you, either through structured data or the YouTube description.
구조화된 데이터나 유튜브 설명란으로 사이트가 정한 주요 순간을 먼저 씁니다.
| 길 | 고르는 때 | 맞는 사이트 | 공식 문서 원문 |
|---|---|---|---|
| Clip | 구간 이름과 시작·끝 시각을 직접 정할 때 | 영상 수가 적고 장면마다 이름을 붙이는 사이트 | Clip structured data: Specify the exact start and end time to each segment, and what label to display for each segment. This is supported in all languages where Google Search is available.Clip 구조화된 데이터는 구간마다 정확한 시작·끝 시각과 보여 줄 이름을 적는 방식이고, 구글 검색이 제공되는 모든 언어를 지원합니다. |
| SeekToAction | URL에서 시각이 들어가는 자리만 알리고 구간은 구글에 맡길 때 | 영상이 많은 플랫폼형 사이트 | SeekToAction structured data: Tell Google where timestamps typically go in your URL structure, so that Google can automatically identify key moments and link users to those points within the video. This is supported for the following languages: English, Spanish, Portuguese, Italian, Chinese, French, Japanese, German, Turkish, Korean, Dutch, and Russian.SeekToAction 구조화된 데이터는 URL 구조에서 시각이 들어가는 자리를 알려 구글이 주요 순간을 자동으로 찾고 그 지점으로 연결하게 하는 방식이며, 한국어를 포함한 12개 언어를 지원합니다. |
| 유튜브 설명란 | 영상이 유튜브에 올라가 있을 때 | 유튜브 채널을 함께 운영하는 사이트 | If your video is hosted on YouTube, you can specify the exact timestamps and labels in the video description on YouTube.유튜브에 올린 영상은 유튜브 영상 설명에 타임스탬프와 이름을 적어 주요 순간을 지정할 수 있습니다. |
| nosnippet | 구간 표시를 아예 끄고 싶을 때 | 구간 미리보기를 원하지 않는 페이지 | To opt out of the key moments feature completely (including any efforts Google may make to show key moments automatically for your video), use the nosnippet meta tag.구글이 자동으로 보여 주는 것까지 포함해 주요 순간을 완전히 끄려면 nosnippet 메타 태그를 씁니다. |
Clip 은 구간 이름을 사이트가 정합니다. SeekToAction 은 URL에서 시각이 들어가는 자리만 알리고, 어디를 구간으로 나눌지는 구글이 정합니다.
장면 이름이 검색 결과에 그대로 보이길 바라면 Clip 을 고릅니다. 구글 문서도 구간을 직접 정하려면 Clip 을 쓰라고 적었습니다.
If you prefer to identify key moments in a video yourself, instead of letting Google automatically identify key moments, use Clip markup instead of SeekToAction.
구글의 자동 식별 대신 주요 순간을 직접 정하고 싶다면 SeekToAction 이 아니라 Clip 마크업을 쓰라는 안내입니다.
발견 02
두 마크업은 공통 조건 4가지와 각자의 조건 하나씩을 지켜야 합니다
| 조건 | 적용 | 공식 문서 원문 |
|---|---|---|
| 영상 URL에 시각을 붙여 중간부터 재생할 수 있어야 합니다 | 둘 다 | The video must have the ability to deep link into some point other than the start point in the video URL. For example, https://www.example.com/example?t=30 starts 30 seconds into a video.영상 URL로 시작점이 아닌 지점에 바로 연결할 수 있어야 합니다. 예를 들어 ?t=30 은 30초 지점부터 재생합니다. |
| 영상을 볼 수 있는 페이지에 마크업을 둡니다 | 둘 다 | VideoObject structured data must be added to a page where users can watch the video. It's a bad user experience to point users to a page where they can't watch the video.VideoObject 구조화된 데이터는 사용자가 영상을 볼 수 있는 페이지에 넣어야 하고, 영상을 볼 수 없는 페이지로 보내는 것은 나쁜 경험이라는 설명입니다. |
| 영상 길이는 30초 이상입니다 | 둘 다 | The total video duration must be a minimum of 30 seconds.영상 전체 길이는 30초 이상이어야 합니다. |
| VideoObject 필수 속성을 채웁니다 | 둘 다 | The video must include the required properties that are listed in the VideoObject structured data documentation.영상은 VideoObject 문서가 정한 필수 속성을 갖춰야 합니다. |
| 구간마다 시작 시각을 다르게 둡니다 | Clip | For Clip structured data only: Make sure that no two clips on the same video defined on the same page share a start time.Clip 만 해당: 같은 페이지의 같은 영상에서 두 구간이 같은 시작 시각을 쓰면 안 됩니다. |
| 구글이 영상 파일을 가져갈 수 있어야 합니다 | SeekToAction | For SeekToAction structured data only: Google must be able to fetch your video content files.SeekToAction 만 해당: 구글이 영상 파일을 가져갈 수 있어야 합니다. |
마크업을 넣어도 주요 순간이 늘 나오는 것은 아닙니다. 구글 문서는 기능이 모든 검색어에서 나오지는 않는다고 적었습니다.
그래서 넣은 뒤에는 리치 결과 테스트와 동영상 리치 결과 보고서로 마크업 오류가 없는지를 먼저 봅니다.
Not all features are eligible to trigger on all queries. Google doesn't guarantee that adding markup will result in a specific video feature in Search results; learn why in our general structured data guidelines.
모든 검색어에서 기능이 나오는 것은 아니며, 마크업을 넣는다고 특정 동영상 기능이 검색 결과에 반드시 나오지는 않는다는 설명입니다.
발견 03
Clip 은 구간마다 name·startOffset·url 세 속성을 넣고, endOffset 은 권장입니다
| 속성 | 넣는 값(예) | 필수 여부 | 공식 문서 원문 |
|---|---|---|---|
| name | 대시보드 둘러보기 | 필수 | A descriptive title for the content of the clip.구간 내용을 설명하는 이름. |
| startOffset | 95 | 필수 | The start time of the clip expressed as the number of seconds from the beginning of the work.영상 처음부터 센 초 단위의 구간 시작 시각. |
| url | https://www.example.com/demo?t=95 | 필수 | The clip URL must point to the same URL path as the video with additional query parameters that specify the time.구간 URL은 영상과 같은 URL 경로에 시각을 지정하는 쿼리 파라미터를 더한 것이어야 합니다. |
| endOffset | 239 | 권장 | The end time of the clip expressed as the number of seconds from the beginning of the work.영상 처음부터 센 초 단위의 구간 끝 시각. |
| potentialAction.target (SeekToAction) | https://www.example.com/demo?t={seek_to_second_number} | 필수 | The URL of the page that contains this VideoObject, including a placeholder in the URL structure that indicates where Google can insert the number of seconds to skip to in the video.이 VideoObject 가 있는 페이지 URL로, 구글이 건너뛸 초를 넣을 자리를 자리표시자로 표시한 것. |
| potentialAction.startOffset-input (SeekToAction) | required name=seek_to_second_number | 필수 | 문서가 정한 값을 그대로 씁니다. |
| 구간 이름 | startOffset | endOffset | url |
|---|---|---|---|
| 제품 소개 | 0 | 94 | https://www.example.com/demo?t=0 |
| 대시보드 둘러보기 | 95 | 239 | https://www.example.com/demo?t=95 |
| 보고서 만들기 | 240 | 419 | https://www.example.com/demo?t=240 |
| 외부 서비스 연동 | 420 | 600 | https://www.example.com/demo?t=420 |
발견 04
B2B·B2C·B2G 는 영상 수와 URL 구조가 달라 고르는 길이 갈립니다
예시 ① 업무용 소프트웨어 회사의 제품 데모 영상(B2B)
자사 사이트에 직접 올린 데모 영상 하나를 장면별로 나누려 합니다. 구간 이름을 기능 이름으로 붙이고 싶어서 Clip 4개를 넣습니다.
플레이어가 ?t=95 처럼 시각 파라미터를 받는지 먼저 확인하고, 시작 시각이 겹치지 않게 적습니다.
예시 ② 상품 영상이 많은 쇼핑몰(B2C)
상품마다 사용법 영상이 있어 영상이 수백 개입니다. 구간 이름을 하나하나 적기 어려워 SeekToAction 을 템플릿에 한 번 넣습니다.
이 길은 구글이 영상 파일을 가져갈 수 있어야 합니다. 영상 파일 URL이 robots.txt 로 차단돼 있지 않은지 함께 봅니다.
예시 ③ 공공기관의 정책 설명회 영상(B2G)
설명회 영상은 유튜브 채널에 올리고 누리집에 임베드합니다. 유튜브 설명란에 시각과 안건 이름을 한 줄씩 적어 둡니다.
누리집의 보기 페이지에서도 구간을 알리려면 그 페이지의 VideoObject 에 같은 시각으로 Clip 을 넣습니다.
그럼 주요 순간은 어떤 순서로 넣나요?
- 영상 길이가 30초 이상인지, 플레이어가 URL의 시각 파라미터로 중간부터 재생되는지 확인합니다.
- 위 선택 기준표로 Clip, SeekToAction, 유튜브 설명란 중 하나를 고릅니다.
- VideoObject 필수 속성이 채워져 있는지 봅니다. 필수 속성은 「VideoObject 구조화된 데이터」 편에 자세히 적었습니다.
- Clip 이면 구간마다 name·startOffset·url 을, SeekToAction 이면 potentialAction 을 넣습니다.
- 리치 결과 테스트로 오류를 확인하고, 몇 페이지에 먼저 올린 뒤 URL 검사 도구로 구글이 보는 화면을 확인합니다.
- 올린 뒤에는 서치 콘솔 동영상 리치 결과 보고서에서 오류가 늘지 않는지 봅니다.
조사 방법
- Google Search Central 「Video (VideoObject, Clip, BroadcastEvent) structured data」 (문서 수정일 2026-09-24) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/appearance/structured-data/video
- Google Search Central 「Video SEO best practices」 (문서 수정일 2025-12-18) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/appearance/video
- 길 4가지와 조건 6가지는 위 문서의 문장을 고르는 순서에 맞춰 묶은 것입니다. 묶는 방식은 편집 판단입니다.
- 예시 ①②③과 예시 구간 값은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- 원문은 영어판(hl=en)이고, 기능·도구 이름은 같은 문서 한국어판(hl=ko) 표기를 따랐습니다.