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

В этом разделе приведены сведения о свойствах разметки контента для типа объектов BroadcastEvent. Чтобы лучше понять, как связаны эти типы, ознакомьтесь с концепциями LiveTV Events.

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

Свойство Ожидаемый тип Описание
@context Текст Обязательный атрибут. Всегда указывайте значение ["http://schema.org", {"@language": "xx"}]
    .
  • Замените xx кодом языка объекта в формате BCP 47, например "en".
@type Текст Обязательный параметр. Всегда имеет значение BroadcastEvent.
@id URL Обязательное свойство. Идентификатор интервала трансляции в формате URI, например https://example.com/live/channel1/20191012T2100.
@id должен соответствовать следующим требованиям:
  • Уникальный в рамках каталога и отличающийся от workPerformed.@id или broadcastOfEvent.@id (например, включающий канал/сервис и время начала трансляции).
  • Статичный. Идентификатор не должен меняться со временем. Он интерпретируется как непрозрачная строка, поэтому рабочую ссылку указывать необязательно.
  • В формате унифицированного идентификатора ресурса (URI)
  • Домен, указанный в идентификаторе @id, должен принадлежать вашей организации.
Важно! Не добавляйте свойство url в BroadcastEvent или SportsEvent. Указывайте канонический идентификатор url только для основного объекта контента (Movie, TVSeries или TVEpisode). Подробную информацию вы найдете в разделе Идентификатор.
name Текст Обязательное свойство. Название шоу или мероприятия.
description Текст Описание шоу или мероприятия. Ограничение на количество символов: 300. Чтобы добавить описания на нескольких языках, используйте массив (по одному описанию на язык).
startDate Дата Обязательное свойство. Время начала мероприятия в формате ISO 8601 с указанием часового пояса.
endDate Дата Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
publishedOn BroadcastService Обязательное свойство, если применимо. Укажите объект BroadcastService, который транслирует это шоу или мероприятие.

Если контент транслируется по телеканалу, это свойство является обязательным. Если контент не связан с телеканалом, не указывайте это свойство.
publishedOn.@type Текст Должно иметь значение BroadcastService.
publishedOn.@id URL @id объекта BroadcastService, который транслирует это шоу или событие.
workPerformed CreativeWork Обязательно, если применимо. Используйте это свойство, если контент относится к одному из следующих типов объектов: Movie, TVSeries и TVEpisode.
Настоятельно рекомендуем, чтобы объект BroadcastEvent включал хотя бы одно из следующих свойств:
  • workPerformed
  • broadcastOfEvent
  • Адрес "true" сохранен с ярлыком "contentToBeAnnounced".
  • Адрес "true" сохранен с ярлыком "offAir".
workPerformed.@type Текст Должно иметь значение Movie, TVSeries или TVEpisode.
workPerformed.@id URL @id объекта контента.
broadcastOfEvent SportsEvent Обязательное свойство, если применимо. Используйте это свойство, если контент представляет собой прямую трансляцию.
  • Для спортивного мероприятия это свойство должно ссылаться на объект SportsEvent.

Настоятельно рекомендуется, чтобы объект BroadcastEvent включал хотя бы один из следующих элементов:
  • workPerformed
  • broadcastOfEvent
  • Адрес "true" сохранен с ярлыком "contentToBeAnnounced".
  • Адрес "true" сохранен с ярлыком "offAir".
broadcastOfEvent.@type Текст Должно иметь значение SportsEvent.
broadcastOfEvent.@id URL @id объекта события. Объект события должен существовать в фиде и иметь значение @id, отличное от значения BroadcastEvent.
location Текст или Страна Обязательное свойство, если объект BroadcastEvent относится к объекту SportsEvent, то есть содержит свойство broadcastOfEvent. Страна, в которой может транслироваться спортивное событие. Если трансляция SportsEvent доступна в нескольких странах, в этом поле можно указать их список.
videoFormat Текст Максимальное качество, поддерживаемое этим сервисом трансляции, например
  • SD – стандартное разрешение.
  • HD – высокое разрешение.
  • "2K" для разрешения 2K.
  • "4K" для разрешения 4K.
  • 8K для разрешения 8K.
contentToBeAnnounced Логическое значение Обязательное свойство, если применимо. Используйте это свойство, если контент неизвестен на момент создания фида.

Укажите значение true, если у поставщика нет актуальной информации о том, что будет транслироваться, и false в противном случае.
Настоятельно рекомендуем, чтобы объект BroadcastEvent включал хотя бы одно из следующих свойств:
  • workPerformed
  • broadcastOfEvent
  • Адрес "true" сохранен с ярлыком "contentToBeAnnounced".
  • Адрес "true" сохранен с ярлыком "offAir".
offAir Логическое значение Обязательный, если применимо. Укажите значение true, если в определенный временной интервал на канале BroadcastService не планируется трансляция контента.
  • Задайте для параметров name и description значение "Off Air".
  • Каждый offAir BroadcastEvent должен охватывать не более 4 часов (не передавайте непрерывные 24-часовые блоки). Если канал не работает более четырех часов, создайте несколько смежных, неперекрывающихся объектов BroadcastEvent, каждый из которых длится не более четырех часов. Это позволит поддерживать полное круглосуточное расписание канала без пробелов в начале или конце окна фида.
Настоятельно рекомендуется, чтобы объект BroadcastEvent включал хотя бы один из следующих элементов:
  • workPerformed
  • broadcastOfEvent
  • Адрес "true" сохранен с ярлыком "contentToBeAnnounced".
  • Адрес "true" сохранен с ярлыком "offAir".
