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 dla typu elementu związanego z Event.

Tabela specyfikacji wydarzenia sportowego

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – 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:
  • niepowtarzalny na całym świecie w katalogu;
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość adresu URL programu). Jest on traktowany jako ciąg nieprzejrzysty, więc nie musi być działającym linkiem.
  • w formie ujednoliconego identyfikatora zasobu (URI);
  • Domena użyta w wartości @id musi należeć do Twojej organizacji.
Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagany – nazwa tego zdarzenia.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
  • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
description Text Opis tego zdarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić teksty w różnych językach i o różnej długości.
sport Adres URL Wymagany link do strony Wikipedii (w wersji angielskiej) poświęconej danej dyscyplinie sportowej.
startDate DateTime lub Date Wymagany – 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 Godzina zakończenia wydarzenia w formacie ISO 8601 ze strefą czasową.
homeTeam SportsTeam Zdecydowanie zalecane (dlaczego?) Domowa drużyna wydarzenia.
homeTeam.name Text Wymagany Pełna nazwa drużyny sportowej.
homeTeam.sport Adres URL Wymagany link do strony Wikipedii (w wersji angielskiej) poświęconej danej dyscyplinie sportowej.
homeTeam.sameAs Adres URL Zdecydowanie zalecane (dlaczego?) Adres URL strony referencyjnej, która może identyfikować zespół, np. stronę zespołu w Wikipedii.
homeTeam.athlete Person Adnotacje dotyczące pojedynczego sportowca w drużynie.
homeTeam.athlete.name Text Imię i nazwisko sportowca.
homeTeam.parentOrganization.name SportsOrganization Wymagany – nazwa ligi sportowej, do której należy drużyna. Może to być na przykład National Basketball Association lub Major League Baseball. Pamiętaj, że tego pola nie należy używać w przypadku konferencji zespołowej.
homeTeam.parentOrganization.sameAs Adres URL Zdecydowanie zalecane (dlaczego?) Adres URL strony referencyjnej, która może identyfikować ligę drużyny, np. stronę ligi w Wikipedii.
awayTeam SportsTeam Zdecydowanie zalecane (dlaczego?) Drużyna gości w danym wydarzeniu. Właściwości są takie same jak w przypadku usługi SportsEvent.homeTeam.
competitor SportsTeam lub Person Zdecydowanie zalecane (dlaczego?) Jeśli drużyna gospodarzy lub gości nie jest odpowiednia (np. mecz bokserski, igrzyska), określ uczestników jako zawodników. Jeśli SportsTeam, właściwości są takie same jak w przypadku SportsEvent.homeTeam. Jeśli Person, właściwości są takie same jak w przypadku innych obiektów Person, np. aktor w Movie.
location Miejsce LUB Miasto Lokalizacja wydarzenia.
location.name Text Wymagany – nazwa lokalizacji.
location.address PostalAddress Wymagany, jeśli typ lokalizacji to Miejsce – adres lokalizacji. Nie należy jej używać, jeśli lokalizacja @type to Miasto
location.address.streetAddress Text Adres lokalizacji.
location.address.addressLocality Text Miasto, w którym 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 Wymagany w przypadku Google TV: obrazy związane z wydarzeniem. Zaleca się, aby był to oficjalny plakat lub baner promujący wydarzenie. Więcej informacji o wymaganych i opcjonalnych właściwościach, które należy uwzględnić w przypadku image, znajdziesz w artykule Właściwości obrazu.
potentialAction WatchAction (oglądanie) Wymagany w odpowiednich przypadkach – precyzyjny link do nagrania tego wydarzenia sportowego w wideo na żądanie. Aby określić precyzyjny link do wydarzenia na żywo, użyj właściwości publishedOn lub potentialAction w polu BroadcastEvent.
identifier PropertyValue Zdecydowanie zalecane (dlaczego?) – zewnętrzny lub inny identyfikator jednoznacznie identyfikujący ten podmiot. Dozwolone są liczne identyfikatory. Szczegółowe informacje znajdziesz w sekcji Właściwości identyfikatora.

Przykłady dotyczące typu SportsEvent

Przykład dotyczący 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": "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 sportu indywidualnego 

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

Zasób 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": "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"
            ]
          },
        ]
      }
    }
  ]
}

Tabela specyfikacji MusicEvent

Właściwość Oczekiwany typ Opis
@context Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – 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:
  • Niepowtarzalny na całym świecie w katalogu.
  • Statyczny
  • w formie ujednoliconego identyfikatora zasobu (URI);
Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagany – nazwa tego zdarzenia.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
  • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
