W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści dla typu powiązanego elementu Event.
Tabela specyfikacji SportsEvent
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ustawiony na ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | Wymagany – zawsze ustawiony na SportsEvent. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie identyfikatora URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url do SportsEvent ani BroadcastEvent. Podaj linki do odtwarzania za pomocą SportsEvent.potentialAction. Więcej informacji znajdziesz w sekcji Identyfikator. |
name |
Text | Wymagane – nazwa wydarzenia.
|
description |
Text | Opis tego zdarzenia. Limit znaków: 300. Użyj tablicy, aby uwzględnić opisy w kilku językach (po jednym na język). |
sport |
Adres URL | Wymagany Link do strony Wikipedii (najlepiej w języku angielskim) dotyczącej danego sportu. |
startDate |
DateTime lub Date | Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 ze strefą czasową. Pamiętaj, że jest to rzeczywisty czas rozpoczęcia wydarzenia, a nie czas jego emisji w telewizji. |
endDate |
DateTime lub Date | Zalecane – zaplanowana godzina zakończenia wydarzenia w formacie ISO 8601 ze strefą czasową. Podaj zaplanowany czas zakończenia, jeśli jest znany. Jeśli czas zakończenia nie jest znany, pomiń tę właściwość, zamiast podawać szacunkową wartość zastępczą. |
homeTeam |
SportsTeam | Zdecydowanie zalecane Dlaczego? Gospodarz wydarzenia. |
homeTeam.name |
Text | Wymagane Pełna nazwa drużyny sportowej. |
homeTeam.sport |
Adres URL | Wymagany Link do strony Wikipedii (najlepiej w języku angielskim) dotyczącej danego sportu. |
homeTeam.sameAs |
Adres URL | Zdecydowanie zalecane Dlaczego? Adres URL referencyjnej strony internetowej, która może identyfikować drużynę, np. strona drużyny w Wikipedii. |
homeTeam.athlete |
Person | Adnotacje dotyczące poszczególnych sportowców w drużynie. |
homeTeam.athlete.name |
Text | Imię i nazwisko sportowca. |
homeTeam.parentOrganization |
SportsOrganization | Wymagane – liga sportowa lub organizacja zarządzająca, do której należy drużyna. Jeśli podane są obie drużyny, uwzględnij parentOrganization zarówno w homeTeam, jak i awayTeam. |
homeTeam.parentOrganization.name |
Text | Wymagany – nazwa ligi sportowej, do której należy drużyna. Na przykład National Basketball Association lub Major League Baseball. Pamiętaj, że tego pola nie należy używać w przypadku konferencji zespołu. |
homeTeam.parentOrganization.sameAs |
Adres URL | Zdecydowanie zalecane Dlaczego? – link do strony w Wikipedii (najlepiej w języku angielskim), która identyfikuje ligę drużyny (np. https://en.wikipedia.org/wiki/National_Basketball_Association). Nie używaj adresów URL z obiektem zastępczym example.com. |
awayTeam |
SportsTeam | Zdecydowanie zalecane Dlaczego? – drużyna gości, Właściwości i wymagania (w tym parentOrganization) są takie same jak w przypadku SportsEvent.homeTeam. |
competitor |
SportsTeam lub Person | Zdecydowanie zalecane Dlaczego? Jeśli drużyna gospodarzy lub gości nie dotyczy (np. w przypadku meczu bokserskiego lub igrzysk olimpijskich), określ uczestników jako zawodników. Jeśli SportsTeam, właściwości są takie same jak SportsEvent.homeTeam. Jeśli Person, właściwości są takie same jak w przypadku innych obiektów Person, np. aktora w Movie. |
location |
Miejsce LUB Miasto | Lokalizacja wydarzenia. |
location.name |
Text | Wymagane – nazwa lokalizacji. |
location.address |
PostalAddress | Wymagane, jeśli @type lokalizacji to Place – adres lokalizacji. Nie należy jej używać, jeśli @type lokalizacji to City. |
location.address.streetAddress |
Text | Adres lokalizacji. |
location.address.addressLocality |
Text | Miejscowość, w której znajduje się lokalizacja. |
location.address.addressRegion |
Text | Stan lokalizacji. |
location.address.postalCode |
Text | Kod pocztowy lokalizacji. |
location.address.addressCountry |
Text | Kraje w formacie ISO 3166. |
image |
ImageObject | Wymagane w Google TV – obrazy związane z wydarzeniem. Zalecamy użycie oficjalnego plakatu lub banera wydarzenia. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w przypadku image, znajdziesz w sekcji Właściwości obrazu. |
potentialAction |
WatchAction (oglądanie) | Wymagane, jeśli dotyczy – precyzyjne linki do odtwarzania wydarzenia sportowego, używane zarówno w przypadku transmisji na żywo bez kanału, jak i powtórek wideo na żądanie. Wszystkie precyzyjne linki do wydarzeń sportowych muszą znajdować się w polu SportsEvent.potentialAction. Nigdy nie umieszczaj pola potentialAction w polu BroadcastEvent, które odwołuje się do pola SportsEvent (w przypadku transmisji w telewizji linearnej bez bezpośredniego precyzyjnego linku do wydarzenia podaj precyzyjny link do kanału w polu BroadcastService.potentialAction). Podaj tablicę obiektów WatchAction, jeśli oferujesz wiele transmisji (np. regionalne, domowe lub wyjazdowe albo w wielu językach) lub osobne okna transmisji na żywo i powtórek wideo na żądanie. |
potentialAction.actionAccessibilityRequirement |
ActionAccessSpecification | Wymagane, jeśli podano potentialAction – określa uprawnienia i okres dostępności (availabilityStarts i availabilityEnds) dla każdego WatchAction:
|
identifier |
PropertyValue | Zdecydowanie zalecane Dlaczego? – zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje ten podmiot. Dozwolone jest użycie wielu identyfikatorów. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora. |
Przykłady SportsEvent
Przykład sportu drużynowego
{
"@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"
}
]
}
Przykład dotyczący sportów indywidualnych
{
"@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 z ograniczeniami GeoShape
{
"@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"
]
}
]
}
}
]
}
Tabela specyfikacji MusicEvent
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ustawiony na ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | Wymagany – zawsze ustawiony na MusicEvent. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie identyfikatora URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url podmiotu spełnia wszystkie wymagania dotyczące identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator. |
name |
Text | Wymagane – nazwa wydarzenia.
|
description |
Text | Opis zdarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić opisy w różnych językach i o różnej długości. |
attendee |
Organization lub Person | Osoba lub organizacja uczestnicząca w wydarzeniu. |
startDate |
Data | Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 ze strefą czasową. |
endDate |
Data | Godzina zakończenia wydarzenia w formacie ISO 8601 ze strefą czasową. |
composer |
Organization lub Person | Osoba lub organizacja, która napisała kompozycję lub jest kompozytorem utworu wykonywanego podczas wydarzenia. |
performer |
Organization lub Person | Wymagany – wykonawca, który występuje podczas wydarzenia, np. prezenter, muzyk, zespół muzyczny lub aktor. |
subEvent |
Wydarzenie | Wydarzenie, które jest częścią tego wydarzenia. Na przykład wydarzenie konferencyjne obejmuje wiele prezentacji, z których każda jest zdarzeniem podrzędnym konferencji. |
superEvent |
Wydarzenie | Wydarzenie, którego częścią jest to wydarzenie. Na przykład kolekcja poszczególnych występów muzycznych może mieć festiwal muzyczny jako superEvent. |
location |
Miejsce LUB Miasto | Wymagane – lokalizacja wydarzenia. |
location.name |
Text | Wymagane – nazwa lokalizacji. |
location.address |
PostalAddress | Wymagane, jeśli @type lokalizacji to Place – adres lokalizacji. Nie należy jej używać, jeśli lokalizacja @type to City. |
location.address.streetAddress |
Text | Adres lokalizacji. |
location.address.addressLocality |
Text | Miejscowość, w której znajduje się lokalizacja. |
location.address.addressRegion |
Text | Stan lokalizacji. |
location.address.postalCode |
Text | Kod pocztowy lokalizacji. |
location.address.addressCountry |
Text | Kraje w formacie ISO 3166. |
workPerformed |
CreativeWork | Dzieło wykonane podczas jakiegoś wydarzenia, np. sztuka wystawiona podczas wydarzenia teatralnego. |
Przykład 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"
}
}
Tabela specyfikacji zdarzeń
| Właściwość | Oczekiwany typ | Opis |
|---|---|---|
@context |
Text | Wymagany – zawsze ustawiony na ["http://schema.org", {"@language": "xx"}]
|
@type |
Text | Wymagany – zawsze ustawiony na Event. |
@id |
Adres URL | Wymagany – identyfikator treści w formacie identyfikatora URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url elementu spełnia wszystkie wymagania dotyczące identyfikatora, dlatego zalecamy używanie url elementu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator. |
name |
Text | Wymagane – nazwa wydarzenia.
|
description |
Text | Opis zdarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić opisy w różnych językach i o różnej długości. |
attendee |
Organization lub Person | Osoba lub organizacja uczestnicząca w wydarzeniu. |
startDate |
Data | Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 ze strefą czasową. |
endDate |
Data | Godzina zakończenia wydarzenia w formacie ISO 8601 ze strefą czasową. |
subEvent |
Wydarzenie | Wydarzenie, które jest częścią tego wydarzenia. Na przykład wydarzenie konferencyjne obejmuje wiele prezentacji, z których każda jest zdarzeniem podrzędnym konferencji. |
superEvent |
Wydarzenie | Wydarzenie, którego częścią jest to wydarzenie. Na przykład kolekcja poszczególnych występów muzycznych może mieć festiwal muzyczny jako superEvent. |
releasedEvent |
PublicationEvent, FeaturedEvent lub ExclusiveEvent |
Zdecydowanie zalecane Dlaczego? – PublicationEvent służy do określenia pierwotnej (globalnej lub lokalnej) daty premiery treści przez wydawcę, np. pierwotnej daty premiery kinowej filmu.Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, polecane, specjalne itp.ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji, i zawiera informacje o tym, gdzie i kiedy.Szczegółowe informacje i przykłady znajdziesz w sekcji z przykładami. |
releasedEvent.@type |
Text | Wymagane – zawsze ustaw tę właściwość na jedną z tych wartości:
|
releasedEvent.location |
Kraj | Wymagane – regiony powiązane z tym wydarzeniem. W przypadku PublicationEvent jest to region, w którym opublikowano treści.W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są polecane lub dostępne na wyłączność.Użyj kodów krajów zgodnych ze standardem ISO 3166. Aby wskazać wszędzie na świecie, ustaw wartość EARTH. |
releasedEvent.startDate |
Date lub DateTime | Zalecany – wymagany w przypadku: ExclusiveEvent – data rozpoczęcia publikacji elementu.W przypadku: PublicationEvent oznacza to datę pierwszej premiery elementu, np. datę premiery filmu w kinach.W przypadku: ExclusiveEvent i FeaturedEvent oznacza to datę rozpoczęcia okresu, w którym element jest dostępny na wyłączność lub promowany. |
releasedEvent.endDate |
Date lub DateTime | Zalecane – wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.W przypadku ExclusiveEvent jest to data wygaśnięcia praw do treści.W przypadku FeaturedEvent jest to ostatnia data, kiedy dostawca promuje dany podmiot.Jeśli treści są stale dostępne na wyłączność lub promowane, ustaw wartość endDate na 20 lat od bieżącej daty. |
releasedEvent.publishedBy |
Organization lub Person | Opcjonalny – organizacja lub osoba, która opublikowała ten podmiot. |
location |
Miejsce LUB Miasto | Wymagane – lokalizacja wydarzenia. Pamiętaj, że właściwość Place możesz podać na poziomie City. |
location.name |
Text | Wymagane – nazwa lokalizacji. |
location.address |
PostalAddress | Wymagane, jeśli @type lokalizacji to Place – adres lokalizacji. Nie należy go używać, jeśli @type lokalizacji to City (Miasto). |
location.address.streetAddress |
Text | Adres lokalizacji. |
location.address.addressLocality |
Text | Miejscowość, w której znajduje się lokalizacja. |
location.address.addressRegion |
Text | Stan lokalizacji. |
location.address.postalCode |
Text | Kod pocztowy lokalizacji. |
location.address.addressCountry |
Text | Kraje w formacie ISO 3166. |
workPerformed |
CreativeWork | Dzieło wykonane podczas jakiegoś wydarzenia, np. sztuka wystawiona podczas wydarzenia teatralnego. |
Przykładowe zdarzenie
Zdarzenie
{
"@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"
}
}