Play ゲームのアクション

概要

このドキュメントでは、ビデオゲーム向けの Google Play ゲーム アクションについて説明し、スキーマ要件を一覧表示し、この機能でリリースするためのオンボーディング プロセスについて詳しく説明します。

Play ゲーム アクションの概要

Google Play Games アクションのモバイル版
モバイル デバイスでの Play ゲーム アクションの画像
パソコン版の Play Game Actions
パソコンでの Play Games の操作の画像

ビデオゲームのゲームアクションを使用すると、パソコンやモバイルの検索結果ページ(SRP)から直接ゲームをプレイできます。ユーザーが、1 つ以上の Play ゲーム アクションが関連付けられているゲームを検索すると、整理された検索結果ページ(OSRP)の [概要] タブまたはナレッジパネルに Play ゲーム アクションが表示されます。これは、無料、サブスクリプション、アラカルト購入で利用でき、デスクトップまたはモバイルのクラウドからストリーミングできる、またはデスクトップまたはコンソールのローカル クライアント アプリからダウンロードできるゲームのデモ版またはフルバージョンで機能します。

Play ゲーム アクションは、ゲーム カタログの詳細を含むフィードを使用します。フィードは、エンティティのコレクションを含む JSON オブジェクトです。エンティティは、カタログ内のゲームと、ゲーム(デモ版、インスタント トライアル版、フルバージョン)をストリーミングするための関連ディープリンクを表す schema.org オブジェクトです。

Google がフィードを取得できるように、フィードをファイルに保存し、Google がアクセスできる場所にファイルをホストする必要があります。コンテンツを常に最新の状態にしておくため、Google はホストからフィード ファイルを定期的に取得します。

以降のセクションでは、これらの各要件について詳しく説明します。

始める

前のセクションで説明したように、プロバイダの責任には次のものがあります。

  • フィードの作成に必要な情報、その情報源と可用性、フィードに情報が取り込まれる仕組みを理解します。
  • カタログ内の各ゲーム エンティティの必要な詳細情報を含むフィードを作成します。
  • フィードをサーバーまたはクラウド ストレージ サービスでホストし、Google が定期的にフィードを取得できるようにします。
  • Google から指摘された問題に対応し、修正します。品質に関連する問題や、JSON ファイル自体の構造に関連する問題が考えられます。
  • カタログが変化するたびにフィードを最新の状態に維持します。
  • リリース後もフィードの品質が維持されるようにします。

これらを詳しく見ていきましょう。

始める前に

フィードの作成を開始する前に、Google Play ゲーム アクションのメタデータの要件を理解し、必要な情報をすべて 1 か所にまとめておくことをおすすめします。フィードの作成を開始する前に、次のことを行うことをおすすめします。

  • VideoGame エンティティのメタデータ要件を確認します。
  • メタデータを収集します。
    • 必須プロパティと強く推奨されるプロパティをよくご確認ください。Google ではこれらのプロパティを使用して、フィードのコンテンツを Google のデータベース内のコンテンツと一致させます。コンテンツに使用するメタデータの量が多いほど、Google がより適切にコンテンツを一致させられるようになります。

このドキュメントでの Works と Editions の使用について

  • 作品: 抽象的な概念としてのビデオゲーム。具体的には、タイトル、デベロッパー、ゲームの説明、パブリッシャーなどの作品に帰属するメタデータを指します。
  • エディション: ビデオゲームの具体的なバージョン。具体的には、出版年、プラットフォーム名、ディープリンクなどの刊行物に帰属するメタデータを指します。

たとえば、「シャドー オブ ザ トゥームレイダー」は作品ですが、出版された各種のバージョンはエディションです。この場合、作品としての「シャドー オブ ザ トゥームレイダー」には、Stadia 版、PlayStation 版、Stadia の早期アクセス版などのエディションがあります。

この区別は、フィード内ではすぐに見分けられない場合があるため、特に重要です。VideoGame エンティティは 2 つあります。

  • VideoGame(Work)は「最上位レベル」の VideoGame エンティティです。
    • exampleOfWork は VideoGame(Work)のプロパティであり、VideoGame(Edition)のインスタンスを 1 つ以上指定します。
    • VideoGame(ワーク)ごとに少なくとも 1 つの exampleOfWork VideoGame(エディション)が必要です。
  • VideoGame(Edition)は「下位レベル」の VideoGame エンティティです。

1 つの作品に複数のエディションが存在する場合があることを覚えておくと便利です。エディションはできる限りグループ化することをおすすめします。そうすれば、Google のシステムがゲームに関するすべての関連情報を利用し、それを検索結果に表示できます。

2 つの重要なプロパティとその要件を理解します。次のステップであるフィードの作成に進む前に、これらの設定を正しく行うことが重要です。

正規 URL(url)

正規 URL(url)は、Google がカタログ内のコンテンツを Google のデータベース内のコンテンツと正確に一致させるのに役立ちます。

「正規 URL とは、サイトにある一連の重複したページの中で、Google が最も代表的と考えるページの URL です。たとえば、同じページに複数の URL がある場合(例: example.com?dress=1234 と example.com/dresses/1234)、Google はそのうちの 1 つを正規 URL として選択します。」(出典: 重複した URL を統合する)

正規 URL の要件は次のとおりです。

  • url はグローバルに一意である必要があります。
  • url には Google がクロールすることが可能な機能する正規 URL を含める必要があります。

識別子(@id)

ID(@id)は次の要件を満たす必要があります。

  • カタログ全体でグローバルに一意:
    • たとえば、2 つの異なるゲームに同じ @id を使用しないでください。
  • 静的:
    • @id は後で変更できません。
  • Unified Resource Identifier(URI)の形式:
    • コンテンツのローカル識別子(ID)が URI 形式でない場合は、ID の先頭にドメインを追加してこの要件を満たします。たとえば、コンテンツの ID が 1234abc でドメインが https://example.com の場合、@id は https://example.com/1234abc となります。
    • @id が有効な URL である必要はなく、単に URI 形式にする必要があります。
    • @id(たとえば https://example.com)で使用するドメインは、自分の組織が所有するドメインでなければなりません。

エンティティの url は識別子としてのすべての要件(グローバルに一意、静的、URI 形式)を満たしているため、エンティティの url を @id として使用することをおすすめします。

ディープリンクの要件を理解して特定する

ユーザーがコンテンツの Play ゲーム アクションを開始すると、コンテンツのディープリンクに基づいてアプリまたはプラットフォームのコンテンツに直接誘導されます。次の点にご注意ください。

  • ディープリンクは、指定されたすべてのプラットフォームで対象のコンテンツを開く必要があります。プラットフォームごとに異なるディープリンクを設定できます。たとえば、パソコンのウェブで機能するディープリンクとモバイルのウェブで機能するディープリンクは異なる場合があります。ゲームごとに、そのディープリンクがプラットフォームによって異なるかどうかを確認します。
  • ディープリンクには、パラメータ(&)またはアンカータグ(#)を含めることができます。
  • Google の複数のプラットフォーム(検索、アシスタント、Android TV)でコンテンツを確実に利用できるようにするには、ディープリンクが必要です。

エンティティの url は識別子としてのすべての要件(グローバルに一意、静的、URI 形式)を満たしているため、エンティティの url を @id として使用することをおすすめします。

プラットフォーム 説明
http://schema.org/DesktopWebPlatform デスクトップ ウェブブラウザの検索プラットフォーム。
http://schema.org/MobileWebPlatform モバイル ウェブブラウザの検索プラットフォーム。
http://schema.org/AndroidPlatform Android アプリの検索プラットフォーム。
http://schema.org/AndroidTVPlatform Android TV アプリの Android TV プラットフォーム。
http://schema.org/IOSPlatform iOS アプリの検索プラットフォーム。

カタログ内のゲームのアクセス要件を特定します。次の質問に答え、フィードのメタデータで回答を特定する方法があることを確認します。

  • ユーザーがコンテンツにアクセスするには、アプリやプラットフォームにログインする必要があるか。
  • 有料会員登録は必要か。
  • ゲームをプレイするために購入が必要ですか?
  • アクセス要件は時間とともに変化するか。
  • アクセス要件はデバイスの地域によって異なるか。

ユーザーが購入できる定期購入パッケージを複数提供している場合は、commonTier と、それが Google との統合にどのように適用されるかを理解してください。

ペイウォールの種類

現在、Play Game Actions でサポートされているペイウォール タイプは次のとおりです。

カテゴリの値 ペイウォールの種類
nologinrequired 購入やログインは必要ありません。
free ユーザーはログインする必要がありますが、有料会員登録は不要です。
subscription お客様は有効な定期購入を利用している必要があります。アクセスはサブスクリプション ティアとは無関係です。
subscription お客様は有効な定期購入を利用している必要があります。アクセスはサブスクリプション ティアとは無関係です。
purchase コンテンツは購入後、無期限に利用できます。
rental コンテンツは購入後、一定期間利用できます。

これらのカテゴリ値は、後でフィードを作成するときに使用されます。また、上記の表の rental カテゴリは現時点では完全に省略可能ですが、今後のプロダクトの機能強化でサポートされる可能性があります。現在、フィードの商品で活用されるカテゴリ値は free、nologinrequired、subscription、purchase のみです。

最後に、サンプル フィードを簡単に確認して、最終的にどのような結果を得たいのかを把握します。

上記を理解し、回答(これらの質問に対する)を表すメタデータがフィード作成段階に進むのに十分であることを確認します。

フィードを作成する

Play ゲーム アクション フィードは、カタログ内のビデオゲームを表すエンティティのコレクションを含む JSON オブジェクトです。Google で定期的に取得するには、フィードを 1 つまたは複数のファイルとして提供し、それをサーバーまたはクラウド ストレージ サービス上でホストする必要があります。

フィード ファイルのサイズ、量、形式の要件を守る

次の要件を遵守する必要があります。

  • すべてのフィード ファイルのファイル拡張子は .json でなければなりません。
  • ファイル名にスペースが含まれていないことを確認します。
  • フィード ファイルは暗号化しません。
  • フィード ファイルを UTF-8 でエンコードします(ファイル エディタの設定を確認してください)。 エンコード画像
  • フィード ファイルが(未圧縮で)1 GB より大きい場合は、ファイルを複数のファイルに分割します。
    • ファイルサイズが 1 GB 未満である限り、1 つのファイルに含めることができるエンティティの数や、フィードの送信の一部として Google に送信するファイルの数に制限はありません。
  • JSON 仕様に従って、ファイルが BOM なしでエンコードされていることを確認します。Linux OS でこれを検証するには、hexdump file.json | head -n 1 がアドレス 0x00 の BBEF で始まってはなりません。

フィード コンテンツの要件に従う

次のコンテンツ要件を遵守する必要があります。

  • フィードに最新でないエンティティを含めてはなりません。最新ではないエンティティとは、ディープリンクの availabilityEnds が過去の日付に設定されているエンティティ、またはサイトで参照できなくなったエンティティです。
  • フィード内のすべてのディープリンク(urlTemplate など)とすべての URL(url など)は本番環境の URL でなければなりません。QA 環境、開発環境、またはその他の本番以外の環境の URL は使用しないでください。
  • 前のセクションで説明したように、すべての URL(url など)は正規 URL でなければなりません。
  • フィード内の各エンティティでは、次のプロパティを指定する必要があります。
    • 一意の ID: @id
    • 一意の URL: url
    • 一意のディープリンク: urlTemplate

フィードを作成する際は、次の点に注意してください。

  • フィードの構造を詳しく理解します。
  • サンプル フィードから始めます。
    • カタログから最大 5 つの代表的なエンティティを選択します。構造が適度に複雑で、カタログ内のエンティティとして一般的なエンティティを選択し、そのエンティティのフィードを作成します。
  • 割り当てられた Google 担当者に送信して、迅速な検証を依頼します。
  • サンプル フィードのすべてのエラーを解決したら、カタログ内のすべてのエンティティを含むようにフィードを拡張します。
    • フィードにカタログ内のすべてのエンティティが含まれていることを確認するには、フィード内のエンティティ数とカタログ内のアイテム数を比較します。

フィードをホストする

フィード ファイルの準備ができたら、それを安全な場所でホストします。そうすれば、Google は、定期的にフィードを取得して、コンテンツが最新のものであることを確認します。次のホスティング方法がサポートされています。

ホスティング方法 認証サポート
Google Cloud Storage 088794101-100000002-account@partnercontent.gserviceaccount.com にストレージ オブジェクト閲覧者の権限を付与する
HTTPS ユーザー名 + パスワードまたは HTTP クライアント証明書を共有する必要があります。
SFTP パスワード、キー + フレーズ、またはその両方を共有する必要があります。
AWS S3 AWS S3 バケットのキー ID とアクセスキーを共有する必要があります。

フィード ファイルをホストシステムにアップロードしたら、Play ゲーム アクション チームに連絡してフィード ファイルの確認を依頼します。

審査を受けるためにフィードを送信する

フィード ファイルをホストしたら、割り当てられた Play ゲーム アクションの担当者に連絡して、フィードの審査プロセスを開始します。この連絡で、以下の情報を必ず共有してください。

  • 概要/説明: サンプル フィードと本番環境の完全なフィードのどちらを共有するかをお知らせください。サンプル フィードを共有する場合は、可能な限り、本番環境フィードの ETA をお知らせください。
  • ホストの場所: フィード ファイルの URL。
  • ホスト認証: 必要に応じて、Google がホストからフィード ファイルを取得できるように、認証資格情報を提供します。詳しくは、フィードをホストするをご覧ください。
  • テスト アカウント: Play ゲーム アクション チームがアプリまたはプラットフォーム上のディープリンクにアクセスしてテストを実施するための、テスト用アカウント。複数のプラットフォーム上にエンティティを持つフィードの場合は、プラットフォームごとにテスト アカウントを提供します。
  • Icons: 次の 5 つのアイコンを送信します。これらのアイコンは、検索の Google Play ゲーム アクションの横で使用されます。
カテゴリ サイズ(ピクセル) ファイルサイズ ガイドライン
検索、キャスト、その他の場所でゲーム アクションを再生する
16x16 112x112 ピクセルを除くすべてのアイコンのファイルサイズは、1 KB 以下とする必要があります。

112x112 ピクセルのアイコンのファイルサイズは、3 KB 以下とする必要があります。

5 つのアイコンのサイズはすべて必須です。

画像は次の要件を満たしている必要があります。

  • PNG ファイル形式。
  • 円形。
  • 背景は透明にします。
  • 画像がアンチエイリアス処理され、歪んだりピクセル化したりしていないことを確認します。
20×20
40x40
44x44
112x112

サンプル

サンプル アイコン

フィードの検証の仕組み

フィードの検証には次の 2 つの段階があります。

  • 構造の検証:
    • これは検証チェックの最初のフェーズです。
    • Google は、JSON ファイルの構造に関するフィードバックを提供します。JSON の形式は正しいですか?フィードにすべての必須プロパティと強く推奨されるプロパティが含まれているか。ディープリンクは、フィード要件に沿って提供され、アノテーションが付けられていますか?
    • このフェーズでは、Google との間で何度かやり取りを行い、すべてのフィードバックに対応するまで続けます。
  • メタデータの調整:
    • このプロセスは、フィードが構造検証フェーズを通過した後にのみ開始されます。この時点で、Google は Google のナレッジグラフとの調整プロセスを開始します。
    • このフェーズでは、フィードに含まれるメタデータに関するフィードバックを提供します。リリースを成功させるには、すべての問題に対処する必要があります。たとえば、このフェーズのフィードバックでは、ゲームのタイトルやリリース日の修正が求められることがあります。
    • このフェーズでは、Google とのやり取りが複数回必要となり、すべてのフィードバックに対応するまで続きます。

フィードの承認基準

すべてのブロックの問題が解決され、Google がメタデータの品質がリリース基準に達していることを認定した場合、フィードはリリース可能と見なされます。

必要に応じてフィードを更新する

書籍の目録を変更する頻度にもよりますが、フィードは毎日更新することをおすすめします。以下の条件とヒントを参考にしてください。

  • Google 検索はリアルタイムでの更新をサポートしていません。
  • Google 検索は 1 日に 1 回フィードを取得し、通常 2 日以内にコンテンツをインデックスに登録します(リリース時)。
  • ディープリンクを提供できる時期に変更が見込まれる場合は、availabilityStarts と availabilityEnds を使用して正確な日付を設定します。
  • エンティティがカタログで利用できなくなった場合は、フィードからエンティティを完全に削除します。

リファレンス

フィードの構造の概要

Play Game Actions フィードの構造は次のとおりです。

playgame フィードの図

データフィード エンベロープ

データフィード エンベロープは、Google Play ゲーム アクション フィードの最上位オブジェクトです。このオブジェクトには、カタログ内のすべてのゲームを表すコンテンツ マークアップ オブジェクト(VideoGame(Work)エンティティ)の配列が含まれます。

プロパティ タイプ 説明
@context URL 必須。http://schema.org に設定
@type テキスト 必須。DataFeed に設定します。
dateModified DateTime 必須。フィードの最終更新日時。ISO 8601 形式で指定します(タイムゾーンを含む)。
dataFeedElement Thing 必須。ゲーム カタログのエンティティ。

テンプレート

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {  },
    {  },
    ...
  ]
}
    

