このページは Cloud Translation API によって翻訳されました。

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

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

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

SportsEvent の仕様表

SportsEvent の例

団体競技の例

個人競技の例

GeoShape 制限のある SportsEvent

MusicEvent の仕様表

MusicEvent の例

MusicEvent

イベントの仕様表

イベントの例

イベント

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