書籍

書籍の各アクションを利用すると、Google 検索から書籍や著者を見つけて検索結果から簡単に書籍を購入できます。電子書籍のプロバイダは、以下の構造化データスキーマを使用して Google にデータを提供できます。

検索結果に表示された書籍アクション

検索クエリが書籍名(「ライ麦畑でつかまえて」など)や「J.D. サリンジャーの本」のような場合、そのユーザーは書籍を見つけようとしていると考えられます。そうした検索クエリに対しては、書籍のナレッジグラフ カードが表示される場合があります。詳しくは、ナレッジグラフのデータの管理方法をご覧ください。カードに組み込まれている読むアクションを実行すると、書籍の購入オプションが表示されます。ユーザーは、表示されるリンクを介して読むアクションを実行することで、ナレッジグラフ カードからサイトやアプリ上の書籍のページに直接移動できます。

<html>
  <head>
    <title>The Catcher in the Rye</title>
    <script type="application/ld+json">
    {
      "@context":"https://schema.org",
      "@type":"Book",
      "name" : "The Catcher in the Rye",
      "author": {
        "@type":"Person",
        "name":"J.D. Salinger"
      },
      "url" : "http://www.barnesandnoble.com/store/info/offer/JDSalinger",
      "workExample" : [{
        "@type": "Book",
        "isbn": "031676948",
        "bookEdition": "2nd Edition",
        "bookFormat": "https://schema.org/Hardcover",
        "potentialAction":{
        "@type":"ReadAction",
        "target":
          {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.barnesandnoble.com/store/info/offer/0316769487?purchase=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "Price":6.99,
            "priceCurrency":"USD",
            "eligibleRegion" : {
              "@type":"Country",
              "name":"US"
            },
            "availability": "https://schema.org/InStock"
          }
        }
      },{
        "@type": "Book",
        "isbn": "031676947",
        "bookEdition": "1st Edition",
        "bookFormat": "https://schema.org/EBook",
        "potentialAction":{
        "@type":"ReadAction",
        "target":
          {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.barnesandnoble.com/store/info/offer/031676947?purchase=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "Price":1.99,
            "priceCurrency":"USD",
            "eligibleRegion" : {
              "@type":"Country",
              "name":"UK"
            },
            "availability": "https://schema.org/InStock"
          }
        }
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

ガイドライン

構造化データに関する一般ガイドラインに加えて、書籍や読むアクションに固有の以下のガイドラインに準拠する必要があります。

  • 同じコンテンツの重複するページがある場合は、リンクに書籍名とその他の書籍情報を含む正規 URL を指定する必要があります。
  • ユーザーが読むアクションのリンクをクリックしたら、書籍を直接購入できるページに移動する必要があります。
  • 読むアクションのリンクは、ユーザーがコンテンツを購入できるページを指している必要があります。コンテンツを購入したり、詳細情報を表示したりするのにさらにクリックする必要があるページ(検索結果ページや商品の概要ページなど)を指していてはなりません。

構造化データタイプの定義

コンテンツがリッチリザルトとして表示されるようにするには、必須プロパティを含める必要があります。また、推奨プロパティを使用することでコンテンツに関する詳細情報を追加でき、ユーザー エクスペリエンスの向上につながります。

Book

Book の定義の全文は schema.org/Book で確認できます。実行する必要があるのは、下記のプロパティを定義することだけです。サイト内のすべての書籍について、以下の必須プロパティを定義する必要があります。

必須プロパティ

author

Person

書籍の著者。リストする著者に対して、それぞれ個別の Person エンティティを指定する必要があります。詳しくは、Person をご覧ください。

name

Text

書籍のタイトル。複数の版を提供する場合は、書籍の版のタイトルを使用します。

url

URL

書籍に関するサイト上のページの URL。このページには、購入可能なすべての版を記載できます。

workExample

Book

書籍の版。詳しくは、workExample のサブプロパティをご覧ください。

推奨プロパティ

@id

URL

作品のグローバルに一意の ID(URL 形式)。ID は、時間が経過しても変化しないものにする必要があります。URL は不透明型の文字列として扱われるため、実際のウェブページに解決される必要はありません。

sameAs

URL

書籍の ID を明確にする参照ページ(書籍の Wikipedia ページ、Freebase ページ、公式ウェブサイトの URL など)。

Country

この Offer のサブセットでは、Offer が有効な国を 2 文字の国コードで定義します。

必須プロパティ

name

Text

国の名前(ISO 3166 alpha-2 に準拠)。

EntryPoint

EntryPoint は、書籍へのディープリンクを提供するためのメカニズムとして機能します。ディープリンクは、サービスを提供するプラットフォームの種類によって指定できます。

必須プロパティ

actionPlatform

Text

リンクが動作するプラットフォーム。次のうち 1 つ以上を指定します。

  • http://schema.org/DesktopWebPlatform: パソコンのウェブブラウザで動作します。
  • http://schema.org/MobileWebPlatform: モバイルのウェブブラウザで動作します。
  • http://schema.org/AndroidPlatform: Android デバイスで動作します。
  • http://schema.org/IOSPlatform:iOS デバイスで動作します。

カスタムの Android スキームを含むディープリンクの場合は、このプロパティを省略できます。

urlTemplate

URL

コンテンツへのリンク。

Offer

Offer では、購入の際の利用規約を定義します。

必須プロパティ

price

Number

商品の価格。通貨は priceCurrency プロパティで指定します。

priceCurrency

Text

通貨(3 文字の ISO 4217 形式)。

推奨プロパティ
@id URL

グローバルに一意な販売情報の ID。

availability

ItemAvailability

商品アイテムの在庫状況(InStock、OutOfStock、PreOrder など)。

eligibleRegion

Country

販売情報が有効な国。

ineligibleRegion

Country

販売情報が有効でない国(ある国が対象の地域と対象外の地域の両方に表示される場合、対象の地域が無効になることがあります)。

Person

Google では著者に Person 型を使用しています。

必須プロパティ

name

Text

個人の名前。

推奨プロパティ

sameAs

URL

商品アイテムの ID を明確にする参照ページ(商品アイテムの Wikipedia ページ、Freebase ページ、公式ウェブサイトの URL など)。

ReadAction

ReadAction プロパティでは、コンテンツのプラットフォームと、アクション(読書を開始する前のコンテンツの購入など)を実行可能な状態を決定します。

必須プロパティ

expectsAcceptanceOf

Offer

アクションの状態のコンテナ。

target

EntryPoint

アクション ターゲットのコンテナ。

workExample

作品の特定の版、または作品の巻。

必須プロパティ

bookFormat

BookFormatType

書籍の形式(次のうち 1 つ以上の値を使用)。

  • EBook
  • Hardcover
  • Paperback
  • AudioBook

isbn

Text

大冊の ISBN。ISBN には 10 桁と 13 桁のいずれかを使用できますが、可能な場合は 13 桁を使用することをおすすめします。版の ISBN が記載されていない場合(Kindle 版など)は、書籍版の ISBN を使用します。

potentialAction

ReadAction

書籍を読むアクション。

推奨プロパティ

@id

URL

巻のグローバルに一意の ID(URL 形式)。ID は、時間が経過しても変化しないものにする必要があります。また、書籍の ID とは異なる ID を指定する必要があります。URL は不透明型の文字列として扱われるため、リンクとして機能する必要はありません。

author

Person

大冊の著者。このプロパティは、大冊の著者が関連書籍とは異なる場合にのみ使用します。各著者に対して Person エンティティを 1 つ指定します。

bookEdition

Text

書籍の版。

datePublished

Date

大冊の最初の出版日。

name

Text

大冊のタイトル。このプロパティは、大冊のタイトルが書籍とは異なる場合にのみ使用します。

sameAs

URL

商品アイテムの ID を明確にする参照ページ(商品アイテムの Wikipedia ページ、Freebase ページ、公式ウェブサイトの URL など)。

url

URL

版に固有の URL(存在する場合)。

トラブルシューティング

構造化データを実装する際に問題が発生した場合は、以下のリソースを確認してください。