Свойства разметки контента событий,Свойства разметки контента событий

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

Таблица технических характеристик SportsEvent

Свойство Ожидаемый тип Описание
@context Текст Обязательно – всегда установлено значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx кодом языка объекта в формате BCP 47 , например, «en».
@type Текст Обязательно — всегда установлено значение SportsEvent .
@id URL-адрес Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Глобальная уникальность в вашем каталоге
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство URL-адреса шоу). Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде единого идентификатора ресурса (URI).
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» .
name Текст Обязательно — название этого события.
  • Используйте массив для перечисления имен на разных языках. См. пример нескольких регионов и языков .
  • Обратите внимание, что для каждой локали поддерживается только одно имя (пара язык-страна).
description Текст Описание этого события. Лимит на 300 символов. Используйте массив, чтобы включить описания на разных языках и разной длины.
sport URL-адрес Обязательно Ссылка на страницу Википедии (предпочтительна английская версия) этого вида спорта.
startDate ДатаВремя или Дата Обязательно — время начала мероприятия в формате ISO 8601 с указанием часового пояса. Обратите внимание, что это фактическое время начала мероприятия, а не время его трансляции по телевидению.
endDate ДатаВремя или Дата Время окончания события в формате ISO 8601 с часовым поясом.
homeTeam Спортивная команда Настоятельно рекомендуется Почему? Хозяева турнира.
homeTeam.name Текст Обязательно Полное название спортивной команды.
homeTeam.sport URL-адрес Обязательно Ссылка на страницу Википедии (предпочтительна английская версия) этого вида спорта.
homeTeam.sameAs URL-адрес Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, по которой можно идентифицировать команду; например, страница команды в Википедии.
homeTeam.athlete Человек Аннотация(я) для отдельного спортсмена в команде.
homeTeam.athlete.name Текст Полное имя спортсмена.
homeTeam.parentOrganization.name СпортОрганизация Обязательно Название спортивной лиги, в которой участвует команда. Например, Национальная баскетбольная ассоциация или Высшая бейсбольная лига. Обратите внимание, что это поле не следует использовать для конференции команды.
homeTeam.parentOrganization.sameAs URL-адрес Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, на которой можно определить лигу команды; например, страница лиги в Википедии.
awayTeam Спортивная команда Настоятельно рекомендуется Почему? Гости мероприятия. Свойства такие же, как у SportsEvent.homeTeam .
competitor Спортивная команда или человек Настоятельно рекомендуется Почему? Если команда хозяев или гостей не применима (например, боксерский поединок, Олимпийские игры), укажите участников в качестве участников. Если SportsTeam , свойства такие же, как у SportsEvent.homeTeam . Если Person , свойства такие же, как и у других объектов Person ; например, актер в Movie .
location Место ИЛИ Город Место проведения мероприятия.
location.name Текст Обязательно – Название локации.
location.address Почтовый адрес Обязательно, если местоположение @type имеет значение «Место» — адрес местоположения. Это не следует использовать, если местоположение @type — это город.
location.address.streetAddress Текст Уличный адрес места.
location.address.addressLocality Текст Город локации.
location.address.addressRegion Текст Состояние локации.
location.address.postalCode Текст Почтовый индекс места.
location.address.addressCountry Текст Страны в формате ISO 3166 .
image Объект изображения Обязательно для Google TV — изображения, связанные с событием. Рекомендуется использовать в качестве официального плаката или баннера мероприятия. Дополнительные сведения об обязательных и необязательных свойствах, включаемых в image , см. в разделе Свойства изображения .
potentialAction СмотретьДействие Обязательно, если применимо : глубокая ссылка, по которой воспроизводится запись этого спортивного мероприятия в режиме «Видео по запросу». Чтобы указать глубокую ссылку для события в реальном времени, вместо этого используйте publishedOn или potentialAction в BroadcastEvent .
identifier СвойствоЗначение Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данную сущность. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора .

Примеры спортивных мероприятий

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

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

Таблица спецификации MusicEvent

Свойство Ожидаемый тип Описание
@context Текст Обязательно – всегда установлено значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx кодом языка объекта в формате BCP 47 , например, «en».
@type Текст Обязательно — всегда установлено значение MusicEvent .
@id URL-адрес Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Глобальная уникальность в вашем каталоге
  • Статический
  • В виде единого идентификатора ресурса (URI).
Поскольку url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» .
name Текст Обязательно — название этого события.
  • Используйте массив для перечисления имен на разных языках. См. пример нескольких регионов и языков .
  • Обратите внимание, что для каждой локали поддерживается только одно имя (пара язык-страна).
description Текст Описание события. Лимит на 300 символов. Используйте массив, чтобы включить описания на разных языках и разной длины.
attendee Организация или человек Лицо или организация, присутствовавшая на мероприятии.
startDate Дата Обязательно — время начала мероприятия в формате ISO 8601 с указанием часового пояса.
endDate Дата Время окончания события в формате ISO 8601 с часовым поясом.
composer Организация или человек Человек или организация, написавшая композицию или являющаяся композитором произведения, исполненного на каком-либо мероприятии.
performer Организация или человек Обязательно — Исполнитель на мероприятии — например, ведущий, музыкант, музыкальная группа или актер.
subEvent Событие Событие, которое является частью этого события. Например, событие конференции включает в себя множество презентаций, каждая из которых является подсобытием конференции.
superEvent Событие Событие, частью которого является это событие. Например, каждое из отдельных музыкальных представлений может иметь музыкальный фестиваль в качестве суперсобытия.
location Место ИЛИ Город Обязательно – Место проведения мероприятия.
location.name Текст Обязательно – Название локации.
location.address Почтовый адрес Обязательно, если местоположение @type имеет значение «Место» — адрес местоположения. Это не следует использовать, если местоположение @type — это город.
location.address.streetAddress Текст Уличный адрес места.
location.address.addressLocality Текст Город локации.
location.address.addressRegion Текст Состояние локации.
location.address.postalCode Текст Почтовый индекс места.
location.address.addressCountry Текст Страны в формате ISO 3166 .
workPerformed КреативРабота Произведение, исполненное на каком-либо мероприятии, например спектакль, представленный на TheaterEvent.

Пример музыкального события

МузыкаСобытие 

{
  "@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 должен соответствовать следующим требованиям:
  • Глобальная уникальность в вашем каталоге
  • Статический
  • В виде единого идентификатора ресурса (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 в City .
location.name Текст Обязательно – Название локации.
location.address Почтовый адрес Обязательно, если местоположение @type имеет значение «Место» — адрес местоположения. Это не следует использовать, если местоположение @type — это город.
location.address.streetAddress Текст Уличный адрес места.
location.address.addressLocality Текст Город локации.
location.address.addressRegion Текст Состояние локации.
location.address.postalCode Текст Почтовый индекс места.
location.address.addressCountry Текст Страны в формате ISO 3166 .
workPerformed КреативРабота Произведение, исполненное на каком-либо мероприятии, например спектакль, представленный на TheaterEvent.

Пример события

Событие 

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