言語

暫定日本語訳：VideoObject Schema

暫定日本語訳：どのように へ implement VideoObject schema 向けに Google's video rich results 全体で 検索, Video tab, 画像, と Discover — 必要 vs. recommended プロパティ, two ways へ 追加 key moments (SeekToAction vs. Clip), と BroadcastEvent LIVE badge.

初回公開：2026年7月1日 · 最終更新：2026年8月4日 · Advanced
言語
AI執筆者：AI v2

暫定日本語訳：VideoObject schema (schema.org/VideoObject) marks up ページ's video so Google できる 表示 video rich results — thumbnail, duration, と key moments — 全体で four surfaces, ない one: main 検索結果 ページ, Video tab, Google 画像, と Google Discover. その multi-surface reach is broader than 大半の 人々 assume と 作る この one of two highest-payoff rich-result types in cluster (alongside Recipe). だけ three プロパティ are 必要 — name, thumbnailUrl, と uploadDate — とともに contentUrl, 説明, duration, embedUrl, expires, interactionStatistic, と 地域 適格性 all recommended. Two features cause 大半の of confusion. Key moments ( chapter timestamps) できる be done two ways: 自動 via SeekToAction/potentialAction if あなた video URLs already accept timestamp パラメーター, または 手動 via Clip markup (name, startOffset, と url are 必要; endOffset is recommended) いつ あなた want publisher-specified labels と timestamps instead of Google's 自動 picks. と LIVE badge isn't separate schema — it's BroadcastEvent (isLiveBroadcast, startDate, endDate — 必要 once あなた're adding BroadcastEvent at all) documented on 同じ ページ と 使用 alongside VideoObject. 大半の 一般的な miss is omitting uploadDate または writing it in inconsistent date format. As 常に, 有効 markup だけ 作る あなた 適格 — Google, と video being crawlable, still decide whether it 表示.

暫定日本語案: TL;DR — schema.org/VideoObject markup (usually JSON-LD) 作る video 暫定日本語案: 適格 向けに video rich results 全体で four Google surfaces — main 検索, 暫定日本語案: Video tab, Google 画像, と Google Discover. 必要: name, thumbnailUrl, 暫定日本語案: uploadDate. Recommended: contentUrl, description, duration, embedUrl, 暫定日本語案: expires, interactionStatistic, と regionsAllowed/ineligibleRegion. Key 暫定日本語案: moments have two mechanisms — 自動 via SeekToAction/potentialAction (if 暫定日本語案: あなた URLs accept timestamp パラメーター Google できる infer) または 手動 via Clip 暫定日本語案: (name, startOffset, と url 必要 per chapter; endOffset recommended). 暫定日本語案: LIVE badge is 暫定日本語案: BroadcastEvent (isLiveBroadcast, startDate, endDate) 使用 alongside 暫定日本語案: VideoObject, documented on 同じ ページ — ない separate system. 大半の 一般的な 暫定日本語案: miss is omitting uploadDate または using inconsistent date format. 有効 markup 暫定日本語案: だけ earns 適格性; Google still decides whether へ 表示 it, と video 暫定日本語案: has へ be crawlable と indexable. この is one of two highest-payoff types in 暫定日本語案: cluster alongside Recipe — worth doing properly. 暫定日本語案: Evidence for this claim Schema.org VideoObject defines vocabulary for a video media object; being valid Schema.org does not by itself guarantee a Google video feature. Scope: Schema.org type definition, distinct from Google eligibility. Confidence: high · Verified: Schema.org: VideoObject Evidence for this claim Google's VideoObject documentation requires name, thumbnailUrl, and uploadDate for video structured-data eligibility and recommends additional properties. Scope: Current Google video structured data requirements; eligibility is not a display guarantee. Confidence: high · Verified: Google Search Central: Video structured data

何 VideoObject schema does — one markup, four surfaces

暫定日本語案: 大半の guides flatten VideoObject へ “get a thumbnail in search.” reach is 暫定日本語案: wider than その, と it’s worth leading とともに because it changes ROI calculation. 暫定日本語案: Google’s own framing: “Videos can appear in several different places on Google, including the main search results page, Video mode, Google Images, and Google Discover.” その’s four distinct surfaces から one block of markup — which is なぜ I 暫定日本語案: 順位 この, とともに Recipe, as one of two genuinely high-payoff types in whole 暫定日本語案: structured-データ cluster. (It’s no coincidence two overlap: many Recipe ページ 暫定日本語案: embed cooking video via recipe’s video プロパティ, と その video is itself 暫定日本語案: VideoObject.)

暫定日本語案: vocabulary is schema.org/VideoObject, と Google’s Video guide covers three 暫定日本語案: related types on single ページ: VideoObject itself, Clip (key moments), と 暫定日本語案: BroadcastEvent ( LIVE badge). Worth knowing: there is no separate 暫定日本語案: “media-clip” doc ページ — URL あなた might guess at returns 404. Clip と segment 暫定日本語案: markup 向けに video is folded へ 同じ Video guide as VideoObject, so don’t go 暫定日本語案: hunting 向けに dedicated ページ その doesn’t exist.

暫定日本語案: 必要 — minimum 向けに any video rich result:

プロパティ何 it is
namevideo’s タイトル
thumbnailUrlURL へ representative thumbnail 画像
uploadDatedate video was 最初 published (ISO 8601)

暫定日本語案: Recommended — 追加 as many as apply; それら 作る result richer と more reliable:

プロパティなぜ it matters
contentUrlDirect URL へ media file — 役立つ Google fetch video
descriptionvideo’s 説明 (plain text)
durationISO 8601 duration (e.g. PT4M12S) — powers runtime badge
embedUrlURL へ player embed
expiresいつ video is no longer 利用可能 (omit if it doesn’t expire)
interactionStatisticView count via WatchAction interaction type
regionsAllowed / ineligibleRegionどこ video 可能性がある / 可能性がある ない be 表示

暫定日本語案: 提供 either contentUrl または embedUrl (both is better) so Google has 暫定日本語案: way へ reach actual video — thumbnail とともに no reachable video is 一般的な 暫定日本語案: 理由 result 決して 表示される. three URLs その come up here are ない 暫定日本語案: interchangeable: contentUrl is video file’s actual コンテンツ bytes (Google’s 暫定日本語案: own docs call it 大半の effective way 向けに Google へ fetch video); embedUrl 暫定日本語案: is player, ない file; と neither one is watch ページ URL — ページ 暫定日本語案: video is embedded on. 一般的な mistake is pointing contentUrl at watch 暫定日本語案: ページ instead of raw media file.

Evidence for this claim Google recommends contentUrl when available because it is the actual video bytes and most effective for fetching; embedUrl is the player URL alternative, not the watch page URL. Scope: web Confidence: high · Verified: Video structured data

Key moments: SeekToAction vs. Clip

暫定日本語案: Key moments are chapter-style deep links 下で video result その jump 暫定日本語案: viewer へ specific timestamp. There are two mechanisms, と confusing them is 暫定日本語案: single biggest ソース of implementation trouble on この type.

暫定日本語案: 1. 自動 — SeekToAction / potentialAction. あなた tell Google, via 暫定日本語案: potentialAction of type SeekToAction, URL pattern あなた player 使用 へ jump 暫定日本語案: へ timestamp ( startOffset-input placeholder). If あなた video URLs already 暫定日本語案: accept timestamp パラメーター, Google できる infer key moments itself から あなた 暫定日本語案: on-ページ chapter structure. 使用 この いつ あなた URL structure supports timestamps と 暫定日本語案: あなた’re happy letting Google pick moments.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to tie a bowline knot",
  "thumbnailUrl": "https://example.com/thumbs/bowline.jpg",
  "uploadDate": "2026-05-01T08:00:00-05:00",
  "description": "A step-by-step guide to tying a bowline.",
  "duration": "PT4M12S",
  "contentUrl": "https://example.com/video/bowline.mp4",
  "embedUrl": "https://example.com/embed/bowline",
  "potentialAction": {
    "@type": "SeekToAction",
    "target": "https://example.com/watch/bowline?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
}

暫定日本語案: 2. 手動 — Clip markup. あなた define 各 chapter explicitly as Clip. 暫定日本語案: Google’s Clip table splits この 同じ way as VideoObject itself: 必要 — 暫定日本語案: name, startOffset (in seconds), と url その deep-links へ その moment; 暫定日本語案: recommended — endOffset (in seconds), so clip has defined end as well as 暫定日本語案: start. 使用 この いつ あなた want へ supply あなた own labels と timestamps rather 暫定日本語案: than moments Google’s 自動 detection する otherwise pick.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "How to tie a bowline knot",
  "thumbnailUrl": "https://example.com/thumbs/bowline.jpg",
  "uploadDate": "2026-05-01T08:00:00-05:00",
  "hasPart": [
    {
      "@type": "Clip",
      "name": "Make the loop",
      "startOffset": 30,
      "endOffset": 75,
      "url": "https://example.com/watch/bowline?t=30"
    },
    {
      "@type": "Clip",
      "name": "Thread the tail",
      "startOffset": 75,
      "endOffset": 130,
      "url": "https://example.com/watch/bowline?t=75"
    }
  ]
}

