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

В этом разделе представлены подробные сведения о свойствах разметки контента для типов объектов 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 Объект изображения Требуется при интеграции с GoogleTV. Настоятельно рекомендуется, в противном случае Почему? Изображение, представляющее эту службу вещания.
    • Для интеграции GoogleTV требуется один логотип, который можно использовать на темном фоне. Он должен иметь прозрачный фон с цветным или белым логотипом, который хорошо виден на темном фоне.
    • Изображение для логотипа должно соответствовать соотношению сторон 1:1, 4:3 или 16:9 (в указанном порядке) и иметь разрешение 80x80 пикселей или выше.
    • Используйте значение forDarkBackground для имени пользовательского свойства contentAttributes как часть свойства additionalProperty , чтобы указать тип фона, на котором следует использовать логотип.
    • Отступы по длине или ширине (но не по обеим сторонам) допустимы, если они добавлены для сохранения соотношения сторон.
    • Другие требования и характеристики см. в разделе «Изображение» .
    См . пример ниже
    potentialAction СмотретьДействие Обязательно, если применимо . Объект разметки Action , предоставляющий подробные сведения о действии. Подробности см. в свойствах разметки действий .
    videoFormat Текст Разрешение высочайшего качества, поддерживаемое этой службой вещания; например,
    • «SD» для стандартного разрешения.
    • «HD» для высокой четкости.
    • «2K» для разрешения 2K.
    • «4K» для разрешения 4K.
    • «8K» для разрешения 8K.
    broadcastTimezone Текст Часовой пояс этой службы вещания в формате IANA ; например, Америка/Лос-Анджелес . Используйте массив для нескольких часовых поясов.
    broadcastAffiliateOf Организация Обязательно — телесеть, предоставляющая программы для этой службы вещания, или организация, которой принадлежит эта служба вещания.
    broadcastAffiliateOf.@id Текст Обязательно — установите @id телесети.
    broadcastAffiliateOf.@type Текст Обязательно — всегда установлено значение Organization .
    identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, идентифицирующий этот объект, например _PARTNER_ID_. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора .
    popularityScore ПопулярностьОценкаСпецификация Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы следует воспроизводить для пользователей. Эта оценка отражает популярность контента по сравнению с другим контентом в вашем каталоге; поэтому шкала оценок должна быть единообразной для всех ваших каналов и всех объектов в вашем каталоге. По умолчанию рейтинг популярности объекта равен 0.
    popularityScore.@type Текст Всегда установлено значение PopularityScoreSpecification .
    popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
    popularityScore.eligibleRegion Страна Регион(ы), к которым применим этот показатель популярности. Если показатель популярности применим во всем мире, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
    Note: Популярность конкретного региона имеет приоритет над глобальной популярностью (EARTH).

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

    {
        "@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 San Francisco и exampleTV San Diego .
    provider.@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 , предоставляющий подробную информацию о действии. Подробности см. в свойствах разметки действий .
    url URL-адрес URL-адрес организации. Google использует этот URL-адрес для точного сопоставления этой организации с организацией в базах данных Google.
    identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, идентифицирующий этот объект, например идентификатор TMS для этой организации. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора .
    popularityScore ПопулярностьОценкаСпецификация Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы следует воспроизводить для пользователей. Эта оценка отражает популярность контента по сравнению с другим контентом в вашем каталоге; поэтому шкала оценок должна быть единообразной для всех ваших каналов и всех объектов в вашем каталоге. По умолчанию рейтинг популярности объекта равен 0.
    popularityScore.@type Текст Всегда установлено значение PopularityScoreSpecification .
    popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
    popularityScore.eligibleRegion Страна Регион(ы), к которым применим этот показатель популярности. Если показатель популярности применим во всем мире, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
    Note: Популярность конкретного региона имеет приоритет над глобальной популярностью (EARTH).

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

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

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