一般的な Structured データ Errors (と どのように へ Fix Them)

暫定日本語訳:structured データ errors Google's Rich Results テスト と 検索 Console surface 大半の — 不足している 必要 fields, 誤った value types, コンテンツ mismatch, malformed JSON-LD, と deprecated types — と exactly どのように へ debug 各 one.

初回公開:2026年7月2日 · 最終更新:2026年8月4日 · Advanced
言語

暫定日本語訳:Structured データ errors split へ two kinds: parsing errors その break markup entirely (malformed JSON-LD — trailing commas, unescaped quotes, 不足している colon または brace) と 適格性 errors その parse fine ただし fail rich-result rule (不足している 必要 プロパティ, 誤った value type, colliding/duplicate @id, または markup describing コンテンツ ない visible on ページ). 不足している 必要 プロパティ または unparsable JSON blocks rich result outright; 不足している recommended プロパティ is だけ warning — rich result usually still 表示, less richly. コンテンツ mismatch is one error class とともに real teeth: it's policy violation その できる trigger 手動 action, ない just silent ineligibility. distinct failure mode isn't error at all — deprecated/unsupported type (FAQ, 削除 by 可能性がある 2026) is 有効 markup その just no longer earns visual. Debug とともに three 異なる ツール: Rich Results テスト (Google 適格性 + SERP preview, single URL), Schema Markup Validator (schema.org syntax/vocabulary, any type), と 検索 Console's Rich result レポート (サイト-wide, sampled, 超えて time) — pass in one answers だけ その ツール's own question. Fixing errors restores rich-result 適格性 — structured データ isn't ランキング factor, so fix wins back SERP visual, ない ランキング.

暫定日本語案: TL;DR — Structured データ errors split へ parsing errors (malformed 暫定日本語案: JSON-LD — trailing commas, unescaped quotes, 不足している colons または braces — その break 暫定日本語案: markup so badly Google できる’t determine type; これらの land 暫定日本語案: in Unparsable structured データ レポート) と 適格性 errors ( markup 暫定日本語案: parses ただし fails rich-result rule: 不足している 必要 プロパティ, 誤った value type, 暫定日本語案: または markup describing コンテンツ ない visible on ページ). Errors できる block; 暫定日本語案: warnings are non-critical — 不足している 必要 プロパティ できる kill feature 暫定日本語案: 適格性, while 不足している recommended one generally preserves 適格性 暫定日本語案: ただし 可能性がある limit 利用可能 information. コンテンツ mismatch is 暫定日本語案: one class とともに teeth — policy violation その できる trigger 手動 action, 暫定日本語案: ない silent ineligibility. separate failure mode isn’t error at all: 暫定日本語案: deprecated/unsupported type (FAQ, gone by 可能性がある 2026) is 有効 markup その 暫定日本語案: earns no visual. Debug とともに three 異なる ツール — Rich Results テスト (Google 暫定日本語案: 適格性 + preview), Schema Markup Validator (schema.org syntax, any type), と 暫定日本語案: 検索 Console’s Rich result レポート (サイト-wide, sampled). Structured データ isn’t 暫定日本語案: ランキング factor, so fix wins back SERP visual, ない ランキング. 暫定日本語案: Evidence for this claim Google structured data must follow technical, quality, relevance, and feature-specific guidelines; valid syntax alone is insufficient for eligibility. Scope: Current Google structured-data policies. Confidence: high · Verified: Google Search Central: Structured data general guidelines Evidence for this claim Google recommends Rich Results Test for supported feature validation and URL Inspection for deployed-page status; warnings may preserve eligibility while errors can block it. Scope: Current Google structured-data validation workflow. Confidence: high · Verified: Google Search Central: Generate structured data with JavaScript

Errors vs. warnings — 何 actually blocks rich result

Debug in order: make the markup readable, make the item eligible, then verify that it matches the page and policy. 出典: Google Search Central

Step one checks whether the JSON-LD parses and fixes malformed syntax first. Step two checks required rich-result fields and valid value types; errors can block eligibility while warnings usually identify recommended fields. Step three checks whether the markup matches visible content and Google policy. Passing one layer does not prove the next, and valid markup does not guarantee display.

© Patrick Stox LLC · CC BY 4.0 ·

