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

В этом разделе подробно описаны свойства разметки содержимого для типа сущности BroadcastEvent . Для лучшего понимания взаимосвязи между этими типами ознакомьтесь с концепциями событий LiveTV .

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

Свойство Ожидаемый тип Описание
@context Текст Обязательно - Всегда устанавливайте значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx на код языка сущности в формате BCP 47 , например, "en".
@type Текст Обязательно - Всегда устанавливайте значение BroadcastEvent .
@id URL Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Уникальный дизайн во всем вашем каталоге.
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство url объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой.
  • В форме унифицированного идентификатора ресурса (URI)
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать url сущности в формате @id . Более подробную информацию см. в разделе «Идентификатор» .
name Текст Обязательно — название шоу или мероприятия.
description Текст Описание шоу или мероприятия. Ограничение в 300 символов. Используйте массив для включения описаний на нескольких языках и различной длины.
startDate Дата Обязательно — время начала мероприятия в формате ISO 8601 с указанием часового пояса.
endDate Дата Время окончания мероприятия в формате ISO 8601 с указанием часового пояса.
publishedOn Вещание Обязательно, если применимо — укажите сущность BroadcastService , которая транслирует эту передачу или событие.

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

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

Если у поставщика нет актуальной информации о том, что будет транслироваться, установите значение true , в противном случае false .
Настоятельно рекомендуется, чтобы сущность BroadcastEvent включала как минимум один из следующих элементов:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced установить значение true
  • offAir установлено в true
offAir Логический Обязательно, если применимо . Используйте это свойство, если на данный временной интервал не планируется трансляция контента.
Настоятельно рекомендуется, чтобы сущность BroadcastEvent включала как минимум один из следующих элементов:
  • workPerformed
  • broadcastOfEvent
  • contentToBeAnnounced установить значение true
  • offAir установлено в true
isLiveBroadcast Логический Установите значение true , если это прямая трансляция, например, спортивное событие или концерт.
potentialAction WatchAction Обязательно, если применимо . Если контент транслируется в формате прямой трансляции без канала (с contentToBeAnnounced , установленным на false , или offAir установленным на false ), используйте это свойство для указания прямой ссылки на событие.
identifier Стоимость недвижимости Внешний идентификатор, определяющий содержимое транслируемого контента. Подробности см. в разделе « Свойства идентификатора» .
  • Примечание: Тип сущности 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". См. список агентств .
  • Значение "Рейтинг неизвестен" (регистр не учитывается) указывает на то, что рейтинг фильма вам неизвестен.
contentRating.author Организация Обязательно, если contentRating использует Rating - название рейтингового агентства.
contentRating.ratingValue Текст Обязательно, если contentRating использует Rating — значение рейтинга.
contentRating.advisoryCode Текст Рекомендованный код для контента. Допустимые значения: D, FV, L, S и V. D = Диалоги, FV = Фантастическое насилие, L = Ненормативная лексика, S = Сексуальное содержание, V = Насилие.

Примеры

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

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

Вещание

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

Вещание

{
  "@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 и транслирует 1 передачу под названием My favorite show с 20:00 до 12:00:

BroadcastEvent

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "BroadcastEvent",
   "@id": "http://example.com/randomUniqueEventId1",
   "name": Off Air,
   "startDate": "2019-10-12T00: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/randomUniqueEventId2",
  "startDate": "2019-10-12T20:00-08:00",
  "endDate": "2019-10-13T00:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": false,
  "name": "My favorite show",
  "workPerformed": {
    ...
  },
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },

}

Вещание

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

Для получения информации по соответствующим темам ознакомьтесь со следующими страницами: