Inhalts-Markup-Eigenschaften von Ereignissen

In diesem Abschnitt finden Sie Details zu den Content-Markup-Properties für den Event-bezogenen Entitätstyp.

Tabelle mit Spezifikationen für Sportereignisse

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP 47-Format, z. B. „en“.
@type Text Erforderlich: Muss immer auf SportsEvent gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Statisch: Die ID muss immer gleich bleiben und darf sich im Laufe der Zeit nicht ändern, auch wenn sich die URL-Eigenschaft der Sendung ändert. Sie wird als opaker String behandelt und muss kein funktionierender Link sein.
  • In Form eines Uniform Resource Identifiers (URI)
  • Die für den @id-Wert verwendete Domain 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: Der Name dieses Ereignisses.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe Beispiel Mehrere Regionen und Sprachen.
  • Pro Sprache und Land wird nur ein Name unterstützt.
description Text Die Beschreibung dieses Ereignisses. Maximal 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 englischsprachig) der Sportart.
startDate DateTime oder Datum Erforderlich: Die Startzeit der Veranstaltung im ISO 8601-Format mit Zeitzone. Hinweis: Dies ist die tatsächliche Startzeit der Veranstaltung, nicht die Ausstrahlungszeit im Fernsehen.
endDate DateTime oder Datum Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
homeTeam SportsTeam Empfohlen Warum? Die Heimmannschaft der Veranstaltung.
homeTeam.name Text Erforderlich: Der vollständige Name des Sportteams.
homeTeam.sport URL Erforderlich: Ein Link zur Wikipedia-Seite (vorzugsweise englischsprachig) der Sportart.
homeTeam.sameAs URL Empfohlen Warum? Eine URL zu einer Referenzwebseite, über die das Team identifiziert werden kann, z. B. die Wikipedia-Seite des Teams.
homeTeam.athlete Person Anmerkungen zu einem einzelnen Athleten im Team.
homeTeam.athlete.name Text Der vollständige Name des Athleten.
homeTeam.parentOrganization.name SportsOrganization Erforderlich: Der Name der Sportliga, zu der das Team gehört. Beispiele: National Basketball Association oder Major League Baseball. Dieses Feld sollte nicht für die Konferenz des Teams verwendet werden.
homeTeam.parentOrganization.sameAs URL Empfohlen Warum? Die URL einer Referenzwebseite, auf der die Liga des Teams angegeben ist, z. B. die Wikipedia-Seite der Liga.
awayTeam SportsTeam Empfohlen Warum? Das Auswärtsteam der Veranstaltung. Die Eigenschaften sind mit SportsEvent.homeTeam identisch.
competitor SportsTeam oder Person Empfohlen Warum? Wenn das Heim- oder Auswärtsteam nicht zutrifft (z.B. bei einem Boxkampf oder bei den Olympischen Spielen), gib die Teilnehmer als Mitbewerber an. Bei SportsTeam sind die Properties mit SportsEvent.homeTeam identisch. Bei Person sind die Properties mit denen anderer Person-Objekte identisch, z. B. bei einem Schauspieler in Movie.
location Ort ODER Ortsname Der Veranstaltungsort.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn der @type des Standorts „Place“ ist: Die Adresse des Standorts. Dieser Wert sollte nicht verwendet werden, wenn der @type des Standorts „Stadt“ ist.
location.address.streetAddress Text Die Adresse des Standorts.
location.address.addressLocality Text Die Stadt des Standorts.
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 Für Google TV erforderlich: Die Bilder, die sich auf das Ereignis beziehen. Empfohlen wird das offizielle Poster oder Banner der Veranstaltung. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie in image einschließen sollten, finden Sie unter Bild-Properties.
potentialAction WatchAction Falls zutreffend erforderlich: Der Deeplink, über den die Aufzeichnung dieses Sportereignisses auf Video on Demand wiedergegeben wird. Wenn Sie den Deeplink für ein Live-Ereignis angeben möchten, verwenden Sie stattdessen die Property publishedOn oder potentialAction in BroadcastEvent.
identifier PropertyValue Empfohlen Warum? – Externe oder sonstige ID, durch die diese Entität eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt ID-Attribute.

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

Tabelle mit Spezifikationen für MusicEvent

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP 47-Format, z. B. „en“.
@type Text Erforderlich: Muss immer auf MusicEvent gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Statisch
  • In Form eines Uniform Resource Identifiers (URI)
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: Der Name dieses Ereignisses.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe Beispiel Mehrere Regionen und Sprachen.
  • Pro Sprache und Land wird nur ein Name unterstützt.