暫定日本語案: 前に taxonomy, get この distinction straight, because 大半の guides 使用 “error” 暫定日本語案: as catch-all と it causes needless panic.

  • 暫定日本語案: error means 必要 プロパティ is 不足している または 無効, または markup is 暫定日本語案: unparsable. item できる’t be rich result until あなた fix it.
  • 暫定日本語案: warning means recommended (ない 必要) プロパティ is 不足している. rich 暫定日本語案: result できる still 表示 — just less completely.

暫定日本語案: Google’s own guidance leans toward accuracy 超えて padding: “it is more important to supply fewer but complete and accurate recommended properties rather than trying to provide every possible recommended property with less complete, badly-formed, or inaccurate data.” In other words, don’t chase すべての warning by stuffing in 暫定日本語案: half-accurate データ — その できる 作成 worse 問題 than warning it solves.

暫定日本語案: Worth knowing: even Google’s own レポート isn’t infallible here. In October 2022 暫定日本語案: 検索 Console had bug どこ some 問題 were mislabeled as errors いつ それら were 暫定日本語案: actually warnings; Google’s fix moved them “from the critical error table to the warning table,” と clarified it was “strictly a reporting issue and did not affect whether or not a rich result could be displayed” 暫定日本語案: (検索エンジン Land, Oct 2022). lesson: いつ in doubt, cross-確認 flagged 暫定日本語案: item against Rich Results テスト rather than trusting one レポート blindly.

Malformed JSON-LD — “unparsable” errors

暫定日本語案: この is 大半の fundamental error class: markup is broken badly enough その 暫定日本語案: Google できる’t even determine intended type. Google files これらの in separate 暫定日本語案: Unparsable structured データ レポート 暫定日本語案: rather than per-type レポート, because there’s no type へ attribute item へ. 暫定日本語案: Google’s own 説明: item lands here because of “serious syntax error” 暫定日本語案: と “the intended type of structured data (Job, Event, and so on) could not be determined because of the parsing error.”

暫定日本語案: usual culprits:

  • 暫定日本語案: Trailing commas. comma 後に 最後 プロパティ in object または array is 暫定日本語案: 有効 in JavaScript ただし 無効 in JSON. この is single 大半の 一般的な way 暫定日本語案: hand-written または template-concatenated JSON-LD breaks.
  • 暫定日本語案: Unescaped quotes. double quote inside string value その isn’t escaped 暫定日本語案: (\") terminates string early. Google’s documented error 向けに この is “Bad escape sequence in string.” 商品 names, review text, と 説明 とともに 暫定日本語案: inch marks または quoted phrases are classic offenders.
  • 暫定日本語案: 不足している colons または braces. Google documents これらの verbatim as “Parsing error: Missing ’:’”“Parsing error: Missing ’,’ or ’}’” — usually 暫定日本語案: copy-paste または string-concatenation accident.
  • 暫定日本語案: 誤った value type inside otherwise-有効 JSON. Google’s “Incorrect value type” — e.g., numeric field wrapped in quotes いつ number was expected. (この 暫定日本語案: shades へ 適格性 errors below; いつ it’s bad enough へ break parsing, 暫定日本語案: it lands here.)

どのように へ debug: strip へ empty object, rebuild piece by piece

暫定日本語案: Google’s own debugging tip 向けに unparsable markup is refreshingly low-tech: 暫定日本語案: “If you are having problems finding the error, try starting from an empty object, then add back content from your broken code piece by piece.” 暫定日本語案: Paste stripped-down object へ Rich Results テスト, confirm it parses, then 暫定日本語案: 追加 プロパティ back until it breaks — 最後 thing あなた 追加 is あなた culprit.

暫定日本語案: One caution straight から Google: fixing parsing error “might trigger additional warnings or errors that were hidden because the item could not be parsed at all.” 暫定日本語案: One fix できる unmask next layer, so re-テスト 後に すべての change.

不足している 必要 fields と 誤った value types

暫定日本語案: Once JSON parses, next error class is について contents: is すべての 暫定日本語案: 必要 プロパティ present, と is すべての value right type?

暫定日本語案: すべての Google-supported type has 必要 プロパティ (leave one out と あなた lose 暫定日本語案: 適格性 — その’s error) と recommended ones (leave one out と あなた get 暫定日本語案: warning, ただし rich result できる still 表示). 検索 Console’s guidance is へ open 暫定日本語案: レポート, “click an issue to see affected pages,” と 使用 “Why items are invalid” table へ prioritize — errors 最初, then warnings.

