동영상 스키마 생성기

동영상 스키마를 만드는 방법

필수 속성 셋, 거의 모두가 틀리는 날짜 형식 하나, 그리고 지금 보고 있는 페이지가 아닌 URL 칸 둘. 생성기는 같은 값으로 마크업과 설명 블록을 함께 씁니다.

1. 제목과 썸네일부터 넣습니다. 둘 다 필수이고 둘 다 이 영상에만 해당해야 합니다. 썸네일은 다음 달에도 같은 URL일 때만 쓸모가 있습니다. URL을 금방 바꾸는 CDN은 동영상 색인을 조용히 잃게 만듭니다.
2. 업로드 시각에 오프셋을 붙입니다. 날짜만 있어도 유효하지만, 날짜와 시각과 UTC 오프셋이 함께 있어야 모호하지 않습니다. 한국에서 올린 영상이라면 +09:00입니다.
3. 재생 시간은 편한 형식으로 적습니다. 18:42, 1:02:30, 초 단위 숫자, ISO 문자열 중 무엇이든 됩니다. 결과는 언제나 속성이 요구하는 ISO 8601 기간입니다.
4. contentUrl은 파일에, embedUrl은 플레이어에. 둘 다 방문자가 도착하는 페이지가 아닙니다. 웹페이지처럼 보이는 contentUrl은 생성기가 거부합니다. 유튜브 영상이라면 contentUrl은 비우고 embedUrl에 youtube.com/embed 주소를 넣습니다.
5. 챕터를 더하고 두 결과물을 붙여넣습니다. 챕터 링크는 보기 페이지 URL에 시간 매개변수를 붙여 만듭니다. 구글이 요구하는 형태입니다. JSON-LD는 보기 페이지에, 설명 블록은 플레이어 아래에 넣습니다.

uploadDate: +09:00을 적지 않으면 생기는 일

동영상 스키마 생성기는 영상 정보를 VideoObject 유형의 JSON-LD, 즉 구글이 동영상의 제목·썸네일·재생 시간·중요한 부분을 읽어 가는 구조화된 데이터로 바꿔 주는 도구입니다. 필수 속성은 name, thumbnailUrl, uploadDate 셋입니다. 세 번째가 마크업이 미묘하게 틀어지는 곳입니다.

구글의 한국어 문서는 uploadDate를 동영상이 처음으로 게시된 날짜와 시간(ISO 8601)으로 정의하고 이렇게 덧붙입니다. 시간대 정보를 제공하는 것이 좋으며, 제공하지 않은 경우 Googlebot에서 사용하는 시간대가 기본값으로 설정됩니다. 날짜만 있는 2026-08-14도 받아들여집니다. 하지만 오프셋 없이 적은 19:30은 한국 시간이 아니라 Googlebot 시간대의 19:30으로 읽히므로, 한국 달력으로 보면 게시일이 하루 어긋날 수 있습니다. 새로움이 곧 게시 이유인 영상이라면 작은 문제가 아닙니다.

"uploadDate": "2026-08-14"                    // 유효, 시각 없음
      "uploadDate": "2026-08-14T19:30:00"           // 시각은 있지만 어느 시계인지 모름
      "uploadDate": "2026-08-14T19:30:00+09:00"     // 모호하지 않음(한국 표준시)

같은 권고가 expires에도 붙고, 구글은 흔히 무시되는 지시를 하나 더합니다. 동영상이 만료되지 않는다면 expires를 아예 넣지 말라는 것입니다. 만료일이 과거가 되면 그 동영상은 동영상 검색결과에 나오지 않습니다. 빈 값이나 먼 미래의 만료일은 중립이 아니라 하나의 주장입니다. 네이버 동영상 검색 역시 영상 생성일(uploadDate)을 검색결과에 노출되는 필수 정보로 둡니다.

유튜브, 네이버TV, 자체 호스팅: 어디에 올렸느냐에 따라 달라지는 것

