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

В этом разделе подробно описаны свойства разметки содержимого для типа сущности 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"
        }
      ]
    }
  }
}

Похожие страницы

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

• Определите типы сущностей вашего контента.
• Соберите идентификатор, URL-адрес и название вашего контента.
• Соберите метаданные вашего контента.