コンテンツ マークアップ オブジェクト

コンテンツ マークアップ オブジェクトは、カタログ内の単一のエンティティ(VideoGame(Work))を表します。このオブジェクトにはコンテンツの識別子と正規 URL が含まれており、メタデータによってコンテンツの補足情報を付けることができます。VideoGame(Work)のコンテンツ マークアップ オブジェクトには、VideoGame(Edition)オブジェクトにリンクするための exampleOfWork というプロパティがあります。この VideoGame(Edition)には、アクション マークアップ オブジェクトの配列を含めることができます。これにより、コンテンツを複数のアクション マークアップ オブジェクトに関連付けることができます。たとえば、地域ごとに異なるアクション マークアップ オブジェクトを指定できます。

アクション マークアップ オブジェクト

アクション マークアップ オブジェクトには、ユーザーをゲームに誘導するディープリンクと、ゲームに必要なアクセスレベルを記述します。このオブジェクトは、コンテンツ マークアップ オブジェクトのプロパティ(potentialAction)です。ゲーム アクションの場合は、アクション アクセス指定オブジェクトを使用してアクセス制限を指定します。

プロパティ タイプ 説明
@type テキスト 必須。常に PlayGameAction に設定。
gameAvailabilityType GameAvailabilityEnumeration または Text 必須。このアクションに関連付けられているゲーム コンテンツの利用可能タイプ(フルバージョンかデモかなど)を示します。指定できる値は DEMO と FULL です。
additionalType テキスト 必須。このゲームに関連付けられた再生アクションのタイプを示します。指定できる値は次のとおりです。
  • StreamingPlayAction - ゲームをオンラインでストリーミングできることを示します
  • DownloadPlayAction - ゲームをダウンロードできることを示します