Type mismatches — string どこ number, URL, または date is expected

暫定日本語案: classic 適格性 bug: value is there, ただし it’s 誤った type. 暫定日本語案: 価格 field containing date. rating 提供 as "five stars" instead of 暫定日本語案: number. URL field containing plain text. Google flags この as 暫定日本語案: 無効/unexpected value type.

暫定日本語案: Bing is worth note here because, per its own structured データ 役立つ 暫定日本語案: ドキュメント, 暫定日本語案: it behaves differently: rather than erroring loudly, Bing’s crawlers are 暫定日本語案: documented へ ignore annotation whose value type is 誤った ( 価格 field 暫定日本語案: holding date, Event とともに no date, Person とともに no name) rather than 暫定日本語案: surface red error. So don’t assume “no Bing error” means “correct” — Bing’s 暫定日本語案: public ドキュメント is thinner と less granular than Google’s (it doesn’t 暫定日本語案: publish per-type 必要-vs-recommended breakdown または レポート as detailed as 暫定日本語案: Rich result レポート), と its tolerance 向けに mismatched types is silent-drop, 暫定日本語案: ない loud-fail. Lean on Google’s Rich Results テスト 向けに detailed error 暫定日本語案: taxonomy.

Duplicate @id values と entity confusion

暫定日本語案: subtler one その CMS plugins cause constantly: reusing 同じ @id 向けに two 暫定日本語案: 異なる entities, または letting plugin emit fresh, colliding @id on すべての 暫定日本語案: ページ instead of stable one. この is ない parsing failure — JSON itself 暫定日本語案: is well-formed, so it doesn’t land in Unparsable structured データ レポート. 暫定日本語案: @id is どのように JSON-LD nodes reference 各 other inside @graph, so collision 暫定日本語案: is entity-identity 問題: it creates ambiguity について which node reference 暫定日本語案: actually points へ. この gets worse on サイト どこ multiple ソース ( theme 暫定日本語案: schema plugin) both auto-generate Organization, WebSite, と WebPage 暫定日本語案: nodes.

暫定日本語案: fix is stable, unique @id per real-world entity — URL-fragment 暫定日本語案: identifier like https://example.com/#organization, reused consistently 全体で 暫定日本語案: サイト, ない regenerated per ページ. この is mirror 画像 of 暫定日本語案: canonicalization 暫定日本語案: 問題, どこ one stable identifier per real thing is likewise whole game.

Nested-プロパティ errors ( 不足している name inside author)

暫定日本語案: Some 必要 プロパティ live inside other objects — author.name, 暫定日本語案: aggregateRating.ratingValue. 不足している one 使用 へ produce vague error like 暫定日本語案: Missing field "name" その できる point anywhere on ページ. In 暫定日本語案: March 2022 暫定日本語案: Google 追加 nested context so 同じ error 現在 reads 不足している field "name" (in 暫定日本語案: "author") — small change その 作る これらの far easier へ locate. (Anyone とともに 暫定日本語案: open “validate fix” リクエスト at time had へ re-trigger it, since 古い 問題 暫定日本語案: IDs were retired.) If あなた see nested-プロパティ error, read parenthetical — it 暫定日本語案: tells あなた exactly which object is short field.

コンテンツ mismatch — policy-violation error class

暫定日本語案: この is one error class その deserves its own section, because consequence 暫定日本語案: is categorically worse than “no rich result.” Everything above is technical 暫定日本語案: 問題. コンテンツ mismatch is policy 問題.

暫定日本語案: Google’s General Structured データ Guidelines 暫定日本語案: are explicit on two points:

  • 暫定日本語案: “Don’t mark up content that is not visible to readers of the page.”
  • 暫定日本語案: “Your structured data must be a true representation of the page content.”

暫定日本語案: Marking up 4,8-star rating その 表示される nowhere on ページ, describing コンテンツ 暫定日本語案: その’s hidden または served だけ へ crawlers, または labeling something as one thing いつ 暫定日本語案: it’s really another — Google’s own 例 含む sports live-streaming サイト 暫定日本語案: labeling broadcasts as ローカル イベント, と woodworking サイト labeling instructions as 暫定日本語案: recipes — all violate この.

Consequences: 手動 actions vs. silent ineligibility