description Text Die Beschreibung des Ereignisses. Maximal 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
attendee Organisation 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 Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
composer Organisation oder Person Die Person oder Organisation, die eine Komposition verfasst hat oder der Komponist eines Werks ist, das bei einer Veranstaltung aufgeführt wird.
performer Organisation oder Person Erforderlich: Ein Darsteller bei der Veranstaltung, z. B. ein Moderator, Musiker, eine Musikgruppe oder ein Schauspieler.
subEvent Ereignis Ein Ereignis, das Teil dieses Ereignisses ist. Ein Konferenz-Ereignis umfasst beispielsweise viele Präsentationen, von denen jede ein untergeordnetes Ereignis der Konferenz ist.
superEvent Ereignis Ein Ereignis, zu dem dieses Ereignis gehört. Beispielsweise kann eine Sammlung einzelner Musikdarbietungen jeweils ein Musikfestival als Super-Ereignis haben.
location Ort ODER Ortsname Erforderlich: Der Ort der Veranstaltung.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn der @type des Standorts „Place“ ist: Die Adresse des Standorts. Dieser Wert sollte nicht verwendet werden, wenn der @type des Standorts „Ort“ ist.
location.address.streetAddress Text Die Adresse des Standorts.
location.address.addressLocality Text Die Stadt des Standorts.
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 Ereignis aufgeführt wird, z. B. ein Theaterstück bei einem Theaterereignis.

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

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Muss immer auf ["http://schema.org", {"@language": "xx"}]
gesetzt sein.
  • Ersetzen Sie xx durch den Sprachcode der Entität im BCP 47-Format, z. B. „en“.
@type Text Erforderlich: Muss immer auf Event gesetzt sein.
@id URL Erforderlich: Die Kennung des Inhalts im URI-Format, z. B. https://example.com/1234abc.
@id muss die folgenden Anforderungen erfüllen:
  • Sie muss in Ihrem gesamten Katalog eindeutig sein.
  • Statisch
  • In Form eines Uniform Resource Identifiers (URI)
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: Der Name dieses Ereignisses.
  • Verwenden Sie ein Array, um die Namen in verschiedenen Sprachen aufzulisten. Siehe Beispiel Mehrere Regionen und Sprachen.
  • Pro Sprache und Land wird nur ein Name unterstützt.
description Text Die Beschreibung des Ereignisses. Maximal 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen anzugeben.
attendee Organisation 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 Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone.
subEvent Ereignis Ein Ereignis, das Teil dieses Ereignisses ist. Ein Konferenz-Ereignis umfasst beispielsweise viele Präsentationen, von denen jede ein untergeordnetes Ereignis der Konferenz ist.
superEvent Ereignis Ein Ereignis, zu dem dieses Ereignis gehört. Beispielsweise kann eine Sammlung einzelner Musikdarbietungen jeweils ein Musikfestival als Super-Ereignis haben.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Empfohlen Warum? – Mit PublicationEvent wird die ursprüngliche (globale oder lokale) Veröffentlichung von Inhalten durch einen Verlag oder Webpublisher angegeben, z. B. das ursprüngliche Kinostartdatum eines Films.

Verwende außerdem FeaturedEvent, um anzugeben, dass dein Dienst diese Inhalte als Original, als empfohlen, als Sonderangebot usw. bewirbt.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben zu Ort und Zeitpunkt.

Details und Beispiele findest du im Beispielbereich.
releasedEvent.@type Text Erforderlich: Diese Eigenschaft muss immer auf eine der folgenden Optionen festgelegt werden:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die Regionen, die mit diesem Ereignis verknüpft sind.

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

Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der die Inhalte präsentiert oder exklusiv verfügbar sind.

Verwende ISO 3166-Codes für Länder. Wenn Sie alle Regionen der Welt einbeziehen möchten, geben Sie EARTH ein.
releasedEvent.startDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einer PublicationEvent gibt dies das Datum der Erstveröffentlichung dieser Entität an, z. B. das Datum, an dem ein Film erstmals in den Kinos gezeigt wurde.

Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder als „Empfohlen“ gekennzeichnet ist.
releasedEvent.endDate Datum oder DateTime Empfohlen – Erforderlich für ExclusiveEvent – Diese Angabe 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 das Rechtssubjekt präsentiert.

Wenn die Inhalte zeitlich unbegrenzt exklusiv oder vorgestellt werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organisation oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
location Ort ODER Ortsname Erforderlich: Der Ort der Veranstaltung. Sie können Place auf City-Ebene angeben.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn der @type des Standorts „Place“ ist: Die Adresse des Standorts. Dieser Wert sollte nicht verwendet werden, wenn der @type des Standorts „Ort“ ist.
location.address.streetAddress Text Die Adresse des Standorts.
location.address.addressLocality Text Die Stadt des Standorts.
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 Ereignis aufgeführt wird, z. B. ein Theaterstück bei einem Theaterereignis.

Beispiel für ein Ereignis

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