イベントのコンテンツ マークアップ プロパティ

このセクションでは、Event 関連のエンティティ タイプのコンテンツ マークアップ プロパティの詳細について説明します。

SportsEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
  • xx は、エンティティの言語コード（BCP 47 形式など）に置き換えます。
@type テキスト 必須 - 常に SportsEvent に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子（例: https://example.com/1234abc）。
@id は次の要件を満たしている必要があります。
  • カタログ全体でグローバルに一意
  • 静的: ID は固定されており、（番組の URL プロパティが変更されても）時間の経過とともに変化してはなりません。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier（URI）の形式
  • @id 値に使用するドメインが、自分の組織が所有するものであること。
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、ID セクションをご覧ください。
name テキスト 必須 - このイベントの名前。
  • 配列を使用して、さまざまな言語で名前を一覧表示します。「複数の地域と言語」の例をご覧ください。
  • 各ロケール（言語と国のペア）でサポートされる名前は 1 つのみです。
description テキスト このイベントの説明。300 文字以内。配列を使用して複数の言語と長さの説明を含めます。
sport URL 必須。スポーツのウィキペディア ページ（英語版を推奨）へのリンク。
startDate DateTime または Date 必須 - タイムゾーンを含む ISO 8601 形式のイベントの開始時間。なお、これはイベントがテレビで放映された時間ではなく、イベントの実際の開始時間です。
endDate DateTime または Date タイムゾーンを含む ISO 8601 形式のイベントの終了時刻。
homeTeam SportsTeam おすすめ理由イベントのホームチーム。
homeTeam.name テキスト 必須。スポーツチームのフルネーム。
homeTeam.sport URL 必須。スポーツのウィキペディア ページ（英語版を推奨）へのリンク。
homeTeam.sameAs URL おすすめ理由チームを識別できる参照ウェブページの URL（そのチームの Wikipedia ページなど）。
homeTeam.athlete 担当者 チームの個々のアスリートに関する注釈。
homeTeam.athlete.name テキスト アスリートのフルネーム。
homeTeam.parentOrganization.name SportsOrganization 必須。チームが所属するスポーツリーグの名前。たとえば、全米バスケットボール アソシエーションやメジャーリーグ ベースボールなどです。このフィールドはチームの会議には使用しないでください。
homeTeam.parentOrganization.sameAs URL おすすめ理由チームのリーグを識別できる参照ウェブページの URL（リーグの Wikipedia ページなど）。
awayTeam SportsTeam おすすめ理由イベントのアウェイチーム。プロパティは SportsEvent.homeTeam と同じです。
competitor SportsTeam または Person おすすめ理由ホームチームまたはアウェイチームが該当しない場合（ボクシングの試合やオリンピックなど）は、参加者を競技者として指定します。SportsTeam の場合、プロパティは SportsEvent.homeTeam と同じです。Person の場合、プロパティは他の Person オブジェクトと同じです。たとえば、Movie のアクターです。
location 場所または市区町村 イベントの場所。
location.name テキスト 必須 - ビジネスの名前。
location.address PostalAddress location @type が Place の場合は必須 - 住所。location @type が「City」の場合は使用しないでください
location.address.streetAddress テキスト 住所の番地。
location.address.addressLocality テキスト 場所の市区町村。
location.address.addressRegion テキスト 場所の都道府県。
location.address.postalCode テキスト 場所の郵便番号。
location.address.addressCountry テキスト ISO 3166 形式の国。
image ImageObject Google TV では必須 - イベントに関連する画像。イベントの公式ポスターやバナーアートにすることをおすすめします。image に含める必須プロパティとオプション プロパティの詳細については、画像プロパティをご覧ください。
potentialAction WatchAction 必要に応じて必須 - このスポーツ イベントの録画をビデオ オンデマンドで再生するディープリンク。ライブイベントのディープリンクを指定するには、代わりに BroadcastEvent の publishedOn プロパティまたは potentialAction プロパティを使用します。
identifier PropertyValue おすすめ理由- このエンティティを一義的に示す外部 ID またはその他の ID。複数の識別子を使用できます。詳細については、識別子プロパティのセクションをご覧ください。

SportsEvent の例

