Właściwości znaczników treści zdarzeń

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"}]
  • Zastąp xx kodem języka jednostki w formacie BCP 47, np. „en”.
@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:
  • Unikalne globalnie w Twoim katalogu
  • Statyczny – identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmienia się właściwość URL programu). Jest on traktowany jako ciąg nieprzejrzysty i nie musi być działającym linkiem.
  • W postaci identyfikatora URI
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Atrybut 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.
  • Użyj tablicy, aby wymienić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) jest obsługiwana tylko jedna nazwa.
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"}]
  • Zastąp xx kodem języka jednostki w formacie BCP 47, np. „en”.
@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:
  • Unikalne globalnie w Twoim katalogu
  • Statyczny
  • W postaci identyfikatora URI
Atrybut 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.
  • Użyj tablicy, aby wymienić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) jest obsługiwana tylko jedna nazwa.
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"}]
  • Zastąp xx kodem języka jednostki w formacie BCP 47, np. „en”.
@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:
  • Unikalne globalnie w Twoim katalogu
  • Statyczny
  • W postaci identyfikatora URI
Atrybut 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.
  • Użyj tablicy, aby wymienić nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że dla każdego języka (para język-kraj) jest obsługiwana tylko jedna nazwa.
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:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 Zalecanewymagane 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 Zalecanewymagane 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"
  }
}