一般的な 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年9月3日 · 上級者向け

暫定日本語訳: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, ない ランキング. 暫定日本語案: この主張の根拠 Google structured data must follow technical, quality, relevance, and feature-specific guidelines; valid syntax alone is insufficient for eligibility. 対象範囲: Current Google structured-data policies. 信頼度: 高 · 検証日: Google Search Central: Structured data general guidelines この主張の根拠 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. 対象範囲: Current Google structured-data validation workflow. 信頼度: 高 · 検証日: Google Search Central: Generate structured data with JavaScript

Errors vs. warnings — 何 actually blocks rich result

順番にデバッグします。まずマークアップを読み取れる状態にし、次に項目を表示対象にしてから、ページ内容とポリシーに一致するか確認します。 出典: Google Search Central

ステップ1ではJSON-LDを解析できるか確認し、不正な構文を最初に修正します。ステップ2ではリッチリザルトの必須フィールドと有効な値の型を確認します。エラーは表示資格を妨げる可能性があり、警告は通常、推奨フィールドを示します。ステップ3ではマークアップが表示コンテンツとGoogleのポリシーに一致するか確認します。1つの段階を通過しても次の段階の通過は証明されず、有効なマークアップでも表示は保証されません。

© 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の構文(全タイプ)

暫定日本語案: 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.

専門家メモを追加

専門家の引用を固定

新しい人物ですか?まず、 /admin/experts/ → 専門家の引用を固定 から未登録プロフィールを作成してください。