target EntryPoint 必須。ディープリンクをさまざまな Google プラットフォームにマッピングするためのターゲット オブジェクト。
target.@type テキスト 必須。常に EntryPoint に設定。
target.urlTemplate URL 必須。アプリやプラットフォームにユーザーを誘導し、ゲームの再生を開始するためのディープリンク。
target.inLanguage テキスト (省略可)シリーズの元の言語(BCP 47 形式)。
target.actionPlatform テキスト 必須。urlTemplate にマッピングされるプラットフォーム。Play Game Actions は次の値をサポートしています。
  • http://schema.org/DesktopWebPlatform
  • http://schema.org/MobileWebPlatform
  • http://schema.org/AndroidPlatform
  • http://schema.org/AndroidTVPlatform
  • http://schema.org/IOSPlatform

要件については、プラットフォーム タイプをご覧ください。

actionAccessibilityRequirement ActionAccessSpecification 必須。コンテンツのアクセス要件を説明するアクション アクセス指定オブジェクト。詳細については、アクション アクセス指定オブジェクトをご覧ください。

テンプレート

"potentialAction": {
  "@type": "PlayGameAction",
  "target": [
    {  },
    {  }
  ],
  "actionAccessibilityRequirement": [
    {  },
    {  }
  ]
}
    

ターゲット

ターゲット オブジェクトは、各種 Google プラットフォームへのディープリンクのマッピングを提供します。このオブジェクトは、アクション マークアップ オブジェクトのプロパティ(target)です。urlTemplate プロパティはディープリンクを取得し、actionPlatform はディープリンクをサポートするプラットフォームを取得します。

例

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]
    

アクション アクセス指定

アクション アクセス指定オブジェクトには、地域と期間に基づくコンテンツのアクセス要件を記述します。このオブジェクトは、アクション マークアップ オブジェクトのプロパティ actionAccessibilityRequirement です。

2 つのディープリンクを持つターゲットの例

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]
    

アクション アクセス指定

アクション アクセス指定オブジェクトには、地域と期間に基づくコンテンツのアクセス要件を記述します。このオブジェクトは、アクション マークアップ オブジェクトのプロパティ actionAccessibilityRequirement です。

プロパティ タイプ 説明
actionAccessibilityRequirement.@type テキスト 必須。常に ActionAccessSpecification に設定。
actionAccessibilityRequirement.category テキスト 必須。コンテンツのアクセス要件。使用できる値と詳細については、ペイウォール タイプをご覧ください。

一群のコンテンツを表すエンティティの場合は、最も制限の緩やかなコンテンツ アクセス要件をカテゴリに設定する必要があります。たとえば、ゲームが nologinrequired を使用して無料でアクセスでき、サブスクリプションでもアクセスできる場合は、カテゴリを nologinrequired に設定します。

actionAccessibilityRequirement.availabilityStarts 日付 必須。アクションが使用可能になる ISO 8601 形式(タイムゾーンを含む)の日付。将来の日付も設定できます。
  • availabilityStarts の 72 時間以上後の日付を指定します。
  • 公開後のコンテンツが常時利用可能である場合は、現在の日付から 20 年後の日付を設定します。

対応するエンティティは、availabilityStarts 日の少なくとも 7 日前までにフィードで提供する必要があります。これにより、ゲームが Google サービスに予定どおりに表示される可能性が高まります。

actionAccessibilityRequirement.availabilityEnds 日付 必須。アクションが使用不可になる ISO 8601 形式(タイムゾーンを含む)の日付。将来の日付も設定できます。
  • availabilityStarts の 72 時間以上後の日付を指定します。
  • 公開後のコンテンツが常時利用可能である場合は、現在の日付から 20 年後の日付を設定します。

