In diesem Abschnitt werden die Details der Content-Markup-Eigenschaften für den zugehörigen Entitätstyp Event beschrieben.
Tabelle mit Spezifikationen für „SportsEvent“
| Attribut | Erwarteter Typ | Beschreibung |
|---|---|---|
@context |
Text | Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
|
@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:
url-Property für SportsEvent oder BroadcastEvent an. Stelle Wiedergabelinks mit SportsEvent.potentialAction bereit. Weitere Informationen finden Sie im Abschnitt Kennung. |
name |
Text | Erforderlich: Der Name dieses Ereignisses.
|
description |
Text | Die Beschreibung dieses Ereignisses. Begrenzt auf 300 Zeichen. Verwenden Sie ein Array, um Beschreibungen in mehreren Sprachen (eine pro Sprache) einzufügen. |
sport |
URL | Erforderlich Ein Link zur Wikipedia-Seite der Sportart (englische Version bevorzugt). |
startDate |
DateTime oder Date | Erforderlich: Der Beginn des Ereignisses im ISO 8601-Format mit Zeitzone. Dies ist die tatsächliche Startzeit des Events, nicht die Zeit, zu der es im Fernsehen ausgestrahlt wird. |
endDate |
DateTime oder Date | Empfohlen: Das geplante Ende der Veranstaltung im ISO 8601-Format mit Zeitzone. Gib das geplante Ende an, sofern bekannt. Wenn das Ende nicht bekannt ist, lass diese Property weg, anstatt einen geschätzten Platzhalter anzugeben. |
homeTeam |
SportsTeam | Sehr empfehlenswert Warum? Die Heimmannschaft des Events. |
homeTeam.name |
Text | Erforderlich. Der vollständige Name des Sportteams. |
homeTeam.sport |
URL | Erforderlich Ein Link zur Wikipedia-Seite (englische Version bevorzugt) 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 | Anmerkung(en) für einen einzelnen Athleten im Team. |
homeTeam.athlete.name |
Text | Der vollständige Name des Athleten. |
homeTeam.parentOrganization |
SportsOrganization | Erforderlich: Die Sportliga oder der Dachverband, zu der bzw. dem das Team gehört. Füge parentOrganization sowohl zu homeTeam als auch zu awayTeam hinzu, wenn beide Teams angegeben sind. |
homeTeam.parentOrganization.name |
Text | Erforderlich: Der Name der Sportliga, zu der das Team gehört. Beispiel: 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? – Einen Link zur Wikipedia-Seite (bevorzugt englische Version), auf der die Liga des Teams angegeben ist (z. B. https://en.wikipedia.org/wiki/National_Basketball_Association). Verwende keine Platzhalter-URLs (example.com). |
awayTeam |
SportsTeam | Sehr empfehlenswert Warum? - Das Auswärtsteam des Events. Die Properties und Anforderungen (einschließlich parentOrganization) sind dieselben wie für SportsEvent.homeTeam. |
competitor |
SportsTeam oder Person | Sehr empfehlenswert Warum? Wenn die Heim- oder Auswärtsmannschaft nicht zutreffend ist (z.B. bei einem Boxkampf oder den Olympischen Spielen), geben Sie die Teilnehmer als Mitbewerber an. Wenn SportsTeam, sind die Attribute mit SportsEvent.homeTeam identisch. Wenn Person, sind die Attribute mit denen anderer Person-Objekte identisch, z. B. ein Schauspieler in Movie. |
location |
Ort ODER Stadt | Der Veranstaltungsort. |
location.name |
Text | Erforderlich: Der Name des Orts. |
location.address |
PostalAddress | Erforderlich, wenn der @type des Standorts „Place“ ist: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn der @type des Standorts „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 wird das offizielle Poster oder Banner für die Veranstaltung. Weitere Informationen zu den erforderlichen und optionalen Properties für image findest du unter Bild-Properties. |
potentialAction |
WatchAction | Erforderlich, falls zutreffend: Deeplink(s) zum Abspielen des Sportereignisses, die sowohl für Livestreams ohne Kanal als auch für Video-on-Demand-Wiederholungen verwendet werden. Alle Deeplinks zu Sportveranstaltungen müssen sich auf SportsEvent.potentialAction befinden. Platziere potentialAction niemals auf einem BroadcastEvent, der auf einen SportsEvent verweist. Gib für Sendungen im linearen Fernsehen ohne direkten Deeplink zur Veranstaltung den Deeplink zum Kanal auf BroadcastService.potentialAction an. Gib ein Array von WatchAction-Objekten an, wenn du mehrere Streams (z. B. regionale, Heim- oder Auswärtsfeeds oder mehrsprachige Übertragungen) oder separate Live- und Video-on-Demand-Wiederholungsfenster anbietest. |
potentialAction.actionAccessibilityRequirement |
ActionAccessSpecification | Erforderlich, wenn potentialAction angegeben ist: Definiert die Berechtigung und den Verfügbarkeitszeitraum (availabilityStarts und availabilityEnds) für jede WatchAction:
|
identifier |
PropertyValue | Sehr empfehlenswert Warum? – Externe oder andere ID, die diese Entität eindeutig identifiziert. Mehrere Kennungen sind zulässig. Weitere Informationen finden Sie im Abschnitt ID-Attribute. |
SportsEvent-Beispiele
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": "es",
"@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
}
],
"startDate": "2019-09-16T21:10-08:00",
"endDate": "2019-09-17T00:00-08:00",
"homeTeam": {
"@type": "SportsTeam",
"name": "Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "John Doe"
}
]
},
"awayTeam": {
"@type": "SportsTeam",
"name": "Team A",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"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": "EP000194303282"
}
]
}
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",
"endDate": "2019-07-12T23:30-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": "es",
"@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
}
],
"startDate": "2019-09-16T21:10-08:00",
"endDate": "2019-09-17T00:00-08:00",
"homeTeam": {
"@type": "SportsTeam",
"name": "Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "John Doe"
}
]
},
"awayTeam": {
"@type": "SportsTeam",
"name": "Team A",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"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": "EP000194303282"
}
],
"potentialAction": [
{
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
"availabilityEnds": "2019-09-17T11:00:00Z",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
{
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
"inLanguage": "en",
"actionPlatform": "http://schema.org/AndroidTVPlatform"
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2019-09-01T10:35:29Z",
"availabilityEnds": "2019-09-17T11:00:00Z",
"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"
]
}
]
}
}
]
}
Tabelle mit Spezifikationen für MusicEvent
| Attribut | Erwarteter Typ | Beschreibung |
|---|---|---|
@context |
Text | Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
|
@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:
url einer Entität alle Anforderungen an eine 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.
|
description |
Text | Beschreibung des Termins. Maximal 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen einzufügen. |
attendee |
Organization oder Person | Eine Person oder Organisation, die an der Veranstaltung teilnimmt. |
startDate |
Datum | Erforderlich: Der Beginn des Ereignisses im ISO 8601-Format mit Zeitzone. |
endDate |
Datum | Die Endzeit des Ereignisses im ISO 8601-Format mit Zeitzone. |
composer |
Organization oder Person | Die Person oder Organisation, die eine Komposition geschrieben hat, oder der Komponist eines Werks, das bei einer Veranstaltung aufgeführt wird. |
performer |
Organization oder Person | Erforderlich: Ein Mitwirkender bei der Veranstaltung, z. B. ein Vortragender, ein Musiker, eine Musikgruppe oder ein Schauspieler. |
subEvent |
Ereignis | Ein Ereignis, das Teil dieses Ereignisses ist. Beispiel: Eine Konferenz umfasst viele Präsentationen, die jeweils ein „subEvent“ der Konferenz sind. |
superEvent |
Ereignis | Eine Veranstaltung, zu der diese Veranstaltung gehört. Beispielsweise kann eine Sammlung einzelner Musikauftritte jeweils ein Musikfestival als „superEvent“ haben. |
location |
Ort ODER Stadt | Erforderlich: Der Veranstaltungsort. |
location.name |
Text | Erforderlich: Der Name des Orts. |
location.address |
PostalAddress | Erforderlich, wenn der @type des Standorts „Place“ ist: Die Adresse des Standorts. Dieses Feld sollte nicht verwendet werden, wenn der @type des Standorts „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 | Ein Werk, das bei einer Veranstaltung aufgeführt wird, z. B. ein Theaterstü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 Ereignisspezifikationen
| Attribut | Erwarteter Typ | Beschreibung |
|---|---|---|
@context |
Text | Erforderlich – immer auf ["http://schema.org", {"@language": "xx"}]
|
@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:
url einer Entität alle Anforderungen an eine 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.
|
description |
Text | Beschreibung des Termins. Maximal 300 Zeichen. Verwenden Sie ein Array, um die Beschreibungen in mehreren Sprachen und Längen einzufügen. |
attendee |
Organization oder Person | Eine Person oder Organisation, die an der Veranstaltung teilnimmt. |
startDate |
Datum | Erforderlich: Der Beginn des Ereignisses 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. Beispiel: Eine Konferenz umfasst viele Präsentationen, die jeweils ein „subEvent“ der Konferenz sind. |
superEvent |
Ereignis | Eine Veranstaltung, zu der diese Veranstaltung gehört. Beispielsweise kann eine Sammlung einzelner Musikauftritte 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 Datum der Kinoveröffentlichung eines Films.Verwende außerdem FeaturedEvent, um anzugeben, dass dein Dienst diese Inhalte als Original, empfohlen, speziell usw. vermarktet.ExclusiveEvent gibt an, dass dein Dienst exklusive Vertriebsrechte hat, und enthält Informationen dazu, wo und wann.Weitere Informationen und Beispiele findest du im Abschnitt „Beispiele“. |
releasedEvent.@type |
Text | Erforderlich: Dieses Attribut muss immer auf einen der folgenden Werte festgelegt werden:
|
releasedEvent.location |
Land | Erforderlich: Die Regionen, die mit diesem Ereignis verknüpft sind. Bei PublicationEvent ist dies die Region, in der der Inhalt veröffentlicht wurde.Bei FeaturedEvent und ExclusiveEvent ist dies die Region, in der der Inhalt vorgestellt wird oder exklusiv ist.Verwenden Sie ISO 3166-Codes für Länder. Wenn Sie alle Bereiche weltweit einbeziehen möchten, legen Sie EARTH fest. |
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 dieser Entität, z. B. das Datum, an dem ein Film zum ersten Mal im Kino gezeigt wurde.Bei ExclusiveEvent und FeaturedEvent ist dies das Startdatum, ab dem die Entität exklusiv oder vorgestellt ist. |
releasedEvent.endDate |
Date oder DateTime | Empfohlen – Erforderlich für ExclusiveEvent – Dies gilt nur für die Typen ExclusiveEvent und FeaturedEvent.Bei ExclusiveEvent ist dies das Datum, an dem die Rechte am Inhalt ablaufen.Bei FeaturedEvent ist dies das letzte Datum, an dem der Anbieter die Entität präsentiert.Wenn der Inhalt dauerhaft exklusiv oder präsentiert ist, legen Sie für endDate ein Datum fest, das 20 Jahre nach dem aktuellen Datum liegt. |
releasedEvent.publishedBy |
Organization oder Person | Optional: Die Organisation oder Person, die diese Entität veröffentlicht hat. |
location |
Ort ODER Stadt | Erforderlich: Der Veranstaltungsort. Place kann auf der City-Ebene angegeben werden. |
location.name |
Text | Erforderlich: Der Name des Orts. |
location.address |
PostalAddress | Erforderlich, wenn der @type des Standorts „Place“ ist: Die Adresse des Standorts. Sollte nicht verwendet werden, wenn der @type des Standorts „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 | Ein Werk, das bei einer Veranstaltung aufgeführt wird, z. B. ein Theaterstück, das bei einem TheaterEvent aufgeführt wird. |
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"
}
}