暫定日本語案: technical error costs あなた rich result silently. コンテンツ-mismatch policy 暫定日本語案: violation できる cost あなた more: “If your page contains a structured data issue, it can result in a manual action. A structured data manual action means that a page loses eligibility for appearance as a rich result; it doesn’t affect how the page ranks in Google web search.” 手動 actions 表示 up in 手動 Actions レポート in 暫定日本語案: 検索 Console — place あなた 決して want へ see structured-データ entry.

暫定日本語案: 一般的な quieter version of この: templated, non-unique schema. John Mueller’s 暫定日本語案: long-standing guidance is その “the structured data on a website, or on a page, should be specific to that particular page” 暫定日本語案: (via 検索エンジン Journal). サイト-wide Organization block copy-pasted とともに 暫定日本語案: 同じ review count onto すべての ページ reads as representation 問題, ない just 暫定日本語案: sloppy one.

暫定日本語案: なぜ validation isn’t enough. この is answer へ “my markup validates clean — why no rich result?” Validators 確認 syntax と Google’s technical 適格性 暫定日本語案: rules. それら do ない 確認 Google’s コンテンツ-quality と spam-policy layer. 暫定日本語案: syntactically perfect, policy-violating implementation できる still be denied rich 暫定日本語案: result または hit とともに 手動 action. Passing Rich Results テスト is necessary ただし 暫定日本語案: ない sufficient.

Using deprecated または unsupported type

暫定日本語案: Here’s failure mode その isn’t technically “error” at all — と it trips 人々 暫定日本語案: up because nothing turns red. あなた markup is perfectly 有効, it parses, it passes 暫定日本語案: schema.org validator, と yet no rich result する ever 表示, because Google 暫定日本語案: turned feature off.

ケース study: FAQ rich results (deprecated 2026)

暫定日本語案: timely 例. Google 追加 deprecation notice へ FAQ rich result 暫定日本語案: ドキュメント, stating feature “will no longer appear in Google Search starting May 7, 2026,” then in mid-2026 削除 FAQ ドキュメント, Rich Results テスト 暫定日本語案: support, と 検索 Console レポート 暫定日本語案: because “the FAQ rich result feature is no longer shown in Google Search results.”

暫定日本語案: nuance その matters: FAQPage is still 有効 schema.org type, と Google 暫定日本語案: still parses it. type isn’t “wrong.” It simply no longer earns visual 暫定日本語案: treatment. So 正しい reaction へ “is my FAQ schema now an error?” is no — 暫定日本語案: leaving markup in place doesn’t hurt anything; it just no longer buys あなた SERP 暫定日本語案: enhancement. Don’t panic-strip 有効 markup because visual went away.

Other retired types

暫定日本語案: FAQ isn’t alone. Google has repeatedly retired rich-result types いつ analysis 暫定日本語案: showed それら weren’t widely 使用 または didn’t 追加 ユーザー value: HowTo rich results 暫定日本語案: were 削除 から desktop back in 2023; June 2025 batch retired seven more niche 暫定日本語案: types (including Claim Review, Estimated Salary, Learning Video, Special 暫定日本語案: Announcement, と Vehicle Listing); と Practice 問題 structured データ was 暫定日本語案: deprecated starting January 2026. In 各 ケース schema.org type usually remains 暫定日本語案: 有効 — it just stops rendering.

どのように へ tell if type is still “live”

暫定日本語案: 確認 Google’s 検索 Gallery 暫定日本語案: — canonical list of types その currently earn rich results. If type isn’t in 暫定日本語案: gallery, 有効 markup 向けに it won’t produce visual, no matter どのように clean it is. 暫定日本語案: Re-確認 gallery periodically; Google revises it 多くの場合.

どのように へ actually debug — three 異なる ツール

暫定日本語案: single 大半の 一般的な meta-mistake is conflating ツール. There are three, と 暫定日本語案: それら answer 異なる questions.

Rich Results テスト — Google 適格性 + SERP preview

暫定日本語案: Rich Results テスト takes single 暫定日本語案: URL または code snippet と checks subset of markup Google 使用 向けに rich 暫定日本語案: results, then previews どのように result might 表示される. Google frames it as “an easy and useful tool for validating your structured data, and in some cases, previewing a feature in Google Search.” 使用 it during development と へ spot-確認 fix. It 暫定日本語案: does ない validate schema types Google doesn’t 使用 向けに rich results.

Schema Markup Validator — schema.org syntax, any type