availabilityEnds 日付の更新は、availabilityEnds 日付の少なくとも 7 日前までにフィードで行う必要があります。これにより、availabilityEnds にゲームが Google サービスに表示されなくなる可能性が高まります。

actionAccessibilityRequirement.eligibleRegion Country、City、State、GeoShape、または Text 必須。コンテンツが利用可能な地域。コンテンツがグローバルに利用可能な場合は、特殊文字列 EARTH を使用します。必要な内容については、GeoShape プロパティをご覧ください。
actionAccessibilityRequirement.ineligibleRegion Country、City、State、GeoShape、または Text 該当する場合は必須。コンテンツが制限されている地域。eligibleRegion 内のどこでもコンテンツが利用可能である場合は、このプロパティは不要です。

必要な内容については、GeoShape プロパティをご覧ください。

actionAccessibilityRequirement.requiresSubscription MediaSubscription 該当する場合は必須。コンテンツにアクセスするためにユーザーに必要となる有料会員登録の詳細。詳しくは、メディアの有料会員登録プロパティをご覧ください。
  • category が subscription の場合は、このプロパティを指定します。
actionAccessibilityRequirement.expectsAcceptanceOf 特典 コンテンツの購入が必要な場合は必須。コンテンツに関連付けられた特典の詳細。以下の場合の価格情報を指定します。
  • コンテンツの 1 回だけの購入(rental または purchase)
  • 登録ユーザーは追加購入が必要となる、有料会員登録ベースのコンテンツ(subscription)

価格が 0.00 の場合は、Offer オブジェクトを完全に削除し、actionAccessibilityRequirement.category を free に設定します。詳しくは、特典のプロパティをご覧ください。

メディア サブスクリプションの仕様

メディア サブスクリプション オブジェクトには、コンテンツに必要なサブスクリプションの詳細を記述します。このオブジェクトは、アクション アクセス指定オブジェクトのプロパティ requiresSubscription です。

重要: actionAccessibilityRequirement.category が subscription で、定期購入プランに複数のパッケージや階層が含まれている場合、またはアドオンのサポートがある場合は、この設定が必要です。サブスクリプションが 1 つの階層で、カタログ内のすべてのコンテンツにアクセスできる場合は、このフィールドを省略します。
プロパティ タイプ 説明
requiresSubscription.@type テキスト 必須。常に MediaSubscription に設定。
requiresSubscription.@id URL 必須。定期購入の一意の ID。異なる複数の有料会員登録からアクセス可能なコンテンツの場合は、個々の有料会員登録に一意の ID が必要です。
requiresSubscription.name テキスト 必須。サブスクリプションの名前。 次の点に注意してください。
  • 異なる複数の有料会員登録からアクセス可能なコンテンツの場合は、この名前がユーザー認証システムで使用されている名前と一致する必要があります。たとえば、ユーザーは「パッケージ 1」という名前の有料会員登録に基づいてコンテンツにアクセスできますが、認証システムでは「PKG1」という名前が使用されている場合は、「PKG1」を使用します。
requiresSubscription.sameAs URL (省略可)有料会員登録を説明するページ。
requiresSubscription.identifier テキスト category が subscription で、commonTier が false の場合は必須です。メディア カタログにあるコンテンツ グループへのアクセス権を表す、この定期購入に固有の文字列。
  • Google では、identifier に次の構文を使用することをおすすめします。ドメイン名 + コロン(:)+ コンテンツへのアクセスレベル。例: example.com:basic、example.com:premium、example.com:sports
requiresSubscription.commonTier ブール値 カテゴリが定期購入に設定されている場合は必須。commonTier の詳細については、共通の階層要件のドキュメントをご覧ください。

特典のプロパティ

オファー オブジェクトには、コンテンツに関連付けられた価格を記述します。このオブジェクトは、アクション アクセス指定オブジェクトのプロパティ(expectsAcceptanceOf)です。次の 2 つの目的で使用できます。

  • ゲームの購入の詳細を提供するため。このユースケースでは、actionAccessibilityRequirement.category を purchase に設定する必要があります。
  • ゲームがセール中の場合に、ゲームの購入詳細を提供します。このユースケースでは actionAccessibilityRequirement.category を purchase に設定し、アクションごとに 2 つのオファー(1 つは正規価格の詳細を提供するためのもの、もう 1 つはセール価格の詳細を提供するためのもの)を指定する必要があります。

プロパティ タイプ 説明
expectsAcceptanceOf.@type テキスト 必須 - 常に Offer に設定します。
expectsAcceptanceOf.name テキスト 省略可 - オファーの名前。
expectsAcceptanceOf.priceSpecification PriceSpecification 必須 - ゲームに関連付けられた料金の詳細。
expectsAcceptanceOf.priceSpecification.@type テキスト 必須 - 常に UnitPriceSpecification に設定します。
expectsAcceptanceOf.priceSpecification.price 数値 必須 - コンテンツの購入価格。価格は 0 以外の正の値にする必要があります。価格が 0.00 のゲームの場合は、actionAccessibilityRequirement.category を `free` に設定してください。
expectsAcceptanceOf.priceSpecification.priceCurrency テキスト 必須 - 価格の通貨(3 文字の ISO 4217 形式)。
expectsAcceptanceOf.priceSpecification.priceType PriceTypeEnumeration または Text 該当する場合は必須 - 特典で提供される価格のタイプ。
actionAccessibilityRequirement.category が purchase に設定されている場合、これは必須プロパティであり、
  • https://schema.org/ListPrice - ゲームの正規料金を表します。
  • https://schema.org/SalePrice - ゲームのセール価格(通常は期間限定)を表します。

