Inhalts-Markup-Eigenschaften von Ereignissen

Dieser Abschnitt enthält Details zu den Eigenschaften des Inhalts-Markups für den Entitätstyp „Event“.

Tabelle mit SportsEvent-Spezifikation

Property Erwarteter Typ Beschreibung
@context Text Erforderlich: immer auf ["http://schema.org", {"@language": "xx"}]
festgelegt.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP-47-Format, z. B. „en“.
@type Text Erforderlich: Immer auf SportsEvent festgelegt.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Einzigartig in deinem Katalog
  • Statisch. Die ID muss stabil sein und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Er wird als opaker String behandelt und muss kein funktionierender Link sein.
  • in Form eines URI (Unified Resource Identifier)
  • Die Domain, die für den Wert „@id“ verwendet wird, muss Ihrer Organisation gehören.
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Name dieses Ereignisses.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Sehen Sie sich dazu das Beispiel Mehrere Regionen und Sprachen an.
  • Pro Sprache wird nur ein Name unterstützt (Sprach-Land-Paar).
description Text Die Beschreibung dieses Ereignisses. Limist mit 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
sport URL Erforderlich ein Link zur Wikipedia-Seite (vorzugsweise auf Englisch) der Sportart.
startDate DateTime oder Date Erforderlich: Die Startzeit der Veranstaltung im ISO 8601-Format mit Zeitzone. Bitte beachte, dass dies der tatsächliche Beginn der Veranstaltung ist und nicht der Zeitpunkt, an dem sie im Fernsehen ausgestrahlt wurde.
endDate DateTime oder Date Das Ende des Ereignisses im ISO 8601-Format mit Zeitzone.
homeTeam SportsTeam Dringend empfohlen Warum? Die Heimmannschaft der Veranstaltung.
homeTeam.name Text Erforderlich. Der vollständige Name der Sportmannschaft.
homeTeam.sport URL Erforderlich ein Link zur Wikipedia-Seite (vorzugsweise auf Englisch) der Sportart.
homeTeam.sameAs URL Dringend empfohlen Warum? Eine URL zu einer Referenzwebseite, auf der das Team identifiziert werden kann, z. B. die Wikipedia-Seite des Teams.
homeTeam.athlete Person Anmerkung(en) zu einem einzelnen Sportler im Team.
homeTeam.athlete.name Text Der vollständige Name des Athleten.
homeTeam.parentOrganization.name SportsOrganization Erforderlich. Der Name der Sportliga, zu der die Mannschaft gehört. Zum Beispiel „National Basketball Association“ oder „Major League Baseball“. Beachten Sie, dass dieses Feld nicht für die Konferenz des Teams verwendet werden sollte.
homeTeam.parentOrganization.sameAs URL Dringend empfohlen Warum? Eine URL zu einer Referenzwebseite, auf der die Liga der Mannschaft genannt wird, z. B. die Wikipedia-Seite der Liga.
awayTeam SportsTeam Dringend empfohlen Warum? Das Außenteam des Ereignisses. Die Attribute sind mit SportsEvent.homeTeam identisch.
competitor SportsTeam oder Person Dringend empfohlen Warum? Wenn die Heim- oder Auswärtsmannschaft nicht anwendbar ist (z.B. bei einem Boxkampf, bei den Olympischen Spielen), geben Sie die Teilnehmer als Teilnehmer an. Bei SportsTeam sind die Attribute mit SportsEvent.homeTeam identisch. Bei Person sind die Attribute mit anderen Person-Objekten identisch, z. B. ein Akteur in Movie.
location Ort ODER Stadt Der Veranstaltungsort.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn location @type ist Place: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn „location @type“ den Wert „City“ hat
location.address.streetAddress Text Die Adresse des Standorts.
location.address.addressLocality Text Die Stadt des Orts.
location.address.addressRegion Text Der Status des Standorts.
location.address.postalCode Text Die Postleitzahl des Standorts.
location.address.addressCountry Text Die Länder im ISO 3166-Format.
image ImageObject Erforderlich für Google TV: Bilder, die sich auf die Veranstaltung beziehen. Empfohlen als offizielles Poster oder Bannergrafik für die Veranstaltung. Weitere Informationen zu den erforderlichen und optionalen Eigenschaften für image finden Sie unter Bildeigenschaften.
potentialAction WatchAction Erforderlich, sofern zutreffend: Der Deeplink, über den die Aufzeichnung dieser Sportveranstaltung bei Video-on-Demand wiedergegeben wird. Wenn du den Deeplink für eine Live-Veranstaltung angeben möchtest, verwende stattdessen die Property publishedOn oder potentialAction in BroadcastEvent.
identifier PropertyValue Dringend empfohlen Warum? – Externe oder andere ID, durch die diese Entität eindeutig identifiziert wird Mehrere Kennungen sind zulässig. Weitere Informationen finden Sie im Abschnitt Kennzeichnungseigenschaften.

Beispiele für SportsEvent

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

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

Tabelle mit MusicEvent-Spezifikationen

Property Erwarteter Typ Beschreibung
@context Text Erforderlich: immer auf ["http://schema.org", {"@language": "xx"}]
festgelegt.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP-47-Format, z. B. „en“.
@type Text Erforderlich: Immer auf MusicEvent festgelegt.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Einzigartig in deinem Katalog
  • Statisch
  • in Form eines URI (Unified Resource Identifier)
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Name dieses Ereignisses.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Sehen Sie sich dazu das Beispiel Mehrere Regionen und Sprachen an.
  • Pro Sprache wird nur ein Name unterstützt (Sprach-Land-Paar).