例 1 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name":"2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport":"https://en.wikipedia.org/wiki/Basketball",
  "description": [
    {
      "@language": "en",
      "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
    },
    {
      "@language": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "athlete":[
      {
        "@type":"Person",
        "name":"Jane Doe"
      }
    ]
  },
  "location":{
    "@type":"Place",
    "name":"Example Stadium",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value":  "TMS ID of this game"
    }
  ]
}

例 2 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type":"SportsEvent",
  "@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
  "name":"2019 Professional Boxing - John Doe vs Jane Doe",
  "sport":"https://en.wikipedia.org/wiki/Boxing"
  "description":"World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
  "startDate": "2019-07-12T21:10-08:00",
  "competitor":[
    {
      "@type":"Person",
      "name":"Jane Doe",
      "birthDate":"1977-12-14",
      "gender":"F",
      "nationality":"US"
    },
    {
      "@type":"Person",
      "name":"John Doe",
      "birthDate":"1978-10-17",
      "gender":"M",
      "nationality":"GB"
    }
  ],
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  }
}

MusicEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
  • xx は、エンティティの言語コード（BCP 47 形式など）に置き換えます。
@type テキスト 必須 - 常に MusicEvent に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子（例: https://example.com/1234abc）。
@id は次の要件を満たしている必要があります。
  • カタログ全体でグローバルに一意
  • 静的
  • Unified Resource Identifier（URI）の形式
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、ID セクションをご覧ください。
name テキスト 必須 - このイベントの名前。
  • 配列を使用して、さまざまな言語で名前を一覧表示します。「複数の地域と言語」の例をご覧ください。
  • 各ロケール（言語と国のペア）でサポートされる名前は 1 つのみです。
description テキスト イベントの説明。300 文字以内。配列を使用して複数の言語と長さの説明を含めます。
attendee Organization または Person イベントに参加している人または組織。
startDate 日付 必須 - タイムゾーンを含む ISO 8601 形式のイベントの開始時間。
endDate 日付 タイムゾーンを含む ISO 8601 形式のイベントの終了時刻。
composer Organization または Person 作曲した人物または組織、あるいは、いくつかのイベントで実施された作品の作成者である人物または組織。
performer Organization または Person 必須 - イベントのパフォーマー（プレゼンター、ミュージシャン、音楽グループ、俳優など）。
subEvent イベント このイベントの一部であるイベント。たとえば、会議イベントには多数のプレゼンテーションが含まれ、各プレゼンテーションは会議のサブイベントになります。
superEvent イベント このイベントが属しているイベント。たとえば、個々の音楽公演のコレクションには、それぞれ、スーパーイベントとして音楽祭が含まれています。
location 場所または市区町村 必須 - イベントの場所。
location.name テキスト 必須 - ビジネスの名前。
location.address PostalAddress location @type が Place の場合は必須 - 住所。location @type が City の場合は使用しないでください。
location.address.streetAddress テキスト 住所の番地。
location.address.addressLocality テキスト 場所の市区町村。
location.address.addressRegion テキスト 場所の都道府県。
location.address.postalCode テキスト 場所の郵便番号。
location.address.addressCountry テキスト ISO 3166 形式の国。
workPerformed CreativeWork シアターイベントで上演された演劇など、イベントで上演された作品。

MusicEvent の例

MusicEvent 

{
  "@context":"http://schema.org",
  "@type":"MusicEvent",
  "@id": "http://example.com/music/my_favortie_artist/2019_tour",
  "name":"My Favorite Artist’s 2019 Homecoming Tour",
  "description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
  "startDate": "2014-10-12T21:10-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "performer": {
    "@type":"Person",
    "name":"My Favorite Artist",
    "birthDate":"1977-02-24",
    "gender":"F",
    "nationality":"CA"
  }
}

イベントの仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}] に設定します。
  • xx は、エンティティの言語コード（BCP 47 形式など）に置き換えます。
@type テキスト 必須 - 常に Event に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子（例: https://example.com/1234abc）。
@id は次の要件を満たしている必要があります。
  • カタログ全体でグローバルに一意
  • 静的
  • Unified Resource Identifier（URI）の形式
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url を @id として使用することをおすすめします。詳細については、ID セクションをご覧ください。
name テキスト 必須 - このイベントの名前。
  • 配列を使用して、さまざまな言語で名前を一覧表示します。「複数の地域と言語」の例をご覧ください。
  • 各ロケール（言語と国のペア）でサポートされる名前は 1 つのみです。
