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

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

SportsEvent の仕様表

プロパティ タイプ 説明
@context テキスト 必須 - 常に ["http://schema.org", {"@language": "xx"}]
に設定します。
  • xx は、エンティティの言語コード（BCP 47 形式、例: 「en」）に置き換えます。
@type テキスト 必須 - 常に SportsEvent に設定します。
@id URL 必須 - URI 形式のコンテンツの識別子（例: https://example.com/1234abc）。
@id は次の要件を満たす必要があります。
  • カタログ全体でグローバルに一意（この SportsEvent を参照する BroadcastEvent の @id とは異なる）
  • 静的。ID は固定されており、時間の経過とともに変化してはなりません。不透明型の文字列として扱われ、有効なリンクである必要はありません。
  • Unified Resource Identifier（URI）の形式
  • @id 値に使用するドメインは、プロバイダの組織が所有するものであることが必要です。
重要: SportsEvent または BroadcastEvent に url プロパティを含めないでください。SportsEvent.potentialAction を使用して再生リンクを提供します。詳しくは、識別子のセクションをご覧ください。
name テキスト 必須 - このイベントの名前。
  • 複数の言語で名前を列挙するには、配列を使用します。複数の地域と言語の例をご覧ください。
  • 1 つの言語 / 地域（言語と国の組み合わせ）につき 1 つの名前のみがサポートされます。
description テキスト このイベントの説明。300 文字数制限。配列を使用して、複数の言語で説明を記述します（言語ごとに 1 つ）。
sport URL 必須。スポーツの Wikipedia ページ（英語版が望ましい）へのリンク。
startDate DateTime または Date 必須 - ISO 8601 形式のイベントの開始時刻（タイムゾーンを含む）。これは、イベントがテレビで放映される時間ではなく、イベントの実際の開始時間です。
endDate DateTime または Date 推奨 - イベントの終了予定時刻。ISO 8601 形式でタイムゾーンとともに指定します。予定されている終了時間がわかっている場合は、必ず指定してください。終了時間が不明な場合は、推定のプレースホルダを指定するのではなく、このプロパティを省略してください。
homeTeam SportsTeam 強く推奨 理由イベントのホームチーム。
homeTeam.name テキスト 必須。スポーツチームの正式名称。
homeTeam.sport URL 必須。スポーツの Wikipedia ページ（英語版が望ましい）へのリンク。
homeTeam.sameAs URL 強く推奨 理由チームを識別できる参照ウェブページの URL（チームの Wikipedia ページなど）。
homeTeam.athlete Person チームの個々のアスリートに関する注釈。
homeTeam.athlete.name テキスト アスリートのフルネーム。
homeTeam.parentOrganization SportsOrganization 必須 - チームが所属するスポーツリーグまたは統括組織。両方のチームが指定されている場合は、homeTeam と awayTeam の両方に parentOrganization を含めます。
homeTeam.parentOrganization.name テキスト 必須 - チームが所属するスポーツリーグの名前。（例: 全米バスケットボール協会、メジャーリーグ ベースボール）。このフィールドはチームの会議には使用しないでください。
homeTeam.parentOrganization.sameAs URL 強く推奨 理由- チームのリーグを特定する Wikipedia ページ（英語版が望ましい）へのリンク（例: https://en.wikipedia.org/wiki/National_Basketball_Association）。プレースホルダ example.com URL は使用しないでください。
awayTeam SportsTeam 強く推奨 理由- イベントのアウェイチーム。プロパティと要件（parentOrganization を含む）は 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 該当する場合は必須 - スポーツ イベントを再生するためのディープリンク。チャンネルなしのライブ配信とビデオ オンデマンドのリプレイの両方に使用されます。スポーツ イベントのディープリンクはすべて SportsEvent.potentialAction に配置する必要があります。SportsEvent を参照する BroadcastEvent に potentialAction を配置しないでください（イベントのディープリンクが直接設定されていない地上波 TV チャンネルの放送の場合は、BroadcastService.potentialAction にチャンネルのディープリンクを指定します）。複数のストリーム（地域、ホームまたはアウェイのフィード、多言語放送など）を提供する場合や、ライブとビデオ オンデマンドのリプレイ ウィンドウを分ける場合は、WatchAction オブジェクトの配列を指定します。
potentialAction.actionAccessibilityRequirement ActionAccessSpecification potentialAction が指定されている場合は必須 - 各 WatchAction の利用資格とクリック可能な配信期間（availabilityStarts と availabilityEnds）を定義します。
  • プレロール ウィンドウ（availabilityStarts）: スポーツのライブ配信の場合、SportsEvent.startDate（availabilityStarts <= SportsEvent.startDate - 14 days）の 14 日前までに availabilityStarts を設定して、今後のイベントのタイルが事前に表示されるようにします（availabilityStarts のタイムスタンプが startDate の 14 日前までであれば、イベント エンティティ自体は試合日に近いタイミングで配信できます）。
  • 延長バッファ（availabilityEnds）: SportsEvent.endDate の後に availabilityEnds を設定します。その際、2 ～ 3 時間のバッファ（availabilityEnds >= SportsEvent.endDate + 2 to 3 hours、またはビデオ オンデマンドのリプレイ ウィンドウの終了まで）を設けて、ライブの延長戦や試合後の報道中にディープリンクが期限切れにならないようにします。
詳しくは、アクション マークアップのプロパティをご覧ください。
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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

個人競技の例

{
  "@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",
  "endDate": "2019-07-12T23:30-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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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"
            ]
          }
        ]
      }
    }
  ]
}
このようなコンテンツをお持ちで、試してみたい場合は、media-actions-support+watch@google.com までお問い合わせください。

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 つの言語 / 地域（言語と国の組み合わせ）につき 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"
  }
}
このようなコンテンツをお持ちで、試してみたい場合は、media-actions-support+watch@google.com までお問い合わせください。

イベントの仕様表

プロパティ タイプ 説明
@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 つの言語 / 地域（言語と国の組み合わせ）につき 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"
  }
}