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

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

SportsEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}]
に設定します。
  • xx を、エンティティの言語コード（BCP 47 形式）に置き換えます（例: "en"）。
@type テキスト 必須 - 常に SportsEvent に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。
@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意
  • 静的。ID は、番組の URL プロパティが変更されても、時間が経過しても変化しないものにする必要があります。これは不透明な文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier（URI）の形式
  • @id 値に使用するドメインが、自分の組織が所有するものであること。
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url を @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 Person チームの個々のアスリートに関する注釈。
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 の場合に必須 - 場所の住所。場所の @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 の例

団体競技の例

{
  "@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"
    }
  ]
}

個人競技の例

{
  "@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"
    }
  }
}

GeoShape 制限のある SportsEvent

{
  "@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"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform",
          "http://schema.org/AndroidPlatform",
          "http://schema.org/IOSPlatform",
          http://schema.googleapis.com/GoogleVideoCast
        ]
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "free",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "http://www.example.com/example_package"
        },
       "eligibleRegion": [{
          "@type": "GeoShape",
          "@id": "http://example.com/area1",
          "addressCountry": "US",
          "postalCode": [
            "94118",
            "94119"
            ]
          },
          {
          "@type": "GeoShape",
          "@id": "http://example.com/area2",
          "addressCountry": "US",
          "postalCode": [
            "94120",
            "94121"
            ]
          },
        ]
      }
    }
  ]
}

MusicEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}]
に設定します。
  • xx は、エンティティの言語コードを BCP 47 形式で置き換えます（例: "en"）。
@type テキスト 必須 - 常に MusicEvent に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。
@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意
  • 静的
  • Unified Resource Identifier（URI）の形式
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url を @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 の場合に必須 - 場所の住所。ロケーションの @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 形式で置き換えます（例: "en"）。
@type テキスト 必須 - 常に Event に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc です。
@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意
  • 静的
  • Unified Resource Identifier（URI）の形式
エンティティの url は識別子としてのすべての要件を満たしているため、エンティティの url を @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 の場合に必須 - 場所の住所。ロケーションの @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"
  }
}