Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

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

Таблица спецификаций SportsEvent

Свойство	Ожидаемый тип	Описание
`@context`	Текст	Обязательный атрибут. Всегда указывайте значение `["http://schema.org", {"@language": "xx"}]` . Замените `xx` кодом языка объекта в формате BCP 47, например "en".
`@type`	Текст	Обязательный параметр. Всегда имеет значение `SportsEvent`.
`@id`	URL	Обязательное свойство. Идентификатор контента в формате URI, например https://example.com/1234abc. `@id`Должно соответствовать следующим требованиям: Уникальный в рамках каталога (и отличающийся от значения `@id` любого элемента `BroadcastEvent`, ссылающегося на этот элемент `SportsEvent`). Статичный. Идентификатор не должен меняться со временем. Он интерпретируется как непрозрачная строка, поэтому рабочую ссылку указывать необязательно. В формате унифицированного идентификатора ресурса (URI) Домен, указанный в идентификаторе `@id`, должен принадлежать вашей организации. Важно! Не добавляйте свойство `url` в `SportsEvent` или `BroadcastEvent`. Укажите ссылки на воспроизведение с помощью свойства `SportsEvent.potentialAction`. Подробную информацию вы найдете в разделе Идентификатор.
`name`	Текст	Обязательное свойство. Название события. Используйте массив, чтобы перечислить названия на разных языках. См. пример Несколько регионов и языков. Обратите внимание, что для каждого региона (пары язык-страна) поддерживается только одно название.
`description`	Текст	Описание события. Ограничение на количество символов: 300. Чтобы добавить описания на нескольких языках, используйте массив (по одному описанию на язык).
`sport`	URL	Обязательное свойство. Ссылка на страницу в Википедии, посвященную виду спорта (желательно на английском языке).
`startDate`	DateTime или Date	Обязательное свойство. Время начала мероприятия в формате ISO 8601 с указанием часового пояса. Обратите внимание, что это фактическое время начала события, а не время его трансляции по телевидению.
`endDate`	DateTime или Date	Рекомендуемое свойство. Запланированное время окончания мероприятия в формате ISO 8601 с указанием часового пояса. Укажите запланированное время окончания, если оно известно. Если время окончания неизвестно, опустите это свойство, а не указывайте приблизительный плейсхолдер.
`homeTeam`	SportsTeam	Настоятельно рекомендуется. Почему? Команда, играющая на своем поле.
`homeTeam.name`	Текст	Обязательное свойство. Полное название спортивной команды.
`homeTeam.sport`	URL	Обязательное свойство. Ссылка на страницу в Википедии, посвященную виду спорта (желательно на английском языке).
`homeTeam.sameAs`	URL	Настоятельно рекомендуется. Почему? URL веб-страницы с подробной информацией, которая позволяет идентифицировать команду, например страницы в Википедии.
`homeTeam.athlete`	Person	Описание отдельного спортсмена в команде.
`homeTeam.athlete.name`	Текст	Полное имя спортсмена.
`homeTeam.parentOrganization`	SportsOrganization	Обязательное свойство. Спортивная лига или руководящая организация, к которой относится команда. Если указаны обе команды, добавьте `parentOrganization` в `homeTeam` и `awayTeam`.
`homeTeam.parentOrganization.name`	Текст	Обязательное свойство. Название спортивной лиги, в которой состоит команда. Например, Национальная баскетбольная ассоциация или Главная лига бейсбола. Обратите внимание, что это поле не следует использовать для конференций команды.
`homeTeam.parentOrganization.sameAs`	URL	Настоятельно рекомендуется. Почему? – Ссылка на страницу в Википедии (желательно на английском языке), на которой указана лига команды (например, `https://en.wikipedia.org/wiki/National_Basketball_Association`). Не используйте URL-плейсхолдеры `example.com`.
`awayTeam`	SportsTeam	Настоятельно рекомендуется. Почему? - Команда гостей. Свойства и требования (в том числе `parentOrganization`) такие же, как и для `SportsEvent.homeTeam`.
`competitor`	SportsTeam или Person	Настоятельно рекомендуется. Почему? Если понятия "хозяева" и "гости" неприменимы (например, в боксе или на Олимпийских играх), укажите участников как соперников. Если `SportsTeam`, свойства такие же, как у `SportsEvent.homeTeam`. Если `Person`, то свойства такие же, как у других объектов `Person`, например у актера в `Movie`.
`location`	Место или Город	Место проведения мероприятия.
`location.name`	Текст	Обязательный атрибут. Название местоположения.
`location.address`	PostalAddress	Обязательно, если для свойства @type указано значение Place. Адрес места проведения мероприятия. Не используйте это свойство, если в свойстве @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	Обязательно, если применимо. Ссылки на контент для воспроизведения спортивного события. Используются как для прямых трансляций без каналов, так и для повторов видео по запросу. Все ссылки на контент спортивных событий должны находиться в `SportsEvent.potentialAction`. Никогда не размещайте `potentialAction` в `BroadcastEvent`, который ссылается на `SportsEvent` (для трансляций линейного ТВ без прямой ссылки на контент события укажите ссылку на контент канала в `BroadcastService.potentialAction`). Если вы предлагаете несколько трансляций (например, региональные, домашние или выездные, или многоязычные) или отдельные окна воспроизведения в прямом эфире и видео по запросу, укажите массив объектов `WatchAction`.
`potentialAction.actionAccessibilityRequirement`	ActionAccessSpecification	Обязательно, если указано значение `potentialAction`. Определяет право на просмотр и период доступности (`availabilityStarts` и `availabilityEnds`) для каждого значения `WatchAction`: Окно перед началом трансляции (`availabilityStarts`). Для спортивных трансляций задайте значение `availabilityStarts` не менее чем за 14 дней до `SportsEvent.startDate` (`availabilityStarts <= SportsEvent.startDate - 14 days`), чтобы карточки предстоящих событий могли появляться заранее. Сам объект события можно передать ближе к дню игры, если временная метка `availabilityStarts` установлена не менее чем за 14 дней до `startDate`. Буфер для овертайма (`availabilityEnds`). Установите `availabilityEnds` после `SportsEvent.endDate` с буфером не менее 2–3 часов (`availabilityEnds >= SportsEvent.endDate + 2 to 3 hours` или до конца окна повтора видео по запросу), чтобы ссылки на контент не перестали работать во время овертайма или послематчевого анализа. Подробную информацию вы найдете в статье Свойства разметки действий.
`identifier`	PropertyValue	Настоятельно рекомендуется. Почему? - Внешний или другой идентификатор, позволяющий точно идентифицировать объект. Идентификаторов может быть несколько. Подробную информацию вы найдете в разделе Свойства идентификатора.