description Text Opis zdarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić teksty 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 Wymagany – 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 utwór lub jest kompozytorem utworu wykonanego podczas jakiegoś wydarzenia.
performer Organization lub Person Wymagany – wykonawca podczas wydarzenia, np. prezenter, muzyk, zespół muzyczny lub aktor.
subEvent Wydarzenie Zdarzenie, które jest częścią tego zdarzenia. Na przykład konferencja zawiera wiele prezentacji, z których każda jest podzdarzeniem konferencji.
superEvent Wydarzenie Zdarzenie, którego to zdarzenie jest częścią. Na przykład kolekcja poszczególnych występów muzycznych może mieć jako superEvent festiwal muzyczny.
location Miejsce LUB Miasto Wymagane – lokalizacja wydarzenia.
location.name Text Wymagany – nazwa lokalizacji.
location.address PostalAddress Wymagany, jeśli typ lokalizacji to Miejsce – adres lokalizacji. Nie należy jej używać, jeśli typ lokalizacji to @type City.
location.address.streetAddress Text Adres lokalizacji.
location.address.addressLocality Text Miasto, w którym 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 wykonywane w ramach jakiegoś wydarzenia, na przykład sztuka teatralna wykonywana w ramach wydarzenia typu TheaterEvent.

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 Text Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – 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:
  • Niepowtarzalny na całym świecie w katalogu.
  • Statyczny
  • w formie ujednoliconego identyfikatora zasobu (URI);
Ponieważ url podmiotu spełnia wszystkie wymagania dotyczące identyfikatorów, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagany: nazwa tego zdarzenia.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład dotyczący wielu regionów i języków.
  • Pamiętaj, że w przypadku każdej lokalizacji (pary język-kraj) obsługiwana jest tylko jedna nazwa.
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 Wymagany – 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 Zdarzenie, które jest częścią tego zdarzenia. Na przykład konferencja zawiera wiele prezentacji, z których każda jest podzdarzeniem konferencji.
superEvent Wydarzenie Zdarzenie, którego to zdarzenie jest częścią. Na przykład kolekcja poszczególnych występów muzycznych może mieć jako superEvent festiwal muzyczny.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecane (dlaczego?) – PublicationEvent służy do określenia pierwotnego (globalnego lub lokalnego) wydania treści przez wydawcę, np. pierwotna data premiery filmu w kinach.

Dodatkowo użyj FeaturedEvent, aby wskazać, że Twoja usługa promuje te treści jako oryginalne, wyróżnione, specjalne itp.

ExclusiveEvent wskazuje, że Twoja usługa ma wyłączne prawa do dystrybucji i określa, gdzie i kiedy.

Zobacz szczegóły i przykłady w sekcji z przykładami.
releasedEvent.@type Text Wymagany – zawsze ustawiaj tę właściwość na jedną z tych wartości:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Kraj Wymagane – regiony powiązane z tym wydarzeniem.

W przypadku PublicationEvent jest to region, w którym treści zostały opublikowane.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są wyróżnione lub dostępne wyłącznie.

Użyj kodów ISO 3166 dla krajów. Aby wskazać wszystkie miejsca na świecie, ustaw wartość EARTH.
releasedEvent.startDate Date lub DateTime Zalecane – wymagane w przypadku ExclusiveEvent – data rozpoczęcia publikacji elementu.

W przypadku PublicationEvent oznacza to datę premiery tego 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 wyłącznie w danym miejscu lub jako element polecany.
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, w której dostawca wyświetla element.

Jeśli treści są stale dostępne lub są wyróżnione, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organization lub Person Opcjonalnie – organizacja lub osoba, która opublikowała tę jednostkę.
location Miejsce LUB Miasto Wymagane – lokalizacja wydarzenia. Pamiętaj, że możesz podać Place na poziomie City.
location.name Text Wymagany – nazwa lokalizacji.
location.address PostalAddress Wymagany, jeśli typ lokalizacji to Miejsce – adres lokalizacji. Nie należy jej używać, jeśli typ lokalizacji to „Miasto”.
location.address.streetAddress Text Adres lokalizacji.
location.address.addressLocality Text Miasto, w którym 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 wykonywane w ramach jakiegoś wydarzenia, na przykład sztuka teatralna wykonywana w ramach wydarzenia typu TheaterEvent.

Przykład zdarzenia

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