isLiveBroadcast Логическое значение Укажите логическое значение true (без кавычек), если это прямая трансляция (например, спортивного матча или выпуска новостей), или false, если это не прямая трансляция или повтор.
potentialAction WatchAction Обязательно, если применимо. Никогда не указывайте potentialAction в BroadcastEvent, если broadcastOfEvent ссылается на SportsEvent (указывайте все ссылки на спортивный контент в SportsEvent.potentialAction) или если publishedOn ссылается на канал BroadcastService (указывайте ссылки на каналы в BroadcastService.potentialAction). Указывайте BroadcastEvent.potentialAction только для трансляций без каналов, которые не ссылаются на SportsEvent (например, для отдельного дополнительного контента трансляции, в котором опущены contentToBeAnnounced и offAir или false).
identifier PropertyValue Внешний идентификатор, позволяющий определить транслируемый контент. Подробную информацию вы найдете в разделе Свойства идентификатора.
  • Примечание. Для типа объекта BroadcastEvent в качестве значения propertyID можно указать только TMS_ID или TMS_ROOT_ID.
  • Это свойство следует указывать только в том случае, если на полностью сформированный объект верхнего уровня Movie, TVSeries, TVEpisode или SportsEvent нет ссылки с помощью свойства workPerformed или broadcastOfEvent.
  • Значение свойства должно отражать TMS_ID или TMS_ROOT_ID элемента Movie, TVSeries, TVEpisode или SportsEvent, на который вы в идеале ссылались бы с помощью свойства workPerformed или broadcastOfEvent.
  • Значение TMS_ID предпочтительнее, чем TMS_ROOT_ID.
contentRating Текст или Оценка Обязательно для контента для взрослых, в остальных случаях настоятельно рекомендуется. Подробнее… - Общее возрастное ограничение для транслируемого контента. Если возрастное ограничение указано в виде текстовой строки, принимаются два варианта:
  • Название агентства, присвоившего рейтинг, указывается перед рейтингом и отделяется от него пробелом. Например, возрастное ограничение PG-13, установленное организацией MPAA в США, должно быть указано как MPAA PG-13. Ознакомьтесь со списком агентств.
  • Значение RATING NOT KNOWN (без учета регистра), если вы не знаете возрастное ограничение для фильма.
contentRating.author Организация Обязательный, если в атрибуте contentRating используется значение Rating. Название организации, присвоившей возрастной рейтинг.
contentRating.ratingValue Текст Обязательно, если для атрибута "система возрастных ограничений" contentRating указано значение Rating. Значение возрастного ограничения.
contentRating.advisoryCode Текст Код предупреждения для контента. Допустимые значения: D, FV, L, S и V. D – диалоги, FV – фантастическое насилие, L – язык, S – контент сексуального характера, V – насилие.

Примеры

Серия телесериала транслируется по телеканалу Example TV (BroadcastService) 12 октября 2019 г. с 21:00 до 21:30:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live/event/my_favorite_tv_series/new_episode",
  "name": "My Favorite TV Series - Season 6 - Episode 2 - Three Mice",
  "description": "Three mice leave the town and the trip turns into something more.",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "workPerformed": {
    "@type": "TVEpisode",
    "@id": "http://example.com/tv_series/my_favorite_tv_series/s6/e2_three_mice"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Пример использования свойства contentToBeAnnounced, когда контент, который будет транслироваться по телевизионной сети Example TV (BroadcastService) с 21:00 до 21:30 12 октября 2019 года, неизвестен на момент создания фида:

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId",
  "name": "Content To Be Announced",
  "description": "Content To Be Announced",
  "startDate": "2019-10-12T21:00-08:00",
  "endDate": "2019-10-12T21:30-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "contentToBeAnnounced": true
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Телевизионная сеть Example TV (BroadcastService) не ведет вещание с 12:00 до 20:00 (моделируется как два смежных четырехчасовых блока Off Air) и транслирует одну передачу My favorite show с 20:00 до 00:00.

BroadcastEvent 

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId1",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T12:00-08:00",
  "endDate": "2019-10-12T16:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId2",
  "name": "Off Air",
  "description": "Off Air",
  "startDate": "2019-10-12T16:00-08:00",
  "endDate": "2019-10-12T20:00-08:00",
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "offAir": true
},
{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/randomUniqueEventId3",
  "name": "My favorite show",
  "description": "Evening broadcast of My favorite show.",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "workPerformed": {
    "@type": "TVSeries",
    "@id": "http://example.com/tv_series/my_favorite_show"
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  }
}

BroadcastService 

{
  "@context":"http://schema.org",
  "@type":"BroadcastService",
  "@id":"http://example.com/stations/example_tv",
  "name":"EXAMPLE-TV",
  "broadcastDisplayName":"ABCD",
  "callSign": "EXA-TV",
  "videoFormat":"SD",
  "broadcastTimezone":"America/Los_Angeles",
  "broadcastAffiliateOf":{
    "@type":"Organization",
    "@id":"http://example.com/networks/abcd-network"
  },
  "identifier": [
   {
     "@type": "PropertyValue",
     "propertyID": "TMS_ID",
     "value": "12258"
   },
   {
     "@type": "PropertyValue",
     "propertyID": "_PARTNER_ID_",
     "value": "exampletv-123456"
   }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://example.com/livestream",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast",
        "http://schema.org/AndroidTVPlatform"
      ]
    },
    "actionAccessibilityRequirement": {
      "@type": "ActionAccessSpecification",
      "category": "externalsubscription",
      "availabilityStarts": "2018-07-21T10:35:29Z",
      "availabilityEnds": "2019-10-21T10:35:29Z",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "@id": "http://example.com/subscription",
        "name": "ABCD",
        "sameAs": "http://example.com/subscription",
        "identifier": "example.com:basic",
        "commonTier": false
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Дополнительную информацию по этим свойствам можно найти на следующих страницах: