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

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

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

Свойство Ожидаемый тип Описание
@context Текст Обязательное – всегда установлено ["http://schema.org", {"@language": "xx"}]
  • Где "xx" представляет язык строк в фиде. Для каждого контекста корневого объекта в параметре @language должен быть установлен соответствующий код языка в формате формата BCP 47 . Например, если установлен испанский язык, предполагается, что имена будут на испанском, даже если язык субтитров/дублирования на английском.
@type Текст Обязательно — всегда установлено значение BroadcastService .
@id URL-адрес Обязательно - Идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Глобально уникальный в вашем каталоге
  • статический; Идентификатор должен быть стабильным и не меняться с течением времени (даже если изменяется свойство URL-адреса шоу). Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде унифицированного идентификатора ресурса (URI)
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url -адрес объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем вам использовать url -адрес объекта как @id . См. раздел «Идентификатор» для получения более подробной информации.
url URL-адрес Обязательно, если применимоканонический URL-адрес службы вещания, если канал доступен для просмотра в Интернете. Это необязательно для услуги, предоставляемой по кабелю/спутнику/по воздуху. Google использует этот URL-адрес, чтобы сопоставить контент в вашем фиде с контентом в базах данных Google.
url должен соответствовать следующим требованиям:
  • url должен быть глобально уникальным
  • url должен содержать рабочий канонический URL-адрес, который может сканировать Google.
Вместо ссылки на контент для воспроизведения используйте свойство urlTemplate целевого объекта.
name Текст Обязательно - Имя сети.
  • Используйте массив для перечисления имен на разных языках. См. пример Несколько регионов и языков .
  • Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
broadcastDisplayName Текст Обязательное — отображаемое имя сети, которое пользователи обычно видят в программах передач и т. д. Значение может совпадать со значением имени.
callSign Текст Официальный государственный позывной радиовещательной службы.
inLanguage Текст или язык Настоятельно рекомендуется Почему? Основной язык вещания канала. Пожалуйста, используйте один из языковых кодов из стандарта IETF BCP 47 .
category Текст Настоятельно рекомендуется Почему? Категория для элемента. Большие знаки или косые черты могут использоваться для неформального обозначения иерархии категорий. например, Спорт, Спорт > Футбол, Новости, Кино, Музыка, Документальный фильм.`
contentRating Текст или рейтинг Требуется только для службы телевещания только для взрослых . Самый строгий рейтинг для контента, транслируемого на канале. Если рейтинг контента задается в виде текстовой строки, рейтинговое агентство должно быть добавлено к рейтингу с пробелом между ними; например, рейтинг «TV-Y» от агентства «TVPG» в США описывается как «TVPG TV-Y». См. список агентств .
contentRating.author Текст или организация Требуется, если contentRating используется Rating — название рейтингового агентства.
contentRating.ratingValue Текст Требуется, если contentRating используется Rating — значение рейтинга.
contentRating.advisoryCode Текст Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фантазия с насилием, L = язык, S = сексуальное содержание, V = насилие.
description Текст Описание службы вещания. ограничение в 300 символов. Используйте массив для предоставления описаний на нескольких языках и/или разной длины.
slogan Текст Слоган службы вещания.
areaServed Страна , штат , город или GeoShape Требуется, если применимо - Требуется, если переключение каналов осуществляется поставщиком телевизионных услуг. - Область, в которой пользователи могут рассчитывать на прием услуги вещания. Используйте код страны ISO 3166-1 для указания страны.
  • Используйте массив для представления нескольких областей.
  • Не смешивайте Country , State , City с GeoShape .
  • logo ImageObject Требуется при интеграции с GoogleTV. Настоятельно рекомендуется иначе Почему? Изображение, представляющее эту широковещательную службу.
    • Для интеграции с GoogleTV требуется один логотип, который можно использовать на темном фоне. Он должен иметь прозрачный фон с цветным или белым логотипом, хорошо заметным на темном фоне.
    • Изображение для логотипа должно соответствовать соотношению сторон 1:1, 4:3 или 16:9 (в порядке предпочтения) и должно иметь разрешение 80x80 пикселей или больше.
    • Используйте значение forDarkBackground для имени пользовательского свойства contentAttributes как часть свойства additionalProperty , чтобы указать тип фона, на котором должен использоваться логотип.
    • Отступы по длине или ширине (но не по обоим) допустимы, если они добавлены для сохранения соотношения сторон.
    • Прочие требования и спецификации см. в разделе «Изображение» .
    См. пример ниже
    potentialAction СмотретьДействие Обязательно, если применимообъект разметки Action , предоставляющий сведения о действии. Дополнительные сведения см. в свойствах разметки Action .
    videoFormat Текст Разрешение самого высокого качества, поддерживаемое этой службой вещания; например,
    • «SD» для стандартного разрешения.
    • «HD» для высокой четкости.
    • «2K» для разрешения 2K.
    • «4K» для разрешения 4K.
    • «8K» для разрешения 8K.
    broadcastTimezone Текст Часовой пояс этой службы вещания в формате IANA ; например, Америка/Лос-Анджелес . Используйте массив для нескольких часовых поясов.
    broadcastAffiliateOf Организация Обязательно — телевизионная сеть, предоставляющая программы для этой службы вещания, или организация, которой принадлежит эта служба вещания.
    broadcastAffiliateOf.@id Текст Обязательно — установите @id телевизионной сети.
    broadcastAffiliateOf.@type Текст Обязательный — всегда установлено значение Organization .
    identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, который идентифицирует этот объект, например _PARTNER_ID_. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора .
    popularityScore PopularityScoreSpecification Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0.
    popularityScore.@type Текст Всегда устанавливайте PopularityScoreSpecification .
    popularityScore.value Число Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность.
    popularityScore.eligibleRegion Страна Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
    Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью.

    Пример службы вещания

    {
        "@context": [
            "http://schema.org",
            {
                "@language": "en"
            }
        ],
        "@type": "BroadcastService",
        "@id": "http://example.com/stations/example-tv",
        "name": "EXAMPLE-TV",
        "broadcastDisplayName": "ABCD",
        "url": "http://example.com/stations/example-tv",
        "callSign": "EXA-TV",
        "videoFormat": "SD",
        "inLanguage": "en",
        "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"
            }
        ],
        "popularityScore": {
            "@type": "PopularityScoreSpecification",
            "value": 178,
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "US"
                }
            ]
        },
        "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",
                    "authenticator": {
                        "@type": "Organization",
                        "name": "TVE"
                    }
                },
                "eligibleRegion": [
                    {
                        "@type": "Country",
                        "name": "US"
                    }
                ]
            }
        },
        "logo": [
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Light",
                "contentUrl": "http://example.com/images/example-logo-light.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forLightBackground"
                        ]
                    }
                ]
            },
            {
                "@context": "http://schema.org",
                "@type": "ImageObject",
                "name": "Example Logo Dark",
                "contentUrl": "http://example.com/images/example-logo-dark.jpg",
                "additionalProperty": [
                    {
                        "@type": "PropertyValue",
                        "name": "contentAttributes",
                        "value": [
                            "forDarkBackground"
                        ]
                    }
                ]
            }
        ]
    }
    

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

    Свойство Ожидаемый тип Описание
    @context Текст Обязательное – всегда установлено ["http://schema.org", {"@language": "xx"}]
    • Где "xx" представляет язык строк в фиде. Для каждого контекста корневого объекта в параметре @language должен быть установлен соответствующий код языка в формате формата BCP 47 . Например, если установлен испанский язык, предполагается, что имена будут на испанском, даже если язык субтитров/дублирования на английском.
    @type Текст Обязательно — всегда задавайте значение CableOrSatelliteService .
    @id URL-адрес Обязательно - Идентификатор контента в формате URI; например, https://example.com/1234abc .
    @id должен соответствовать следующим требованиям:
    • Глобально уникальный в вашем каталоге
    • Статический
    • В виде унифицированного идентификатора ресурса (URI)
    Поскольку url -адрес объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем вам использовать url -адрес объекта как @id . См. раздел «Идентификатор» для получения более подробной информации.
    name Текст Обязательно - Название ТВ-сервиса.
    • Используйте массив для перечисления имен на разных языках. См. пример Несколько регионов и языков .
    • Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
    areaServed Страна , штат , город или GeoShape Обязательный — область, в которой пользователи могут рассчитывать на прием услуги широковещательной передачи.
    provider Организация Обязательно — родительский поставщик службы, если применимо. Например, ExampleTV является поставщиком региональных услуг ExampleTV в Сан-Франциско и ExampleTV в Сан-Диего .
    provider.@id Текст Обязательно - ID оператора ТВ.
    provider.@type Текст Обязательный — всегда установлено значение Organization .
    identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, который идентифицирует этот объект, например идентификатор Gracenote TMS для этой службы вещания. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора .

    Примеры CableOrSatelliteService

    Пример кабельного или спутникового телевидения:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/provider-lineups/exampletv-san-francisco",
      "name":"ExampleTV San Francisco",
      "provider": {
        "@type": "Organization",
        "@id": "http://example.com/providers/exampletv"
      },
      "areaServed":[
        {
          "@type":"GeoShape",
          "@id": "http://example.com/area1"
        }
      ],
      "identifier": {
        "@type": "PropertyValue",
        "propertyID": "TMS_ID",
        "value": "12345"
      }
    }
    
    {
      "@type": "GeoShape",
      "@id": "http://example.com/area1",
      "addressCountry": "US",
      "postalCode": [
        "94118",
        "94119"
      ]
    }
    

    Пример виртуального многоканального дистрибьютора видеопрограмм (vMVPD):

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"CableOrSatelliteService",
      "@id":"http://example.com/providers/my-online-example-tv",
      "name":"My Online Example TV",
      "provider": {
        "@type": "Organization",
        "@id": "http://my-online-tv.com"
      },
      "areaServed":[
        {
          "@type":"Country",
          "name": "US",
        },
        {
          "@type":"Country",
          "name": "CA",
        }
      ]
    }
    

    Таблица спецификаций телевизионного канала

    Свойство Ожидаемый тип Описание
    @context Текст Обязательное – всегда установлено ["http://schema.org", {"@language": "xx"}]
    • Где "xx" представляет язык строк в фиде. Для каждого контекста корневого объекта в параметре @language должен быть установлен соответствующий код языка в формате формата BCP 47 . Например, если установлен испанский язык, предполагается, что имена будут на испанском, даже если язык субтитров/дублирования на английском.
    @type Текст Обязательное — всегда установлено значение TelevisionChannel .
    @id URL-адрес Обязательно - Идентификатор контента в формате URI; например, https://example.com/1234abc .
    @id должен соответствовать следующим требованиям:
    • Глобально уникальный в вашем каталоге
    • Статический
    • В виде унифицированного идентификатора ресурса (URI)
    Поскольку url -адрес объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем вам использовать url -адрес объекта как @id . См. раздел «Идентификатор» для получения более подробной информации.
    broadcastChannelId Текст Требуется — уникальный идентификатор, по которому этот BroadcastService может быть идентифицирован как служба кабельного, спутникового или интернет-телевидения.
    • В США это обычно номер кабельного или спутникового телевидения.
    • Для службы интернет-телевидения (например, vMVPD) укажите имя канала.
    channelOrder Число Требуется для GoogleTV, в противном случае необязательно . Используйте это свойство, чтобы указать порядок, в котором каналы должны отображаться в электронном руководстве по программированию для интеграции с Google TV.

    channelOrder должен быть уникальным для всех каналов фида и в идеале должен начинаться с 1. channelOrder не может иметь отрицательное значение или значение 0.
    broadcastServiceTier Текст Используйте следующие значения:
    • Free для канала, не требующего подписки.
    • Standard для каналов, входящих в базовую подписку.
    • Premium для каналов, которые требуют оплаты сверх базовой подписки.
    Используйте массив для предоставления нескольких значений.
    inBroadcastLineup Кабельное или спутниковое обслуживание Обязательно@id службы CableOrSatelliteService , которая предоставляет этот канал зрителям.
    providesBroadcastService Служба вещания Обязательно@id службы BroadcastService , программирование которой обеспечивает этот канал.

    Примеры телевизионных каналов

    Пример кабельного или спутникового телеканала:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/exampleTV/example-tv-7",
      "broadcastChannelId":"7",
      "channelOrder": 1,
      "broadcastServiceTier":["Premium", "Standard"],
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/exampleTV-san-francisco"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/example-tv"
      }
    }
    

    Пример для онлайн-телеканала:

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"TelevisionChannel",
      "@id":"http://example.com/channels/my-online-example-tv/sport-channel",
      "broadcastChannelId":"sport-channel",
      "channelOrder": 3,
      "broadcastServiceTier":"Premium",
      "inBroadcastLineup":{
        "@type":"CableOrSatelliteService",
        "@id":"http://example.com/providers/my-online-example-tv"
      },
      "providesBroadcastService":{
        "@type":"BroadcastService",
        "@id":"http://example.com/stations/sport-channel"
      }
    }
    

    Таблица спецификации организации

    Свойство Ожидаемый тип Описание
    @context Текст Обязательное – всегда установлено ["http://schema.org", {"@language": "xx"}]
    • Где "xx" представляет язык строк в фиде. Для каждого контекста корневого объекта в параметре @language должен быть установлен соответствующий код языка в формате формата BCP 47 . Например, если установлен испанский язык, предполагается, что имена будут на испанском, даже если язык субтитров/дублирования на английском.
    @type Текст Обязательный — всегда установлено значение Organization .
    @id URL-адрес Обязательно - Идентификатор контента в формате URI; например, https://example.com/1234abc .
    @id должен соответствовать следующим требованиям:
    • Глобально уникальный в вашем каталоге
    • Статический
    • В виде унифицированного идентификатора ресурса (URI)
    Поскольку url -адрес объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем вам использовать url -адрес объекта как @id . См. раздел «Идентификатор» для получения более подробной информации.
    name Текст Обязательно — название телесети, поставщика ТВ-контента или ТВ-оператора.
    • Используйте массив для перечисления имен на разных языках. См. пример Несколько регионов и языков .
    • Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
    description Текст Описание организации. ограничение в 300 символов. Используйте массив, чтобы предоставить описания на нескольких языках и/или разной длины.
    sameAs URL-адрес Настоятельно рекомендуется Почему? URL-адрес страницы Википедии, которая может идентифицировать телевизионную сеть. Это должно отличаться от свойства url. Заполняйте только страницу Википедии, которая говорит об одном канале/сетевом объекте. Обратите внимание, что на страницах Википедии может использоваться термин «канал».
    potentialAction СмотретьДействие Требуется, если применимо . Это необходимо, если у вас есть несколько каналов (BroadcastService), ссылающихся на организацию. Объект разметки Action , предоставляющий сведения о действии. Подробнее см. в свойствах разметки Action .
    url URL-адрес URL-адрес организации. Google использует этот URL для точного согласования этой организации с организацией в базе данных Google.
    identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, который идентифицирует этот объект, например идентификатор TMS для этой организации. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора .
    popularityScore PopularityScoreSpecification Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0.
    popularityScore.@type Текст Всегда устанавливайте PopularityScoreSpecification .
    popularityScore.value Число Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность.
    popularityScore.eligibleRegion Страна Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
    Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью.

    Пример организации

    {
      "@context":["http://schema.org", {"@language": "en"}],
      "@type":"Organization",
      "@id":"http://example.com/networks/abcd-network",
      "name":"ABCD",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "TMS_ID",
          "value": "12345"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "_PARTNER_ID_",
          "value": "exampletv-12345"
        }
      ],
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://example.com/networkstream",
          "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": "2050-10-21T10:35:29Z",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "@id": "http://example.com/subscription",
            "name": "ABCD",
            "sameAs": "http://example.com/subscription",
          },
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            }
          ]
        }
      },
      "popularityScore": {
        "@type": "PopularityScoreSpecification",
        "value": 178,
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          }
        ]
      }
    }
    

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