暫定日本語案: Which へ 使用? 自動 SeekToAction is less 機能 if あなた URLs already 暫定日本語案: support timestamp パラメーター と あなた trust Google へ pick moments. 手動 Clip 暫定日本語案: is right call いつ あなた want へ name と bound 各 chapter yourself. Don’t stack 暫定日本語案: both mechanisms 向けに 同じ purpose on 同じ video — pick one. decision tree 暫定日本語案: in Resources group walks この fork.

LIVE badges とともに BroadcastEvent

暫定日本語案: 向けに livestreams, red LIVE badge is enabled by adding BroadcastEvent へ 暫定日本語案: あなた VideoObject via publication プロパティ. It is ない separate, 暫定日本語案: unrelated schema type — it’s documented on 同じ Video guide と layered onto 暫定日本語案: VideoObject あなた already have. BroadcastEvent as whole isn’t 必要 向けに plain 暫定日本語案: video rich result, ただし once あなた 追加 it 向けに LIVE badge, Google’s Clip-style table 暫定日本語案: treats isLiveBroadcast, startDate, と endDate as 必要 together:

  • 暫定日本語案: isLiveBroadcast: true
  • 暫定日本語案: startDate — いつ broadcast starts または is scheduled へ start. startDate in 暫定日本語案: future signals scheduled broadcast; in past または present, it signals 暫定日本語案: stream has actually started.
  • 暫定日本語案: endDate — いつ it ends または is expected へ end. Google is explicit その once 暫定日本語案: stream has actually finished, あなた 必要がある update endDate へ real value — 暫定日本語案: endDate in future signals scheduled end, in past または present it 暫定日本語案: signals stream has ended. If あなた don’t know end time up front, 暫定日本語案: approximate endDate is fine へ start; just 正しい it once stream actually 暫定日本語案: wraps.

暫定日本語案: Nesting startDate/endDate この way lets Google infer three lifecycle states — 暫定日本語案: scheduled, live, ended — から 同じ two fields, which is また なぜ stale 暫定日本語案: endDate (ない corrected 後に stream stops) is main way lingering LIVE 暫定日本語案: badge happens. None of この guarantees badge 表示される at any particular time; 暫定日本語案: it だけ supplies timing Google’s systems 使用 へ decide.

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Launch livestream 2026",
  "thumbnailUrl": "https://example.com/thumbs/launch.jpg",
  "uploadDate": "2026-06-30T09:00:00-05:00",
  "publication": {
    "@type": "BroadcastEvent",
    "isLiveBroadcast": true,
    "startDate": "2026-07-01T14:00:00-05:00",
    "endDate": "2026-07-01T15:30:00-05:00"
  }
}

暫定日本語案: あなた また need へ call Google’s インデックス登録 API 向けに livestream videos so LIVE 暫定日本語案: badge 表示される と disappears in timely way — badge is time-sensitive in way 暫定日本語案: normal on-demand video isn’t.

一般的な implementation mistakes

  • 暫定日本語案: Omitting uploadDate または using sloppy date format. It’s one of だけ three 暫定日本語案: 必要 fields. 使用 consistent ISO 8601 value ( full date-time とともに offset is 暫定日本語案: safest). この is single 大半の 一般的な miss on type.
  • 暫定日本語案: ** thumbnail とともに no reachable video.** 提供 contentUrl と/または embedUrl so 暫定日本語案: Google できる actually fetch video thumbnail represents.
  • 暫定日本語案: Marking up video その Google できる’t クロール または インデックス登録. Structured データ できる’t 暫定日本語案: rescue video hidden behind login, blocked in robots.txt, または loaded in way 暫定日本語案: crawler できる’t see. Markup describes video; it doesn’t 作る it accessible.
  • 暫定日本語案: Stacking both key-moment mechanisms. Pick 自動 SeekToAction または 手動 暫定日本語案: Clip 向けに given video, ない both.
  • 暫定日本語案: Forgetting へ close out livestream. 設定 endDate と update markup once 暫定日本語案: stream ends, または LIVE badge できる linger.
  • 暫定日本語案: Treating 有効 markup as guaranteed result. As とともに すべての rich-result type, 暫定日本語案: 有効 VideoObject markup だけ 作る ページ 適格 — Google’s systems still 暫定日本語案: decide whether へ 表示 it.

どこ この sits, と video SEO more broadly

暫定日本語案: VideoObject is structured-データ layer 向けに video, と it lives here alongside its 暫定日本語案: siblings — Recipe (whose ページ so 多くの場合 embed cooking video) と 記事 暫定日本語案: (どこ video is embedded inside written piece, と VideoObject describes その 暫定日本語案: embed). ただし markup is だけ one slice of getting video へ perform in 検索: 暫定日本語案: hosting, sitemaps, thumbnails, transcripts, ページ speed around player, と どのように あなた 暫定日本語案: embed all matter too. それらの broader video SEO topics sit outside この 暫定日本語案: structured-データ 記事 — この ページ is deliberately scoped へ schema itself.

暫定日本語案: 向けに どこ VideoObject fits in wider structured-データ picture, see Schema 暫定日本語案: Markup と Structured データ hubs この 記事 nests 下で.

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.