Inhalts-Markup-Eigenschaften von Ereignissen

In diesem Abschnitt finden Sie die Details der Eigenschaften für die Inhaltsauszeichnung für den zugehörigen Entitätstyp Event.

Spezifikationstabelle für SportsEvent

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Ersetzen Sie xx durch den Sprachcode der Einheit 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:
  • Global eindeutig in Ihrem Katalog
  • 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 Unified Resource Identifier (URI)
  • Die für den @id-Wert verwendete Domain muss Ihrer Organisation gehören.
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Der Name dieses Ereignisses.
description Text Die Beschreibung dieses Ereignisses. Max. 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 in englischer Sprache) der Sportart.
startDate DateTime oder Date Erforderlich: Die Startzeit des Ereignisses im ISO 8601-Format mit Zeitzone. Bitte beachten Sie, dass es sich hierbei um die tatsächliche Startzeit der Veranstaltung handelt und nicht um die Zeit, zu der die Veranstaltung im Fernsehen ausgestrahlt wird.
endDate DateTime oder Date Die Endzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
homeTeam SportsTeam Sehr empfehlenswert Warum? Die Heimmannschaft des Ereignisses.
homeTeam.name Text Erforderlich: Der vollständige Name der Sportmannschaft.
homeTeam.sport URL Erforderlich: Ein Link zur Wikipedia-Seite (vorzugsweise in englischer Sprache) der Sportart.
homeTeam.sameAs URL Sehr empfehlenswert Warum? Eine URL zu einer Referenzwebseite, auf der das Team identifiziert werden kann, z. B. die Wikipedia-Seite des Teams.
homeTeam.athlete Person Anmerkungen für einen 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 Sehr empfehlenswert Warum? Eine URL zu einer Referenzwebseite, auf der die Liga des Teams angegeben ist, z. B. die Wikipedia-Seite der Liga.
awayTeam SportsTeam Sehr empfehlenswert Warum? Die Gastmannschaft des Ereignisses. Die Eigenschaften sind dieselben wie bei SportsEvent.homeTeam.
competitor SportsTeam oder Person Sehr empfehlenswert Warum? Wenn das Heim- oder Auswärtsteam nicht zutrifft (z.B. bei einem Boxkampf oder den Olympischen Spielen), geben Sie die Teilnehmer als Gegner an. Bei SportsTeam sind die Attribute dieselben wie bei SportsEvent.homeTeam. Wenn Person, sind die Attribute dieselben wie bei anderen Person-Objekten, z. B. einem Schauspieler in Movie.
location Ort ODER Stadt Der Veranstaltungsort.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn @type des Standorts „Place“ ist: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn der Standorttyp „City“ 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 Erforderlich für Google TV: Die Bilder, die sich auf das Ereignis beziehen. Empfohlen als offizielles Poster oder Banner für die Veranstaltung. Weitere Informationen zu den erforderlichen und optionalen Properties, die Sie mit image einfügen müssen, finden Sie unter Bild-Properties.
potentialAction WatchAction Erforderlich, falls zutreffend: Der Deeplink, über den die Aufzeichnung dieses Sportereignisses als Video-on-Demand wiedergegeben wird. Wenn Sie den Deeplink für ein Live-Event angeben möchten, verwenden Sie stattdessen die Property publishedOn oder potentialAction in BroadcastEvent.
identifier PropertyValue Sehr empfehlenswert Warum? – Externe oder sonstige ID, durch die diese Einheit eindeutig identifiziert wird. Es sind mehrere IDs zulässig. Weitere Informationen finden Sie im Abschnitt Kennzeichnereigenschaften.

Beispiele für SportsEvent

Beispiel für Mannschaftssport 