description Text Die Beschreibung des Ereignisses. Limist mit 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
attendee Organization oder Person Eine Person oder Organisation, die an der Veranstaltung teilnimmt.
startDate Datum Erforderlich: Die Startzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
endDate Datum Das Ende des Ereignisses im ISO 8601-Format mit Zeitzone.
composer Organization oder Person Die Person oder Organisation, die eine Komposition geschrieben hat oder Komponist eines Werks ist, das bei einer Veranstaltung aufgeführt wurde.
performer Organization oder Person Erforderlich: Ein Künstler der Veranstaltung, z. B. ein Moderator, ein Musiker, eine Musikgruppe oder ein Schauspieler.
subEvent Veranstaltung Ein Ereignis, das Teil dieses Ereignisses ist. Zum Beispiel umfasst ein Konferenztermin viele Präsentationen, von denen jede ein SubEvent der Konferenz ist.
superEvent Veranstaltung Ein Ereignis, zu dem dieses Ereignis gehört. So könnte beispielsweise für eine Sammlung von einzelnen Musikauftritten jeweils ein Musikfestival als SuperEvent eingerichtet werden.
location Ort ODER Stadt Erforderlich: Der Veranstaltungsort.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn location @type ist Place: Die Adresse des Standorts. Dieser Parameter sollte nicht verwendet werden, wenn der Standort @type den Wert Stadt hat.
location.address.streetAddress Text Die Adresse des Standorts.
location.address.addressLocality Text Die Stadt des Orts.
location.address.addressRegion Text Der Status des Standorts.
location.address.postalCode Text Die Postleitzahl des Standorts.
location.address.addressCountry Text Die Länder im ISO 3166-Format.
workPerformed CreativeWork Ein Werk, das bei einem bestimmten Ereignis aufgeführt wird, z. B. ein Stück, das bei einem TheaterEvent aufgeführt wird.

Beispiel für 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"
  }
}

Tabelle mit Ereignisspezifikation

Property Erwarteter Typ Beschreibung
@context Text Erforderlich: immer auf ["http://schema.org", {"@language": "xx"}]
festgelegt.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP-47-Format, z. B. „en“.
@type Text Erforderlich: Immer auf Event festgelegt.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Einzigartig in deinem Katalog
  • Statisch
  • in Form eines URI (Unified Resource Identifier)
Da die url einer Entität alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Entität als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Name dieses Ereignisses.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Sehen Sie sich dazu das Beispiel Mehrere Regionen und Sprachen an.
  • Pro Sprache wird nur ein Name unterstützt (Sprach-Land-Paar).
description Text Die Beschreibung des Ereignisses. Limist mit 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
attendee Organization oder Person Eine Person oder Organisation, die an der Veranstaltung teilnimmt.
startDate Datum Erforderlich: Die Startzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
endDate Datum Das Ende des Ereignisses im ISO 8601-Format mit Zeitzone.
subEvent Veranstaltung Ein Ereignis, das Teil dieses Ereignisses ist. Zum Beispiel umfasst ein Konferenztermin viele Präsentationen, von denen jede ein SubEvent der Konferenz ist.
superEvent Veranstaltung Ein Ereignis, zu dem dieses Ereignis gehört. So könnte beispielsweise für eine Sammlung von einzelnen Musikauftritten jeweils ein Musikfestival als SuperEvent eingerichtet werden.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Dringend empfohlen Warum? – Eine PublicationEvent wird verwendet, um die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Publisher anzugeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Verwende außerdem FeaturedEvent, um anzugeben, dass dein Dienst diese Inhalte entweder als Original, als angesagte, als oder als besonderes Angebot vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat und wo und wann angegeben wird.

Weitere Informationen und Beispiele findest du im Abschnitt mit Beispielen.
releasedEvent.@type Text Erforderlich: Sie müssen diese Property immer auf einen der folgenden Werte festlegen:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die Regionen, die mit diesem Ereignis verknüpft sind.

Bei PublicationEvent ist dies die Region, in der die Inhalte veröffentlicht wurden.

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte vorgestellt oder exklusiv sind.

Verwenden Sie ISO 3166-Codes für Länder. Um überall auf der Welt anzuzeigen, legen Sie EARTH fest.
releasedEvent.startDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei PublicationEvent bezeichnet das das Datum der ersten Veröffentlichung dieser Entität, z. B. das Datum, an dem der Film erstmals ins Kino ging.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder empfohlen ist.
releasedEvent.endDate Date oder DateTime Empfohlen: Erforderlich für ExclusiveEvent: Gilt nur für die Typen ExclusiveEvent und FeaturedEvent.

Bei ExclusiveEvent ist dies das Datum, an dem die Rechte an den Inhalten ablaufen.

Bei FeaturedEvent ist dies das letzte Datum, an dem der Anbieter die Entität vorstellt.

Wenn die Inhalte dauerhaft ausgeschlossen oder empfohlen werden, lege endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die dieses Element veröffentlicht hat.
location Ort ODER Stadt Erforderlich: Der Veranstaltungsort. Du kannst Place auf City-Ebene angeben.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn location @type ist Place: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn der Standort @type den Wert Stadt hat.
location.address.streetAddress Text Die Adresse des Standorts.
location.address.addressLocality Text Die Stadt des Orts.
location.address.addressRegion Text Der Status des Standorts.
location.address.postalCode Text Die Postleitzahl des Standorts.
location.address.addressCountry Text Die Länder im ISO 3166-Format.
workPerformed CreativeWork Ein Werk, das bei einem bestimmten Ereignis aufgeführt wird, z. B. ein Stück, das bei einem TheaterEvent aufgeführt wird.

Ereignis – Beispiel

Veranstaltung 

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