description テキスト イベントの説明。300 文字以内。配列を使用して複数の言語と長さの説明を含めます。
attendee Organization または Person イベントに参加している人または組織。
startDate 日付 必須 - タイムゾーンを含む ISO 8601 形式のイベントの開始時間。
endDate 日付 タイムゾーンを含む ISO 8601 形式のイベントの終了時刻。
subEvent イベント このイベントの一部であるイベント。たとえば、会議イベントには多数のプレゼンテーションが含まれ、各プレゼンテーションは会議のサブイベントになります。
superEvent イベント このイベントが属しているイベント。たとえば、個々の音楽公演のコレクションには、それぞれ、スーパーイベントとして音楽祭が含まれています。
releasedEvent PublicationEvent、FeaturedEvent、または ExclusiveEvent おすすめ理由- PublicationEvent は、映画の元の劇場公開日など、パブリッシャーによるコンテンツのオリジナル（グローバルまたはローカル）のリリースを指定します。

また、FeaturedEvent を使用して、このコンテンツをオリジナル、特集、スペシャルなどとして販売することを示します。

ExclusiveEvent は、サービスに独占的な配信権があり、いつ、どこで配信するかを指定します。

詳細と例については、例のセクションをご覧ください。
releasedEvent.@type テキスト 必須 - このプロパティは必ず次のいずれかに設定してください。
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location 国 必須 - このイベントに関連付けられている地域。

PublicationEvent の場合、これはコンテンツが公開された地域です。

FeaturedEvent と ExclusiveEvent の場合、これはコンテンツが掲載または限定される地域です。

国については ISO 3166 コードを使用します。全世界を示すには、EARTH に設定します。
releasedEvent.startDate Date または DateTime 推奨 - ExclusiveEvent の場合は必須 - エンティティの公開開始日。

PublicationEvent の場合、これはこのエンティティの最初の公開日（映画が最初に劇場で公開された日など）を示します。

ExclusiveEvent と FeaturedEvent の場合、これはエンティティが独占公開または注目の公開開始日を表します。
releasedEvent.endDate Date または DateTime 推奨 - ExclusiveEvent の場合は必須 - ExclusiveEvent タイプと FeaturedEvent タイプにのみ適用されます。

ExclusiveEvent の場合は、コンテンツの権利が期限切れになる日付を表します。

FeaturedEvent の場合は、プロバイダがエンティティを紹介する最終日を表します。

永久独占または注目のコンテンツの場合は、endDate を現在の日付から 20 年後に設定します。
releasedEvent.publishedBy Organization または Person 省略可 - このエンティティを公開した組織または個人。
location 場所または市区町村 必須 - イベントの場所。なお、Place は City レベルで指定できます。
location.name テキスト 必須 - ビジネスの名前。
location.address PostalAddress location @type が Place の場合は必須 - 住所。location @type が City の場合は使用しないでください
location.address.streetAddress テキスト 住所の番地。
location.address.addressLocality テキスト 場所の市区町村。
location.address.addressRegion テキスト 場所の都道府県。
location.address.postalCode テキスト 場所の郵便番号。
location.address.addressCountry テキスト ISO 3166 形式の国。
workPerformed CreativeWork シアターイベントで上演された演劇など、イベントで上演された作品。

イベントの例

イベント 

{
  "@context":"http://schema.org",
  "@type":"Event",
  "@id": "http://example.com/keynote/google_io_2019",
  "name":"Google I/O 2019 keynote",
  "description":"Google’s annual developer conference keynote event.",
  "startDate": "2019-05-07T10:00-08:00",
  "location":{
    "@type":"Place",
    "name":"Example Arena",
    "address":{
      "@type":"PostalAddress",
      "streetAddress":"1600 Amphitheatre Pkwy",
      "addressLocality":"Mountain View",
      "addressRegion":"CA",
      "postalCode":"94043",
      "addressCountry":"US"
    }
  },
  "attendee": {
    "@type":"Person",
    "name":"My Favorite Speaker",
    "birthDate":"1971-12-02",
    "gender":"F",
    "nationality":"IN"
  }
}