Свойства разметки содержимого событий

В этом разделе представлена ​​подробная информация о свойствах разметки содержимого для типа сущности, связанного с Event .

SportsEvent specification table

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx на код языка сущности в формате BCP 47 , например, "en".
@type Текст Required - Always set to SportsEvent .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Globally unique across your catalog
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство url объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой.
  • В форме унифицированного идентификатора ресурса (URI)
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
name Текст Обязательно — Название мероприятия.
  • Используйте массив для перечисления имен на разных языках. См. пример " Несколько регионов и языков" .
  • Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
description Текст Описание этого события. Ограничение в 300 символов. Используйте массив для включения описаний на разных языках и различной длины.
sport URL Обязательно: ссылка на страницу Википедии (предпочтительно на английском языке) о данном виде спорта.
startDate DateTime or Date Обязательно — время начала мероприятия в формате ISO 8601 с указанием часового пояса. Обратите внимание, что это фактическое время начала мероприятия, а не время его трансляции по телевидению.
endDate Дата и время или дата Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
homeTeam Спортивная команда Настоятельно рекомендуем! Почему? Потому что это домашняя команда мероприятия.
homeTeam.name Текст Required The full name of the sports team.
homeTeam.sport URL Обязательно: ссылка на страницу Википедии (предпочтительно на английском языке) о данном виде спорта.
homeTeam.sameAs URL Настоятельно рекомендуется. Почему? URL-адрес веб-страницы, которая позволяет идентифицировать команду; например, страница команды в Википедии.
homeTeam.athlete Человек Аннотации для отдельного спортсмена команды.
homeTeam.athlete.name Текст The full name of the athlete.
homeTeam.parentOrganization.name Спортивная организация Обязательно укажите название спортивной лиги, в которой состоит команда. Например, Национальная баскетбольная ассоциация или Главная бейсбольная лига. Обратите внимание, что это поле не следует использовать для указания конференции команды.
homeTeam.parentOrganization.sameAs URL Настоятельно рекомендуется. Почему? URL-адрес веб-страницы, которая позволяет определить лигу команды; например, страница лиги в Википедии.
awayTeam Спортивная команда Настоятельно рекомендуется. Почему? Команда гостей мероприятия. Свойства те же, что и у SportsEvent.homeTeam .
competitor Спортивная команда или человек Настоятельно рекомендуется. Почему? Если домашняя или гостевая команда не применима (например, боксерский матч, Олимпийские игры), укажите участников как «соревнования». Если это SportsTeam , свойства совпадают со свойствами SportsEvent.homeTeam . Если это Person , свойства совпадают со свойствами других объектов Person ; например, актера в Movie .
location Place OR City The location of the event.
location.name Текст Обязательно — название местоположения.
location.address Почтовый адрес Обязательно, если location @type имеет значение Place — адрес местоположения. Не следует использовать этот параметр, если location @type имеет значение City.
location.address.streetAddress Текст Адрес места расположения.
location.address.addressLocality Текст Город, в котором находится данное место.
location.address.addressRegion Текст Состояние местности.
location.address.postalCode Текст Почтовый индекс населенного пункта.
location.address.addressCountry Текст Страны в формате ISO 3166 .
image ImageObject Для Google TV требуется изображение (изображения), относящееся к мероприятию. Рекомендуется использовать официальный постер или баннер мероприятия. Более подробную информацию об обязательных и необязательных свойствах image см. в разделе «Свойства изображения» .
potentialAction WatchAction Обязательно, если применимо — прямая ссылка, которая воспроизводит запись этого спортивного события в режиме «Видео по запросу». Чтобы указать прямую ссылку для прямого эфира, используйте свойства publishedOn или potentialAction в BroadcastEvent .
identifier Стоимость недвижимости Настоятельно рекомендуется. Почему? — Внешний или иной идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. раздел «Свойства идентификатора» .

SportsEvent examples

Пример командного вида спорта

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

Individual Sports Example

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

Спортивное мероприятие с ограничениями 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"
            ]
          },
        ]
      }
    }
  ]
}

Спецификация таблицы MusicEvent

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx на код языка сущности в формате BCP 47 , например, "en".
@type Текст Required - Always set to MusicEvent .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id must meet the following requirements:
  • Globally unique across your catalog
  • Статический
  • In the form of Unified Resource Identifier (URI)
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
name Текст Required - The name of this event.
  • Используйте массив для перечисления имен на разных языках. См. пример " Несколько регионов и языков" .
  • Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