{
  "@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 für Einzelsportarten 

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

SportsEvent mit GeoShape-Einschränkungen

{
  "@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 – Spezifikationstabelle

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Ersetzen Sie xx durch den Sprachcode der Einheit 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:
  • Global eindeutig in Ihrem Katalog
  • Statisch
  • In Form eines Unified Resource Identifier (URI)
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Der Name dieses Ereignisses.
description Text Die Beschreibung des Ereignisses. Max. 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 des Ereignisses im ISO 8601-Format mit Zeitzone.
endDate Datum Die Endzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
composer Organization oder Person Die Person oder Organisation, die eine Komposition geschrieben hat oder die Komponist eines Werks ist, das bei einer Veranstaltung aufgeführt wird.
performer Organization oder Person Erforderlich: Ein Künstler, der bei der Veranstaltung auftritt, z. B. ein Moderator, ein Musiker, eine Musikgruppe oder ein Schauspieler.
subEvent Ereignis Ein Ereignis, das Teil dieses Ereignisses ist. Eine Konferenz umfasst beispielsweise viele Präsentationen, die jeweils ein untergeordnetes Ereignis der Konferenz sind.
superEvent Ereignis Ein Event, zu dem dieses Event gehört. Beispielsweise kann eine Sammlung einzelner Musikdarbietungen jeweils ein Musikfestival als „superEvent“ haben.
location Ort ODER Stadt Erforderlich: Der Ort des Termins.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn @type des Standorts „Place“ ist: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn der Standorttyp „City“ 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 Eine Arbeit, die bei einer Veranstaltung aufgeführt wird, z. B. ein Theaterstück bei einem TheaterEvent.

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 Ereignisspezifikationen

Attribut Erwarteter Typ Beschreibung
@context Text Erforderlich: Immer auf ["http://schema.org", {"@language": "xx"}]
    gesetzt.
  • Ersetzen Sie xx durch den Sprachcode der Einheit 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:
  • Global eindeutig in Ihrem Katalog
  • Statisch
  • In Form eines Unified Resource Identifier (URI)
Da die url einer Einheit alle Anforderungen als Kennung erfüllt, empfehlen wir, die url einer Einheit als @id zu verwenden. Weitere Informationen finden Sie im Abschnitt Kennung.
name Text Erforderlich: Der Name dieses Ereignisses.
description Text Die Beschreibung des Ereignisses. Max. 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 des Ereignisses im ISO 8601-Format mit Zeitzone.
endDate Datum Die Endzeit der Veranstaltung im ISO 8601-Format mit Zeitzone.
subEvent Ereignis Ein Ereignis, das Teil dieses Ereignisses ist. Eine Konferenz umfasst beispielsweise viele Präsentationen, die jeweils ein untergeordnetes Ereignis der Konferenz sind.
superEvent Ereignis Ein Event, zu dem dieses Event gehört. Beispielsweise kann eine Sammlung einzelner Musikdarbietungen jeweils ein Musikfestival als „superEvent“ haben.
releasedEvent PublicationEvent, FeaturedEvent oder ExclusiveEvent Sehr empfehlenswert 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, Featured, Special usw. vermarktet.

ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Angaben dazu, wo und wann.

Weitere Informationen und Beispiele findest du im Beispielabschnitt.
releasedEvent.@type Text Erforderlich: Setzen Sie diese Eigenschaft immer auf einen der folgenden Werte:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Land Erforderlich: Die Regionen, die mit diesem Event 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 werden oder exklusiv verfügbar sind.

Verwenden Sie ISO 3166-Codes für Länder. Legen Sie EARTH fest, um alle Orte weltweit anzugeben.
releasedEvent.startDate Date oder DateTime Empfohlen – Erforderlich für ExclusiveEvent: Das Startdatum der Veröffentlichung der Entität.

Bei einem PublicationEvent ist dies das ursprüngliche Veröffentlichungsdatum der Entität, z. B. das Datum, an dem ein Film zum ersten Mal in Kinos veröffentlicht wurde.

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

Für ExclusiveEvent steht dies für das Datum, an dem die Rechte an den Inhalten ablaufen.

Für FeaturedEvent steht dies für das letzte Datum, an dem der Anbieter die Entität präsentiert.

Wenn die Inhalte dauerhaft exklusiv sind oder präsentiert werden, legen Sie endDate auf 20 Jahre ab dem aktuellen Datum fest.
releasedEvent.publishedBy Organization oder Person Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat.
location Ort ODER Stadt Erforderlich: Der Ort des Termins. Place kann auf der City-Ebene angegeben werden.
location.name Text Erforderlich: Der Name des Standorts.
location.address PostalAddress Erforderlich, wenn @type des Standorts „Place“ ist: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn der Standorttyp „City“ 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 Eine Arbeit, die bei einer Veranstaltung aufgeführt wird, z. B. ein Theaterstück bei einem TheaterEvent.

Beispiel für ein Ereignis

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