暫定日本語案: Schema Markup Validator is run by schema.org, 暫定日本語案: ない Google. It checks general syntax と vocabulary compliance 向けに any 暫定日本語案: schema.org type — including ones Google doesn’t turn へ rich results (e.g., 暫定日本語案: Action schema). Passing it means あなた markup is well-formed schema.org; it does 暫定日本語案: ない mean あなた’re 適格 向けに Google rich result. この is ツール 向けに 暫定日本語案: “is my JSON-LD structurally correct?” independent of any 検索エンジン.

暫定日本語案: ** two-ツール trap:** これらの are genuinely 異なる ツール, と passing one does ない 暫定日本語案: mean passing other. split has confusing history — Google tried へ fully 暫定日本語案: deprecate its 古い “Structured Data Testing Tool” in July 2020, reversed course 後に 暫定日本語案: backlash その December, then refocused it へ 現在’s schema.org-run validator by 暫定日本語案: mid-2021. Plenty of 古い blog posts still point 人々 at dead ツール name. 向けに 暫定日本語案: 2026: Rich Results テスト 向けに Google 適格性, Schema Markup Validator 向けに 暫定日本語案: schema.org syntax.

検索 Console’s Rich result レポート — サイト-wide, sampled, 超えて time

暫定日本語案: Rich result レポート 暫定日本語案: ( older nav と lot of practitioners still call この “Enhancements” 暫定日本語案: レポート) is だけ one その’s ongoing と サイト-wide rather than single-URL 暫定日本語案: spot 確認. Google: “a valid item is an item that doesn’t have any critical issues and can appear on Google as a rich result. An invalid item has at least one critical issue preventing it from appearing as a rich result.” Two limitations へ 保つ in 暫定日本語案: mind: per-type レポート だけ 表示される once Google finds 有効 markup of その type, と 暫定日本語案: “the reports aren’t a comprehensive list of all detected items. They show a sample of detected items to help assess the quality of your structured data.” It’s 暫定日本語案: 監視 surface, ない exhaustive audit.

暫定日本語案: ** pass answers だけ その ツール’s own layer.** Rich Results テスト, Schema Markup 暫定日本語案: Validator, と Rich result レポート 各 確認 異なる question, so clean 暫定日本語案: result in one tells あなた nothing について other two — pass in Schema Markup 暫定日本語案: Validator doesn’t mean Google’s Rich Results テスト する pass, と neither proves 暫定日本語案: 何 Rich result レポート する 表示 once Google actually crawls deployed 暫定日本語案: ページ.

Validating fix (と なぜ it takes while)

暫定日本語案: Once あなた’ve fixed 問題, Google’s documented workflow 暫定日本語案: is: fix on-サイト, confirm ページ is crawlable (ない blocked by robots.txt または 暫定日本語案: noindex), spot-確認 とともに URL Inspection, then “click Validate fix on the issue’s details page to start Google’s validation process.” 設定 expectations on timing — 暫定日本語案: Google says validation “can take two weeks or more, depending on crawl frequency.” 暫定日本語案: It’s ない instant; Google has へ re-クロール affected ページ.

one framing その 保持 あなた sane

暫定日本語案: Fixing structured データ errors is について rich-result 適格性, ない rankings. 暫定日本語案: As John Mueller put it (reported by 検索エンジン Roundtable, 暫定日本語案: April 2025), “structured data won’t make your site rank better” — it’s 向けに 暫定日本語案: displaying 検索 features in Google’s gallery. So payoff of clean fix is 暫定日本語案: SERP visual (stars, breadcrumbs, 価格) と クリック-通じて it できる earn — 決して 暫定日本語案: ランキング bump. 保つ その straight と あなた’ll prioritize right errors: ones 暫定日本語案: blocking visual あなた actually want, ない すべての warning in レポート.

どこ この sits

暫定日本語案: この is deep-dive sibling 下で 暫定日本語案: Structured データ 向けに SEO hub — 同じ 暫定日本語案: sub-cluster as schema-markup, JSON-LD, と rich-results deep dives. 暫定日本語案: error taxonomy here is troubleshooting counterpart へ それらの: それら cover 何 へ 暫定日本語案: 構築, この covers 何 breaks と どのように へ see it. 向けに broader picture of on-ページ 暫定日本語案: signals it lives alongside — meta tags, header tags, 画像 SEO — see 暫定日本語案: on-ページ SEO cluster.

Add an expert note

Pin an expert quote

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