description Текст Описание события. Ограничение в 300 символов. Используйте массив для включения описаний на разных языках и различной длины.
attendee Организация или лицо Лицо или организация, участвующие в мероприятии.
startDate Дата Обязательно — время начала мероприятия в формате ISO 8601 с указанием часового пояса.
endDate Дата Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
composer Организация или лицо Лицо или организация, написавшие музыкальное произведение или являющиеся композиторами произведения, исполненного на каком-либо мероприятии.
performer Организация или лицо Обязательно – Участник мероприятия, например, докладчик, музыкант, музыкальная группа или актёр.
subEvent Событие Мероприятие, являющееся частью этого мероприятия. Например, конференция включает в себя множество презентаций, каждая из которых является подмероприятием конференции.
superEvent Событие Событие, частью которого является данное событие. Например, у каждого из отдельных музыкальных выступлений может быть свой суперсобытие — музыкальный фестиваль.
location Place OR City Обязательно — укажите место проведения мероприятия.
location.name Текст Обязательно — название местоположения.
location.address Почтовый адрес Обязательно, если location @type имеет значение Place — адрес местоположения. Не следует использовать этот параметр, если location @type имеет значение City.
location.address.streetAddress Текст Адрес места расположения.
location.address.addressLocality Текст The city of the location.
location.address.addressRegion Текст The state of the location.
location.address.postalCode Текст Почтовый индекс населенного пункта.
location.address.addressCountry Текст Страны в формате ISO 3166 .
workPerformed Творческая работа Произведение, исполненное в рамках какого-либо мероприятия, например, пьеса, поставленная на театральном мероприятии.

Пример 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"
  }
}

Таблица спецификаций событий

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx на код языка сущности в формате BCP 47 , например, "en".
@type Текст Обязательно - Всегда устанавливайте значение Event .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id must meet the following requirements:
  • Уникальный дизайн во всем вашем каталоге.
  • Статический
  • В форме унифицированного идентификатора ресурса (URI)
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
name Текст Обязательно — Название мероприятия.
  • Используйте массив для перечисления имен на разных языках. См. пример " Несколько регионов и языков" .
  • Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
description Текст Описание события. Ограничение в 300 символов. Используйте массив для включения описаний на разных языках и различной длины.
attendee Организация или лицо Лицо или организация, участвующие в мероприятии.
startDate Дата Обязательно — время начала мероприятия в формате ISO 8601 с указанием часового пояса.
endDate Дата Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
subEvent Событие Мероприятие, являющееся частью этого мероприятия. Например, конференция включает в себя множество презентаций, каждая из которых является подмероприятием конференции.
superEvent Событие Событие, частью которого является данное событие. Например, у каждого из отдельных музыкальных выступлений может быть свой суперсобытие — музыкальный фестиваль.
releasedEvent PublicationEvent , FeaturedEvent или ExclusiveEvent Настоятельно рекомендуется. Почему?PublicationEvent используется для указания первоначального (глобального или локального) выпуска контента издателем, например, первоначальной даты выхода фильма в прокат.

Кроме того, используйте FeaturedEvent , чтобы указать, что ваша служба позиционирует этот контент как оригинальный, рекомендуемый, специальный и так далее.

ExclusiveEvent указывает, что ваша услуга обладает исключительными правами на распространение, и включает в себя информацию о месте и времени распространения.

Подробности и примеры см. в разделе «Примеры» .
releasedEvent.@type Текст Обязательно — всегда устанавливайте для этого свойства одно из следующих значений:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Страна Обязательно — регионы, связанные с этим событием.

Для PublicationEvent ) это регион, где был опубликован контент.

Для FeaturedEvent и ExclusiveEvent это регион, где контент является рекомендуемым или эксклюзивным.

Для обозначения стран используйте коды ISO 3166. Чтобы указать всю страну в мире, выберите EARTH .
releasedEvent.startDate Дата или дата/время Рекомендуется - Обязательно для ExclusiveEvent - Дата начала публикации организации.

Для PublicationEvent это обозначает дату первоначального выпуска данного объекта, например, дату первого показа фильма в кинотеатрах.

Для ExclusiveEvent и FeaturedEvent это обозначает дату начала действия эксклюзивного или рекомендуемого статуса мероприятия.
releasedEvent.endDate Дата или дата/время Рекомендуется - Обязательно для ExclusiveEvent - Это применимо только к типам ExclusiveEvent и FeaturedEvent .

Для ExclusiveEvent это обозначает дату истечения срока действия прав на контент.

Для FeaturedEvent это означает последнюю дату, когда провайдер размещает информацию о данном объекте.

Если контент является эксклюзивным или постоянно публикуется, установите endDate равным 20 годам от текущей даты.
releasedEvent.publishedBy Организация или лицо (Необязательно) — Организация или лицо, опубликовавшее данный документ.
location Place OR City Обязательно — укажите место проведения мероприятия. Обратите внимание, что вы можете указать Place на уровне City .
location.name Текст Обязательно — название местоположения.
location.address Почтовый адрес Обязательно, если location @type имеет значение Place — адрес местоположения. Не следует использовать этот параметр, если location @type имеет значение City.
location.address.streetAddress Текст Адрес места расположения.
location.address.addressLocality Текст The city of the location.
location.address.addressRegion Текст The state of the location.
location.address.postalCode Текст The postal code of the location.
location.address.addressCountry Текст The countries in ISO 3166 format .
workPerformed Творческая работа Произведение, исполненное в рамках какого-либо мероприятия, например, пьеса, поставленная на театральном мероприятии.

Event example

Событие

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