JSON-LD構造化データのContent-Type

JSON-LD(Linked Data)レスポンス用のContent-Typeヘッダーを設定します。SEOおよびAPIコンテキストでのapplication/ld+jsonの使用方法を解説します。

Best Practices

詳細な説明

JSON-LD Content-Type

JSON-LD(JSON for Linked Data)は、コンテンツがJSON-LD構造化データであることを示すためにapplication/ld+jsonメディアタイプを使用します。

ヘッダー値

Content-Type: application/ld+json; charset=utf-8

JSON-LDとは?

JSON-LDはJSONを使用してLinked Dataをエンコードする方法です。以下の用途で広く使用されています:

  • SEO構造化データ(Schema.orgマークアップ)
  • APIレスポンス(セマンティックアノテーション付き)
  • ナレッジグラフおよびLinked Open Data

SEOでの使用

Googleなどの検索エンジンはJSON-LDを使用してページコンテンツを理解します。HTMLでは<script>タグに埋め込まれます:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Content-Typeヘッダーの設定方法",
  "author": {
    "@type": "Person",
    "name": "Jane Developer"
  }
}
</script>

APIでの使用

APIエンドポイントからJSON-LDを配信する場合:

Content-Type: application/ld+json; charset=utf-8

レスポンスボディにはボキャブラリを定義する@contextが含まれます:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "DevToolbox",
  "description": "開発者ツールポータル"
}

コンテンツネゴシエーション

クライアントはJSON-LDを特定してリクエストできます:

Accept: application/ld+json

curlの例

curl -H "Accept: application/ld+json" \
  https://api.example.com/products/1

ユースケース

APIエンドポイントからJSON-LD構造化データを配信する場合、Linked Dataのコンテンツネゴシエーションを実装する場合、セマンティックWebアプリケーションを構築する場合に使用します。

試してみる — Content-Type Header Builder

フルツールを開く