W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści związanych z powiązanym typem elementu Event
.
Tabela specyfikacji wydarzeń sportowych
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Tekst | Wymagane – zawsze ustaw na ["http://schema.org", {"@language": "xx"}]
|
@type |
Tekst | Wymagane – zawsze ma wartość SportsEvent . |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie url elementu jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
name |
Tekst | Wymagane – nazwa tego zdarzenia.
|
description |
Tekst | Opis wydarzenia. 300-znakowy limist. Aby uwzględnić opisy w różnych językach i o długości, użyj tablicy. |
sport |
Adres URL | Wymagany link do strony o sporcie w Wikipedii (preferowana jest wersja angielska). |
startDate |
DateTime lub Date | Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 i strefa czasowa. Pamiętaj, że to godzina rozpoczęcia wydarzenia, a nie data jego transmisji w telewizji. |
endDate |
DateTime lub Date | Godzina zakończenia wydarzenia w formacie ISO 8601 i strefa czasowa. |
homeTeam |
SportsTeam | Bardzo zalecane Dlaczego? Drużyna gospodarzy wydarzenia. |
homeTeam.name |
Tekst | Wymagane pełna nazwa drużyny sportowej. |
homeTeam.sport |
Adres URL | Wymagany link do strony o sporcie w Wikipedii (preferowana jest wersja angielska). |
homeTeam.sameAs |
Adres URL | Bardzo zalecane Dlaczego? Adres URL referencyjnej strony internetowej, na której można zidentyfikować zespół, np. strony zespołu w Wikipedii. |
homeTeam.athlete |
Person | Adnotacje dotyczące pojedynczego zawodnika w drużynie. |
homeTeam.athlete.name |
Tekst | Imię i nazwisko zawodnika. |
homeTeam.parentOrganization.name |
SportsOrganization | Wymagany Nazwa ligi sportowej, do której należy dana drużyna. Na przykład National Basketball Association lub Major League Baseball. Pamiętaj, że to pole nie powinno być używane w przypadku konferencji zespołu. |
homeTeam.parentOrganization.sameAs |
Adres URL | Bardzo zalecane Dlaczego? Adres URL referencyjnej strony internetowej, która może identyfikować ligę drużyny, np. jej stronę w Wikipedii. |
awayTeam |
SportsTeam | Bardzo zalecane Dlaczego? Drużyna wypadowa danego zawodu. Właściwości są takie same jak właściwości SportsEvent.homeTeam . |
competitor |
SportsTeam lub Person | Bardzo zalecane Dlaczego? Jeśli w Twoim przypadku nie ma zastosowania drużyna gospodyni lub wyjazdowa (np. mecz bokserski czy igrzyska olimpijskie), wskaż uczestników jako zawodników. Jeśli jest ustawiona SportsTeam , właściwości są takie same jak SportsEvent.homeTeam . W przypadku właściwości Person właściwości są takie same jak w przypadku innych obiektów Person , np. użytkownik, który wykonał czynność w obiekcie Movie . |
location |
Miejsce LUB Miasto | Lokalizacja wydarzenia. |
location.name |
Tekst | Wymagane – nazwa lokalizacji. |
location.address |
PostalAddress | Wymagany, jeśli lokalizacja @type to Miejsce – adres lokalizacji. Nie należy używać tego atrybutu, jeśli lokalizacja @type to Miasto |
location.address.streetAddress |
Tekst | Adres lokalizacji. |
location.address.addressLocality |
Tekst | Miasto, w którym znajduje się lokalizacja. |
location.address.addressRegion |
Tekst | Stan, w którym znajduje się lokalizacja. |
location.address.postalCode |
Tekst | Kod pocztowy lokalizacji. |
location.address.addressCountry |
Tekst | Kraje w formacie ISO 3166. |
image |
ImageObject | Wymagane w przypadku Google TV – zdjęcia związane ze zdarzeniem. Zalecany jako oficjalny plakat wydarzenia lub baner. Więcej informacji o wymaganych i opcjonalnych właściwościach uwzględnionych w elemencie image znajdziesz w sekcji Właściwości obrazów. |
potentialAction |
WatchAction | Wymagany, jeśli dotyczy – precyzyjny link, który odtwarza nagranie tego wydarzenia sportowego w usłudze wideo na żądanie. Aby określić precyzyjny link dla wydarzenia na żywo, użyj właściwości publishedOn lub potentialAction w dyrektywie BroadcastEvent . |
identifier |
PropertyValue | Bardzo zalecane Dlaczego? – Zewnętrzny lub inny identyfikator, który jednoznacznie identyfikuje dany podmiot. Dozwolonych jest kilka identyfikatorów. Więcej informacji znajdziesz w sekcji Właściwości identyfikatora. |
Przykłady wydarzeń SportsEvent
Przykład 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"
}
]
}
Przykład 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"
}
}
}
Tabela specyfikacji MusicEvent
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Tekst | Wymagane – zawsze ustaw na ["http://schema.org", {"@language": "xx"}]
|
@type |
Tekst | Wymagane – zawsze ma wartość MusicEvent . |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie url elementu jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
name |
Tekst | Wymagane – nazwa tego zdarzenia.
|
description |
Tekst | Opis zdarzenia. 300-znakowy limist. Aby uwzględnić opisy w różnych językach i o długości, użyj tablicy. |
attendee |
Organization lub Person | Osoba lub organizacja uczestnicząca w wydarzeniu. |
startDate |
Data | Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 i strefa czasowa. |
endDate |
Data | Godzina zakończenia wydarzenia w formacie ISO 8601 i strefa czasowa. |
composer |
Organization lub Person | Osoba lub organizacja, która jest autorem kompozycji albo jest kompozytorem utworu wykonywanego podczas wydarzenia. |
performer |
Organization lub Person | Wymagany – wykonawca podczas wydarzenia, np. prowadzący, muzyk, grupa muzyczna lub aktor. |
subEvent |
Wydarzenie | Wydarzenie, które jest częścią tego wydarzenia. Na przykład wydarzenie konferencyjne składa się z wielu prezentacji, z których każda jest jednym z wydarzeń podrzędnych. |
superEvent |
Wydarzenie | Wydarzenie, którego częścią jest to wydarzenie. Na przykład dla każdego z zbiorów poszczególnych występów muzycznych może być określony festiwal muzyczny. |
location |
Miejsce LUB Miasto | Wymagane – lokalizacja wydarzenia. |
location.name |
Tekst | Wymagane – nazwa lokalizacji. |
location.address |
PostalAddress | Wymagany, jeśli lokalizacja @type to Miejsce – adres lokalizacji. Nie należy używać tej właściwości, jeśli lokalizacja @type to Miasto. |
location.address.streetAddress |
Tekst | Adres lokalizacji. |
location.address.addressLocality |
Tekst | Miasto, w którym znajduje się lokalizacja. |
location.address.addressRegion |
Tekst | Stan, w którym znajduje się lokalizacja. |
location.address.postalCode |
Tekst | Kod pocztowy lokalizacji. |
location.address.addressCountry |
Tekst | Kraje w formacie ISO 3166. |
workPerformed |
CreativeWork | Dzieło wykonane w trakcie jakiegoś wydarzenia, na przykład spektakl w teatrze. |
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 zdarzenia
Właściwość | Oczekiwany typ | Opis |
---|---|---|
@context |
Tekst | Wymagane – zawsze ustaw na ["http://schema.org", {"@language": "xx"}]
|
@type |
Tekst | Wymagane – zawsze ma wartość Event . |
@id |
Adres URL | Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.@id musi spełniać te wymagania:
url elementu spełnia wszystkie wymagania jako identyfikator, dlatego zalecamy użycie url elementu jako @id . Więcej informacji znajdziesz w sekcji Identyfikator. |
name |
Tekst | Wymagane – nazwa tego zdarzenia.
|
description |
Tekst | Opis zdarzenia. 300-znakowy limist. Aby uwzględnić opisy w różnych językach i o długości, użyj tablicy. |
attendee |
Organization lub Person | Osoba lub organizacja uczestnicząca w wydarzeniu. |
startDate |
Data | Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 i strefa czasowa. |
endDate |
Data | Godzina zakończenia wydarzenia w formacie ISO 8601 i strefa czasowa. |
subEvent |
Wydarzenie | Wydarzenie, które jest częścią tego wydarzenia. Na przykład wydarzenie konferencyjne składa się z wielu prezentacji, z których każda jest jednym z wydarzeń podrzędnych. |
superEvent |
Wydarzenie | Wydarzenie, którego częścią jest to wydarzenie. Na przykład dla każdego z zbiorów poszczególnych występów muzycznych może być określony festiwal muzyczny. |
releasedEvent |
PublicationEvent , FeaturedEvent lub ExclusiveEvent |
Bardzo zalecane Dlaczego? – Parametr PublicationEvent służy do określania pierwotnego (globalnego lub lokalnego) wydania treści przez wydawcę, na przykład oryginalnej daty premiery filmu.Użyj pola FeaturedEvent , aby wskazać, że Twoja usługa promuje te treści jako oryginalne, polecane, specjalne itd.ExclusiveEvent określa, że Twoja usługa ma wyłączne prawa do dystrybucji oraz czas i miejsce ich dystrybucji.Szczegółowe informacje i przykłady znajdziesz w sekcji z przykładami. |
releasedEvent.@type |
Tekst | Wymagane – pamiętaj, by zawsze ustawić jedną z tych właściwości:
|
releasedEvent.location |
Kraj | Wymagane – regiony powiązane z tym zdarzeniem. W przypadku elementu PublicationEvent jest to region, w którym opublikowano treści.W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są prezentowane lub niedostępne.W przypadku krajów używaj kodów ISO 3166. Aby wskazać lokalizację w każdym miejscu na świecie, ustaw wartość EARTH . |
releasedEvent.startDate |
Date lub DateTime | Zalecane – wymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji przez podmiot.W przypadku elementu PublicationEvent oznacza datę premiery danego podmiotu, na przykład datę premiery filmu w kinach.W przypadku ExclusiveEvent i FeaturedEvent wskazuje ona datę rozpoczęcia publikacji treści na wyłączność lub eksploatacji. |
releasedEvent.endDate |
Date lub DateTime | Zalecane – wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent .W przypadku ExclusiveEvent wskazuje datę wygaśnięcia praw do treści.W przypadku FeaturedEvent jest to ostatni dzień, w którym dostawca udostępnia dany element.Jeśli treści są wiecznie niedostępne lub polecane, ustaw wartość endDate na 20 lat od bieżącej daty. |
releasedEvent.publishedBy |
Organization lub Person | Opcjonalny – organizacja lub osoba, która opublikowała dany element. |
location |
Miejsce LUB Miasto | Wymagane – lokalizacja wydarzenia. Pamiętaj, że możesz podać: Place na poziomie City . |
location.name |
Tekst | Wymagane – nazwa lokalizacji. |
location.address |
PostalAddress | Wymagany, jeśli lokalizacja @type to Miejsce – adres lokalizacji. Tej opcji nie należy używać, jeśli lokalizacja @type to Miasto |
location.address.streetAddress |
Tekst | Adres lokalizacji. |
location.address.addressLocality |
Tekst | Miasto, w którym znajduje się lokalizacja. |
location.address.addressRegion |
Tekst | Stan, w którym znajduje się lokalizacja. |
location.address.postalCode |
Tekst | Kod pocztowy lokalizacji. |
location.address.addressCountry |
Tekst | Kraje w formacie ISO 3166. |
workPerformed |
CreativeWork | Dzieło wykonane w trakcie jakiegoś wydarzenia, na przykład spektakl w teatrze. |
Przykładowe wydarzenie
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"
}
}