• 유튜브 영상을 삽입한 페이지. 구글 문서에 따르면 유튜브, Vimeo, Facebook 같은 서드 파티 플랫폼의 동영상을 삽입하면 구글은 내 웹페이지와 그 플랫폼의 페이지 둘 다에서 동영상 색인을 생성할 수 있고, 동영상 색인 생성 기준을 충족하는 한 둘 다 동영상 기능에 나올 수 있습니다. 서드 파티 플레이어를 삽입한 내 보기 페이지에도 구조화된 데이터를 제공하는 것이 좋다고 합니다. 이때 동영상 파일은 내게 없으니 contentUrl은 비우고, embedUrl에 삽입 코드의 주소(https://www.youtube.com/embed/VIDEO_ID 형식)를 넣습니다.
• 유튜브 영상의 챕터. 구글은 동영상이 유튜브에 호스팅되는 경우 유튜브의 동영상 설명에 타임스탬프와 라벨을 정확히 지정하라고 안내합니다. 내 페이지의 Clip 마크업은 그 페이지의 ?t= 링크가 실제로 그 시점부터 재생될 때에만 성립합니다. 구글의 Clip 가이드라인이 동영상 URL의 시작점이 아닌 지점으로 딥 링크할 수 있어야 한다고 요구하기 때문입니다. 유튜브 플레이어를 퍼 왔을 뿐이라면 설명란 타임스탬프 쪽이 문서가 말하는 경로입니다.
• 네이버TV는 2026년 9월 30일에 종료됩니다. 네이버 검색광고 공지(2026-09-14 업데이트)가 이 날짜를 적고 있습니다. 네이버TV 플레이어를 삽입해 둔 보기 페이지라면 embedUrl이 가리키는 플레이어가 종료 뒤에도 동작한다는 보장이 없으니, 영상을 옮긴 뒤 마크업을 다시 만드세요.
• 내 서버에 올린 파일. 이 경우에만 contentUrl에 .mp4 같은 파일 주소를 넣을 수 있고, 구글은 가능하면 이것을 제공하라고 합니다. 구글이 동영상 콘텐츠 파일을 가져가는 가장 효과적인 방법이기 때문입니다.

네이버 동영상 검색: 마크업만으로는 들어가지 않습니다

네이버 서치어드바이저의 동영상 검색 가이드(2026년 9월 갱신)는 네이버 동영상 검색이 네이버의 동영상 서비스뿐 아니라 수집을 통해 외부 서비스의 동영상도 검색 결과로 제공한다고 밝힙니다. 다만 들어가는 길은 구글과 다릅니다.

1. 제휴 신청이 먼저입니다. 네이버 제휴 제안에서 제휴 희망 영역은 서비스 콘텐츠 제휴, 세부 영역은 동영상콘텐츠 제휴로 신청합니다.
2. 영상 문서와 채널 문서가 모두 필요합니다. 영상 상세 페이지는 최상위 @type이 VideoObject, 채널 페이지는 Person입니다. 영상 문서의 채널 정보는 creator(Person) 안에 name과 url로 넣고, channelName이나 channelUrl을 최상위에 평면 속성으로 두지 않습니다.
3. 수집은 푸시로 요청합니다. 서치어드바이저에서 사이트 소유 확인을 마친 뒤 수집요청 API로 URL을 보냅니다. 검색 결과에 노출되는 URL, 브라우저로 렌더링되는 URL, 구조화된 데이터가 들어 있는 URL은 같아야 합니다.

이 생성기의 결과물에는 creator가 없습니다. 네이버 동영상 검색까지 노린다면 채널 이름과 채널 페이지 URL을 담은 creator 객체를 직접 더하세요. 가이드의 검증 체크리스트에는 JSON-LD의 값이 실제 페이지에서 사용자에게 보이는 내용과 일치하는지 확인하라는 항목도 있습니다. 이 생성기가 마크업과 같은 문자열로 설명 블록을 함께 쓰는 이유가 바로 그것입니다. 스크립트 태그 안에만 있는 설명은 읽는 사람에게도, 인용할 문장을 찾는 AI 답변 엔진에게도 아무것도 주지 않습니다.

재생 시간, 파일 URL, 썸네일: 구글이 숫자로 적어 둔 규칙

duration은 ISO 8601 기간이지 시각도 초 숫자도 아닙니다. PT00H30M5S는 30분 5초입니다. 이 양식은 18:42, 1:02:30, 742, ISO 문자열을 받아 ISO 형식으로 내보내고, 읽을 수 없는 값은 그대로 흘려보내지 않고 오류로 멈춥니다.

contentUrl은 지원되는 파일 형식인 동영상 파일의 실제 콘텐츠 바이트를 가리켜야 하고, 구글 문서는 동영상이 있는 페이지로 링크하지 말라고 못 박습니다. embedUrl은 플레이어의 URL이고 역시 페이지가 아닙니다. 이 생성기는 확장자가 없거나 HTML 계열인 contentUrl을 경고가 아닌 오류로 다룹니다. 다른 곳은 모두 검증을 통과하는데 영상이 나타나지 않는다면 먼저 이 칸을 의심하세요.

챕터는 hasPart에 중첩한 Clip이고, 여기에는 놓치기 쉬운 규칙이 붙어 있습니다. 클립 URL은 시간을 지정하는 쿼리 매개변수를 더한, 동영상과 같은 URL 경로로 연결돼야 합니다. 이 양식에 보기 페이지 URL을 주면 각 챕터는 그 URL에 ?t=와 초 단위 오프셋을 붙인 형태로 나옵니다. 구글은 조건을 더 답니다. 동영상의 총 재생 시간은 30초 이상이어야 하고, 같은 페이지의 같은 동영상에서 두 클립의 시작 시간이 같아서는 안 됩니다. 이 도구는 영상이 끝난 뒤에 시작하는 챕터도 거부합니다. 구글 쪽에서 보면 잘못 친 타임스탬프가 그렇게 생겼습니다. 참고로 URL 구조만 알려 주고 중요한 부분은 구글이 찾게 하는 SeekToAction은 지원 언어 목록에 한국어가 들어 있습니다.

같은 원칙 — 원고 하나, 결과물 둘, 어긋남 없음 — 을 질문과 답변에 적용한 것이 FAQ 스키마 생성기이고, 레시피의 재료와 조리 순서에 적용한 것이 레시피 스키마 생성기입니다.