Примеры разметки SportsEvent

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

{
  "@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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

Пример для индивидуальных спортивных каналов

{
  "@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",
  "endDate": "2019-07-12T23:30-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 с ограничениями 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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`	Текст	Обязательный параметр. Всегда имеет значение `MusicEvent`.
`@id`	URL	Обязательное свойство. Идентификатор контента в формате URI, например https://example.com/1234abc. `@id` должен соответствовать следующим требованиям: Уникальный в пределах каталога. Статический В формате унифицированного идентификатора ресурса (URI) Поскольку `url` объекта соответствует всем требованиям к идентификатору, мы рекомендуем использовать `url` объекта в качестве `@id`. Подробную информацию вы найдете в разделе Идентификатор.
`name`	Текст	Обязательное свойство. Название события. Используйте массив, чтобы перечислить названия на разных языках. См. пример Несколько регионов и языков. Обратите внимание, что для каждого региона (пары язык-страна) поддерживается только одно название.
`description`	Текст	Описание мероприятия. Максимальная длина – 300 символов. Используйте массив, чтобы добавить описания разной длины на нескольких языках.
`attendee`	Organization или Person	Человек или организация, участвующие в мероприятии.
`startDate`	Дата	Обязательное свойство. Время начала мероприятия в формате ISO 8601 с указанием часового пояса.
`endDate`	Дата	Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
`composer`	Organization или Person	Человек или организация, которые написали композицию или являются авторами произведения, исполняемого на мероприятии.
`performer`	Organization или Person	Обязательное свойство. Исполнитель, выступающий на мероприятии, например докладчик, музыкант, музыкальная группа или актер.
`subEvent`	Мероприятие	Событие, которое является частью этого события. Например, конференция включает в себя несколько презентаций, каждая из которых является дочерним мероприятием.
`superEvent`	Мероприятие	Событие, частью которого является данное событие. Например, для отдельных выступлений на музыкальном фестивале в качестве superEvent можно указать сам фестиваль.
`location`	Место или Город	Обязательный атрибут. Место проведения мероприятия.
`location.name`	Текст	Обязательный атрибут. Название местоположения.
`location.address`	PostalAddress	Обязательно, если для свойства @type указано значение Place. Адрес места проведения мероприятия. Не используйте это свойство, если для свойства @type указано значение City.
`location.address.streetAddress`	Текст	Почтовый адрес местоположения.
`location.address.addressLocality`	Текст	Город, в котором находится местоположение.
`location.address.addressRegion`	Текст	Штат, в котором находится местоположение.
`location.address.postalCode`	Текст	Почтовый индекс местоположения.
`location.address.addressCountry`	Текст	Страны в формате ISO 3166.
`workPerformed`	CreativeWork	Произведение, исполняемое в рамках какого-либо события, например пьеса, исполняемая в рамках события TheaterEvent.

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

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

Свойство	Ожидаемый тип	Описание
`@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`	Organization или Person	Человек или организация, участвующие в мероприятии.
`startDate`	Дата	Обязательное свойство. Время начала мероприятия в формате ISO 8601 с указанием часового пояса.
`endDate`	Дата	Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
`subEvent`	Мероприятие	Событие, которое является частью этого события. Например, конференция включает в себя несколько презентаций, каждая из которых является дочерним мероприятием.
`superEvent`	Мероприятие	Событие, частью которого является данное событие. Например, для отдельных выступлений на музыкальном фестивале в качестве superEvent можно указать сам фестиваль.
`releasedEvent`	`PublicationEvent`, `FeaturedEvent` или `ExclusiveEvent`	Настоятельно рекомендуется. Почему? – `PublicationEvent` используется для указания даты выпуска оригинального (глобального или локального) контента издателем, например даты выхода фильма в кинотеатрах. Кроме того, используйте `FeaturedEvent`, чтобы указать, что ваш сервис продвигает этот контент как оригинальный, рекомендуемый, специальный и т. д. `ExclusiveEvent` указывает, что у вашего сервиса есть эксклюзивные права на распространение, а также где и когда. Подробности и примеры см. в разделе с примерами.
`releasedEvent.@type`	Текст	Обязательное свойство. Укажите одно из следующих значений: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Страна	Обязательное свойство. Регионы, связанные с событием. Для `PublicationEvent` это регион, в котором опубликован контент. Для `FeaturedEvent` и `ExclusiveEvent` это регион, в котором контент является рекомендуемым или эксклюзивным. Используйте коды стран по стандарту ISO 3166. Чтобы указать все страны мира, задайте значение `EARTH`.
`releasedEvent.startDate`	Date или DateTime	Рекомендуется – обязательно для `ExclusiveEvent` – дата начала публикации объекта. Для `PublicationEvent` это дата первоначального выпуска объекта, например дата выхода фильма в кинотеатрах. Для `ExclusiveEvent` и `FeaturedEvent` это дата начала эксклюзивного или рекомендуемого показа объекта.
`releasedEvent.endDate`	Date или DateTime	Рекомендуется – обязательно для `ExclusiveEvent`. Применимо только к типам `ExclusiveEvent` и `FeaturedEvent`. Для `ExclusiveEvent` это дата, когда истекают права на контент. Для `FeaturedEvent` это последний день, когда поставщик продвигает объект. Если контент является эксклюзивным или продвигается бессрочно, укажите в качестве значения `endDate` дату через 20 лет от текущей.
`releasedEvent.publishedBy`	Organization или Person	Необязательное свойство. Организация или физическое лицо, опубликовавшее объект.
`location`	Место или Город	Обязательный атрибут. Место проведения мероприятия. Обратите внимание, что свойство `Place` можно указать на уровне `City`.
`location.name`	Текст	Обязательный атрибут. Название местоположения.
`location.address`	PostalAddress	Обязательно, если для свойства @type указано значение Place. Адрес места проведения мероприятия. Не используйте это свойство, если для свойства @type указано значение City.
`location.address.streetAddress`	Текст	Почтовый адрес местоположения.
`location.address.addressLocality`	Текст	Город, в котором находится местоположение.
`location.address.addressRegion`	Текст	Штат, в котором находится местоположение.
`location.address.postalCode`	Текст	Почтовый индекс местоположения.
`location.address.addressCountry`	Текст	Страны в формате ISO 3166.
`workPerformed`	CreativeWork	Произведение, исполняемое в рамках какого-либо события, например пьеса, исполняемая в рамках события 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"
  }
}