セール価格の詳細を指定する場合は、https://schema.org/ListPrice と https://schema.org/SalePrice の両方が必要です。
expectsAcceptanceOf.seller 組織 コンテンツの購入を提供する組織。
expectsAcceptanceOf.seller.@type テキスト 常に Organization に設定します。
expectsAcceptanceOf.seller.name テキスト 販売者の名前。
expectsAcceptanceOf.seller.sameAs URL 販売者を識別するウェブページの URL(販売者のホームページなど)。

サポートされているペイウォール タイプごとに、以下の例で actionAccessibilityObject の作成方法を確認できます。

無料(ログイン不要)

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

無料(ログイン不要、1 時間のトライアルのみ)

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "eligibleDuration": 60
    }
  }
}

無料(ログインが必要)

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "free",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

セール中の 1 回限りの購入

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": [
      {
        "@type": "Offer",
        "name": "Original Price",
        "priceSpecification": {
          "@type": "UnitPriceSpecification",
          "price": 7.99
          "priceCurrency": "USD"
          "priceType": "https://schema.org/ListPrice"
        },
        "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
          }
        },
        {
          "@type": "Offer",
          "name": "Sale Price",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "price": 4.99
            "priceCurrency": "USD"
            "priceType": "https://schema.org/SalePrice"
          },
          "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
        }
      }
    ]
  }
}

1 回だけの購入

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

単一レベル/複数レベル/アドオンの定期購入

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

階層型定期購入とアドオン

以下に、階層型定期購入とアドオンの適用方法について説明します。

  • 単一階層のサブスクリプション モデルでは、サービス プロバイダが 1 つのサブスクリプション階層を用意します。サブスクリプション パッケージに関係なく、すべての定期購入者が同じコンテンツにアクセスできます。
  • 階層型サブスクリプション モデルでは、サービス プロバイダが複数のサブスクリプション階層(ゴールド、シルバー、ブロンズなど)を用意します。上位階層のサブスクリプションを持つユーザーは、その下位階層のすべてのコンテンツにアクセスできます。ただし、下位階層のサブスクリプションを持つユーザーは、上位階層のコンテンツにアクセスできません。コンテンツの例 1
  • アドオンのサブスクリプション モデルでは、ユーザーが利用資格を拡張して基本サブスクリプションにコンテンツを追加できる仕組みをサービス プロバイダが用意します。ユーザーはコンテンツを必要なだけ追加できます。コンテンツの例 2

エンティティの全体的なテンプレート

エンティティの全体的なテンプレートの例を次に示します。

テンプレート

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {
       "@context": ["http://schema.org", {"@language": "en"}],
       "@type": "VideoGame",
       "@id": "http://www.example.com/game007",
       "url": "http://www.example.com/game007",
       "name": "Games Bond 007",
       "exampleOfWork": [
        {  },
        {
           "@type": "VideoGame",
            "@id": "http://www.example.com/game007Stadia",
            "url": "http://www.example.com/game007Stadia",
            "name": "Games Bond 007",
            // Other properties
           "potentialAction": [
              {  },
              {
                  "@type": "PlayGameAction",
                  "target": [
                  {  },
                  {  }
                  ],
                 "actionAccessibilityRequirement": [
                 {  },
                 {  }
                 ]
              }
          ],
    ...
    }
  ]
}

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

このセクションでは、VideoGame エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。コンテンツが検索結果に表示されるようにするには、下記の一覧に示す必須プロパティを含める必要があります。また、推奨プロパティを使用すると、コンテンツについてさらに詳しい情報を追加できるため、ユーザー エクスペリエンスの向上につながり、Google のナレッジグラフとのエンティティの照合にも役立ちます。

VideoGame(Work)の仕様表

プロパティ タイプ 説明
@context テキスト 必須。常に ["http://schema.org", {"@language": "xx"}] に設定します。
  • Where xx 値は、フィード内の文字列の言語を表します。各ルート エンティティ コンテキストの @language は、BCP 47 形式の適切な言語コードに設定する必要があります。たとえば、言語がスペイン語に設定されている場合、字幕/吹き替えの言語が英語であっても、名前はスペイン語であると想定されます。
@type テキスト 必須。常に VideoGame に設定。
@id URL 必須。URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc. @id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意。
  • 静的。ID は固定されており、ゲームの url プロパティが変更されても、時間の経過とともに変化してはなりません。不透明型の文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式。
  • @id 値に使用するドメインが、自分の組織が所有するものであること。

エンティティの url は識別子のすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。

url URL 必須。Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
  • url はグローバルに一意である必要があります。
  • url には Google がクロールすることが可能な機能する正規 URL を含める必要があります。

再生のディープリンクについては、代わりに、ターゲット オブジェクトの urlTemplate プロパティをご覧ください。

name テキスト ゲームの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。詳細については、複数の地域と言語の例をご覧ください。
  • ロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
description テキスト 強く推奨します。ゲームのあらすじ。300 文字以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。詳細については、複数の地域と言語の例をご覧ください。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例: ["Action", "Role playing"]
image ImageObject 強く推奨します。ゲームに関連する画像。image に含める必須プロパティと省略可能なプロパティの詳細については、画像のプロパティをご覧ください。
applicationCategory テキスト 省略可。ソフトウェア アプリケーションの種類。値を Game に設定します。
exampleOfWork VideoGame 必須 VideoGame のエディション。この VideoGame(エディション)エンティティには、ディープリンクの詳細も含まれます。詳しくは、VideoGame(Edition)の仕様表をご覧ください。
playMode Text または GamePlayMode (省略可)このゲームがマルチプレーヤー、協力プレイ、シングル プレーヤーのいずれであるかを示します。ゲームは、マルチプレーヤー、協力プレイ、シングル プレーヤーとして同時にマークできます。次の値を受け入れます。
  • SINGLE_PLAYER
  • LOCAL_MULTI_PLAYER
  • ONLINE_MULTI_PLAYER
  • LOCAL_COOP
  • ONLINE_COOP

