Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

このセクションでは、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	必須: スポーツの 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.name`	SportsOrganization	必須 - チームが所属するスポーツリーグの名前。たとえば、National Basketball Association や Major League Baseball などです。このフィールドはチームの会議には使用しないでください。
`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	ロケーションの @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	ロケーションの @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`	場所または都市	必須 - イベントの場所。`City` レベルで `Place` を指定できることに注意してください。
`location.name`	テキスト	必須 - ロケーションの名前。
`location.address`	PostalAddress	ロケーションの @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"
  }
}

イベントのコンテンツ マークアップ プロパティ コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

SportsEvent の仕様表

SportsEvent の例

団体競技の例

個人競技の例

GeoShape の制限がある SportsEvent

MusicEvent の仕様表

MusicEvent の例

MusicEvent

イベントの仕様表

イベントの例

イベント

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