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

Ta sekcja zawiera 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 Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – zawsze ustawiony na SportsEvent.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Statyczny; identyfikator powinien być stały i nie zmieniać się w czasie (nawet jeśli zmieni się właściwość url programu). Będzie 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 identyfikatora, zalecamy używanie url podmiotu jako @id. Więcej informacji znajdziesz w sekcji Identyfikator.
name Text Wymagany – nazwa zdarzenia.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego ustawienia regionalnego (pary język-kraj) obsługiwana jest tylko jedna nazwa.
description Text Opis tego wydarzenia. Limit 300 znaków. Użyj tablicy, aby uwzględnić opisy w różnych językach i o różnej długości.
sport Adres URL Wymagany Link do strony Wikipedii (najlepiej w języku angielskim) poświęconej danemu sportowi.
startDate DateTime lub Date Wymagane – godzina rozpoczęcia wydarzenia w formacie ISO 8601 ze strefą czasową. Pamiętaj, że jest to rzeczywista godzina 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 zalecamy 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) poświęconej danemu sportowi.
homeTeam.sameAs Adres URL Zdecydowanie zalecamy 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.name SportsOrganization Wymagane 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 zalecamy Dlaczego? Adres URL referencyjnej strony internetowej, która może identyfikować ligę drużyny, np. strona ligi w Wikipedii.
awayTeam SportsTeam Zdecydowanie zalecamy Dlaczego? Drużyna gości w wydarzeniu. Właściwości są takie same jak w przypadku SportsEvent.homeTeam.
competitor SportsTeam lub Person Zdecydowanie zalecamy Dlaczego? Jeśli drużyna gospodarzy lub gości nie ma zastosowania (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. aktor w Movie.
location Miejsce LUB Miasto Lokalizacja wydarzenia.
location.name Text Wymagany – nazwa lokalizacji.
location.address PostalAddress Wymagany, jeśli typ lokalizacji @type to Place – adres lokalizacji. Nie należy używać tej właściwości, 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.
image ImageObject Wymagane w Google TV – obrazy związane z wydarzeniem. Zalecane jako oficjalny plakat lub baner wydarzenia. Więcej informacji o właściwościach wymaganych i opcjonalnych, które należy uwzględnić w przypadku image, znajdziesz w sekcji Właściwości obrazu.
potentialAction WatchAction (oglądanie) Wymagane, jeśli ma zastosowanie – precyzyjny link, który odtwarza nagranie tego wydarzenia sportowego w usłudze wideo na żądanie. Aby określić precyzyjny link do wydarzenia na żywo, użyj właściwości publishedOn lub potentialAction w BroadcastEvent.
identifier PropertyValue Zdecydowanie zalecamy Dlaczego? – Zewnętrzny lub inny identyfikator, który jednoznacznie określa ten podmiot. Dozwolonych jest kilka 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": "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 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",
  "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": "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 Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – zawsze ustawiony na MusicEvent.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Statyczny
  • W formie ujednoliconego identyfikatora zasobu (URI)
Ponieważ 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 Wymagany – nazwa zdarzenia.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego ustawienia regionalnego (pary język-kraj) obsługiwana jest tylko jedna nazwa.
description Text Opis wydarzenia. 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 jakiegoś wydarzenia.
performer Organization lub Person Wymagany – wykonawca podczas wydarzenia, np. prezenter, muzyk, grupa muzyczna lub aktor.
subEvent Wydarzenie Wydarzenie, które jest częścią tego wydarzenia. Na przykład konferencja obejmuje wiele prezentacji, z których każda jest podrzędnym zdarzeniem konferencji.
superEvent Wydarzenie Wydarzenie, którego częścią jest to zdarzenie. Na przykład zbiór pojedynczych występów muzycznych może mieć festiwal muzyczny jako superEvent.
location Miejsce LUB Miasto Wymagane – lokalizacja wydarzenia.
location.name Text Wymagany – nazwa lokalizacji.
location.address PostalAddress Wymagany, jeśli typ lokalizacji @type to Place – adres lokalizacji. Nie należy używać tego pola, jeśli typ lokalizacji to 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 wykonane podczas jakiegoś wydarzenia, np. sztuka wystawiona w ramach 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 zdarzenia

Właściwość Oczekiwany typ Opis
@context Text Wymagane – zawsze ustawione na ["http://schema.org", {"@language": "xx"}]
@type Text Wymagany – zawsze ustawiony na Event.
@id Adres URL Wymagany – identyfikator treści w formacie URI, np. https://example.com/1234abc.
@id musi spełniać te wymagania:
  • Niepowtarzalny w całym katalogu
  • Statyczny
  • W formie ujednoliconego identyfikatora zasobu (URI)
Ponieważ 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 Wymagany – nazwa zdarzenia.
  • Użyj tablicy, aby podać nazwy w różnych językach. Zobacz przykład Wiele regionów i języków.
  • Pamiętaj, że w przypadku każdego ustawienia regionalnego (pary język-kraj) obsługiwana jest tylko jedna nazwa.
description Text Opis wydarzenia. 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 konferencja obejmuje wiele prezentacji, z których każda jest podrzędnym zdarzeniem konferencji.
superEvent Wydarzenie Wydarzenie, którego częścią jest to zdarzenie. Na przykład zbiór pojedynczych występów muzycznych może mieć festiwal muzyczny jako superEvent.
releasedEvent PublicationEvent, FeaturedEvent lub ExclusiveEvent Zdecydowanie zalecamy Dlaczego? – PublicationEvent służy do określania pierwotnej (globalnej lub lokalnej) publikacji treści przez wydawcę, np. pierwotnej daty premiery filmu w kinach.

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

ExclusiveEvent oznacza, ż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 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 opublikowano treści.

W przypadku FeaturedEvent i ExclusiveEvent jest to region, w którym treści są promowane lub dostępne na wyłączność.

W przypadku krajów używaj kodów ISO 3166. Aby wskazać wszędzie 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ę pierwszej publikacji 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 wyróżniony.
releasedEvent.endDate Date lub DateTime Zalecane – wymagane w przypadku ExclusiveEvent – dotyczy tylko typów ExclusiveEvent i FeaturedEvent.

W przypadku typu ExclusiveEvent jest to data wygaśnięcia praw do treści.

W przypadku typu FeaturedEvent jest to ostatnia data, w której dostawca promuje podmiot.

Jeśli treści są prezentowane lub dostępne na wyłączność bezterminowo, ustaw wartość endDate na 20 lat od bieżącej daty.
releasedEvent.publishedBy Organization lub Person Opcjonalnie – organizacja lub osoba, która opublikowała ten podmiot.
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 @type to Place – adres lokalizacji. Nie należy używać tego pola, 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 wykonane podczas jakiegoś wydarzenia, np. sztuka wystawiona w ramach wydarzenia teatralnego.

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