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

このセクションでは、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 の例

例 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 の仕様は初期テスト段階です。このようなコンテンツをお持ちで、試してみたい場合は、[e-mail] までお問い合わせください。

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

重要: イベントの仕様は初期テスト段階です。このようなコンテンツをお持ちで、試してみたい場合は、[e-mail] までお問い合わせください。

イベントの仕様表

プロパティ	タイプ	説明
@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"
  }
}