VideoGame(Edition)の仕様表

プロパティ タイプ 説明
@type テキスト 必須。常に VideoGame に設定。
@id URL 必須。URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc.@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意。
  • 静的。ID は固定されており、ゲームの url プロパティが変更されても、時間の経過とともに変化してはなりません。不透明型の文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier(URI)の形式。
  • @id 値に使用するドメインが、自分の組織が所有するものであること。

エンティティの url は識別子のすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、識別子セクションをご覧ください。

url URL 必須。Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
  • url はグローバルに一意である必要があります。
  • url には Google がクロールすることが可能な機能する正規 URL を含める必要があります。

再生のディープリンクについては、代わりに、ターゲット オブジェクトの urlTemplate プロパティをご覧ください。

name テキスト ゲームの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。詳細については、複数の地域と言語の例をご覧ください。
  • ロケール(言語と国のペア)ごとにサポートされる名前は 1 つのみです。
description テキスト 強く推奨します。ゲームのあらすじ。300 文字以内。
  • 複数の言語で説明をマークアップするには、配列を使用します。詳細については、複数の地域と言語の例をご覧ください。
genre テキスト 関連するすべてのジャンルの順序付きリスト。例: ["Action", "Role playing"]
image ImageObject 強く推奨します。ゲームに関連する画像。image に含める必須プロパティと省略可能なプロパティの詳細については、画像のプロパティをご覧ください。
applicationCategory テキスト 省略可。ソフトウェア アプリケーションの種類。値を Game に設定します。
playMode Text または GamePlayMode (省略可)このゲームがマルチプレーヤー、協力プレイ、シングル プレーヤーのいずれであるかを示します。ゲームは、マルチプレーヤー、協力プレイ、シングル プレーヤーとして同時にマークできます。次の値を受け入れます。
  • SINGLE_PLAYER
  • LOCAL_MULTI_PLAYER
  • ONLINE_MULTI_PLAYER
  • LOCAL_COOP
  • ONLINE_COOP
potentialAction PlayGameAction

該当する場合は必須。アクションの詳細を提供するアクション マークアップ オブジェクト。

配列を使用して、複数の地域の異なるディープリンクを指定します。詳細については、複数の地域と言語の例をご覧ください。

gameEdition テキスト

必須。このゲームのエディション。

たとえば、人気ゲーム「シャドウ オブ ザ トゥームレイダー」には、「クロフト エディション」、「スタンダード エディション」、「デジタル デラックス エディション」、「アルティメット エディション」の 4 つのエディションがあります。

gamePlatform テキスト 必須。ビデオゲームのプレイに使用されるプラットフォームまたは電子システム。
releasedEvent PublicationEvent 強く推奨します。PublicationEvent は、パブリッシャーによるコンテンツのオリジナル(グローバルまたはローカル)リリースを指定するために使用されます。
releasedEvent.@type テキスト 必須。このプロパティは常に PublicationEvent に設定してください。
releasedEvent.Location 国 必須。このリリース イベントに関連付けられている地域。

国には ISO 3166 コードを使用します。世界中のすべての場所を示すには、EARTH に設定します。

releasedEvent.startDate Date または Time (推奨)ExclusiveEvent では必須です。エンティティの公開開始日。
releasedEvent.endDate Date または Time (省略可)これは、コンテンツの権利が期限切れになる日付を表します。
releasedEvent.publishedBy Organization または Person (省略可)このエンティティを公開した組織または個人。
contentRating テキスト 成人向けゲームでは必須、それ以外では強く推奨。コンテンツの総合的なレーティング。 コンテンツのレーティングがテキスト文字列の形式で提供された場合は、次の 2 つのバリエーションが認められます。
  • 格付けの前に空白を挟んで格付け機関を付加します。たとえば、米国の代理店「Entertainment Software Rating Board」の「Mature」レーティングは Entertainment Software Rating Board Mature と記述する必要があります。
  • ゲームのレーティングが不明であることを示す値 RATING NOT KNOWN(大文字と小文字は区別されません)。
publisher Organization または Person (省略可)このエンティティを公開した組織または個人。
contributor Organization または Person (省略可)このエンティティの副投稿者。

画像の仕様表

Play Game Actions の再利用では、Media Actions スキーマを使用して画像要件をキャプチャします。詳細については、画像スキーマの仕様をご覧ください。

注意が必要なその他の要件を以下に示します。

アスペクト比と contentAttributes 最小解像度(ピクセル単位)
16:9、象徴的なポスター 3840×2160
2:3、象徴的なポスター 1000x1500
4:3、象徴的なポスター 800X600
1:1、象徴的なポスター 600x600
3:4、象徴的なポスター 600x800
16:9、象徴的な背景 [推奨] または sceneStill 3840×2160
2:3、象徴的な背景 [推奨] または sceneStill 1000x1500
3:4、象徴的な背景 [推奨]、または sceneStill 600x800

形式の要件

画像サイズや品質などに関するフォーマットの要件は次のとおりです。

  • ゲームの最高解像度のポスターと sceneStills を含めます。
  • 画像は JPG、PNG、WebP のいずれかの形式にする必要があります。
  • 画像の URL は、クロール可能でインデックス登録できる必要があります。
  • ファイルサイズは 20 MB を超えないようにしてください。
  • smallFormat と largeFormat の両方で機能する画像が望ましいです。
  • 次のような画像は使用できません。

    • ぼやけた画像、モザイクのかかった画像、回転した画像、低品質の画像。
    • 使用許可を受けていない画像、またはストックフォト。
    • ヌード。
    • 不正なコンテンツ。
  • 上記の表に記載されているサイズ以外にも、画像サイズを含めることができます。

例

以降のセクションでは、さまざまなシナリオのサンプル フィードの例を紹介します。

VideoGame エンティティが 1 つ含まれるフィードの例

「Space Wars Made Up Game」ゲームを表す VideoGame エンティティの例を次に示します。このエンティティは、Google に表示されるように、JSON ファイルのデータフィード エンベロープで囲む必要があります。

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type":"DataFeed",
   "dateModified":"2021-07-20T00:44:51Z",
   "dataFeedElement":[
      {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@id":"https://www.examplegame.com/VideoGame007",
         "@type":"VideoGame",
         "url":"https://www.examplegame.com/games/VideoGame007",
         "name":"Space Wars Made Up Game",
         "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
         "genre":[
            "Role playing"
         ],
         "applicationCategory":"Game",
         "publisher":{
            "name":"Made Up Media",
            "@id":"https://www.examplegame.com/uniuqe-id-org",
            "@type":"Organization"
         },
         "contributor":[
            {
               "roleName":"developer",
               "name":"Alpha Labs Man Made Studio",
               "@id":"https://www.studionice.com/uniuqe-id-alpha",
               "@type":"Organization"
            }
         ],
         "playMode":[
           "SINGLE_PLAYER", "LOCAL_MULTI_PLAYER", "ONLINE_MULTI_PLAYER", "LOCAL_COOP", "ONLINE_COOP"
         ],
         "image":[
            {
               "@context":"http://schema.org",
               "@type":"ImageObject",
               "name":"keyart_1X1_3X",
               "contentUrl":"https://lh3.googleusercontent.com/ept4",
               "copyrightHolder":{
                  "@type":"Organization",
                  "name":"Studio Nice"
               },
               "additionalProperty":[
                  {
                     "@type":"PropertyValue",
                     "name":"contentAttributes",
                     "value":[
                         "SMALLFORMAT", "LARGEFORMAT", "SCENESTILL", "CENTERED", "NOTITLE", "NOLOGO"
                     ]
                  }
               ]
            }
         ],
         "exampleOfWork":{
            "@id":"https://www.examplegame.com/VideoGame007/version/v3",
            "name":"Space Wars Made Up Game",
            "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
            "gameEdition":"Early Access",
            "url":"https://www.examplegame.com/VideoGame007/version/v3/stream",
            "contentRating":[
               "Entertainment Software Rating Board Mature",
               "Pan European Game Information 12",
               "Unterhaltungssoftware Selbstkontrolle Video Game Rating System USK 12"
            ],
            "applicationCategory":"Game",
            "releasedEvent":[
               {
                  "@type":"PublicationEvent",
                  "startDate":"2020-11-30",
                  "location":{
                     "@type":"Country",
                     "name":"US"
                  }
               }
            ],
            "potentialAction":{
               "@type":"PlayGameAction",
               "gameAvailabilityType":"DEMO",
               "target":[
                  {
                     "@type":"EntryPoint",
                     "urlTemplate":"https://www.examplegame.com/VideoGame007/play",
                     "actionPlatform":[
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.org/AndroidPlatform",
                        "http://schema.org/AndroidTVPlatform",
                        "http://schema.org/IOSPlatform"
                     ]
                  }
               ],
               "actionAccessibilityRequirement":[
                  {
                     "@type":"ActionAccessSpecification",
                     "availabilityStarts": "2015-01-01T00:00Z",
                     "availabilityEnds": "2015-12-31T00:00Z",
                     "eligibleRegion":{
                        "@type":"Country",
                        "name":[
                           "US"
                        ]
                     },
                     "category":"subscription",
                     "requiresSubscription":{
                        "@type":"MediaSubscription",
                        "name":"",
                        "@id":""
                     }
                  }
               ],
            },
            "gamePlatform": "Google Stadia",
            "publisher":{
               "name":"Made Up Media",
               "@id":"https://www.examplegame.com/uniuqe-id-org",
               "@type":"Organization"
            },
            "contributor":[
               {
                  "roleName":"developer",
                  "name":"Alpha Labs Man Made Studio",
                  "@id":"https://www.studionice.com/uniuqe-id-alpha",
                  "@type":"Organization"
               }
            ]
         }
      }
   ]
}

2 人のゲーム キャラクターが描かれたサンプル画像を表す

野原にいる女性と鳥のイラスト。
{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "VideoGame",
  "@id": "http://www.examplegame.com/videoGame1",
  "url": "http://www.examplegame.com/videoGame1",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mauren and Lord Wingflap!",
    "Keywords": "Mauren, Lord Wingflap the Destroyer",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" }
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

複数の地域と言語への対応(国際化)

VideoGame エンティティは、複数の地域と言語で利用できます。

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "VideoGame",
  "@id": "http://www.example.com/my_favorite_game",
  "url": "http://www.example.com/my_favorite_game",
  "name": [
    {
      "@language": "en-us",
      "@value": "My Favorite Game"
    },
    {
      "@language": "es-mx",
      "@value": "mi juego favorito"
    },
    {
      "@language": "ja-jp",
      "@value": "私のfavourite game"
    }
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    },
    {
      "@language": "ja-jp",
      "@value": "PaulとJennyが会う。"
    }
  ],
  "potentialAction": [
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-06-24T11:00:00Z",
        "availabilityEnds": "2041-06-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 19.99,
            "priceCurrency": "USD",
            "priceType": "https://schema.org/ListPrice"
          },
          {
            "@type": "UnitPriceSpecification",
            "price": 360.00,
            "priceCurrency": "MXN",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    },
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/jp/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-07-24T11:00:00Z",
        "availabilityEnds": "2041-07-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "JP"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "ja"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 2189,
            "priceCurrency": "JPY",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    }
  ],
  // Other properties...
}