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

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

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

Свойство Ожидаемый тип Описание
@context Текст Обязательно – всегда установлено значение ["http://schema.org", {"@language": "xx"}]
  • Замените xx кодом языка объекта в формате BCP 47 , например, «en».
@type Текст Обязательно — всегда установлено значение BroadcastEvent .
@id URL-адрес Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Глобальная уникальность в вашем каталоге
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство URL-адреса шоу). Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде унифицированного идентификатора ресурса (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 предназначен для SportsEvent, т. е. имеет свойство broadcastOfEvent — страна, в которой может транслироваться базовое событие SportsEvent. Это поле может представлять собой список стран, если несколько стран могут транслировать SportsEvent.
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 СмотретьДействие Обязательно, если применимо . Если контент транслируется как событие прямой потоковой передачи без канала (при этом для 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 = насилие.

Примеры

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

Телевизионная сеть Пример ТВ ( 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"
        }
      ]
    }
  }
}

На следующих страницах вы найдете темы, связанные с этими свойствами: