Свойства разметки контента телешоу

В этом разделе представлены подробные сведения о свойствах разметки контента для типов сущностей TVSeries , TVEpisode и TVSeason .

Предоставление TVSeason как полноценного объекта не является обязательным. Подробности см. в разделе «Отношения TVSeries, TVSeason и TVEpisode» .

Таблица технических характеристик

Сериал

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

Например, название EIDR для сериала, известного как «Игра престолов», — «10.5240/C1B5-3BA1-8991-A571-8472-W».
potentialAction СмотретьДействие Обязательно, если применимо . Объект разметки Action , предоставляющий подробные сведения о действии.
  • Если контент доступен в формате «Видео по запросу» (VoD), это свойство является обязательным; Объект разметки действия должен предоставлять глубокую ссылку на контент.
  • Если контент доступен на канале LiveTV, это свойство является необязательным; вместо этого связанный объект BroadcastService предоставляет глубокую ссылку на канал.
  • TVSeries может быть доступен как на VoD, так и на LiveTV.
Используйте массив, чтобы указать разные глубокие ссылки в нескольких регионах. См. пример нескольких регионов и языков .
sameAs URL-адрес Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, по которой можно идентифицировать шоу; например, страница шоу в Википедии. Оно должно отличаться от свойства url .
inLanguage Текст Оригинальный язык серии в формате BCP 47 .
genre Текст Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"]
keywords Текст Ключевые слова или теги, используемые для описания этого контента. Также допускается использование массива ключевых слов. Например, ["характеристика, биография"] может представлять собой массив ключевых слов для описания контента.
releasedEvent PublicationEvent , FeaturedEvent или ExclusiveEvent Настоятельно рекомендуется Почему?PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты выхода фильма в кинотеатрах.

Кроме того, используйте FeaturedEvent чтобы указать, что ваша служба позиционирует этот контент как оригинальный, избранный, специальный и т. д.

ExclusiveEvent указывает, что ваша служба имеет эксклюзивные права на распространение, и указывает, где и когда.

Подробности и примеры смотрите в разделе примеров .
releasedEvent.@type Текст Обязательно — обязательно всегда устанавливайте для этого свойства одно из следующих значений:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Страна Обязательно — регионы, связанные с этим событием.

Для PublicationEvent это регион, в котором был опубликован контент.

Для FeaturedEvent и ExclusiveEvent это регион, в котором контент является избранным или эксклюзивным.

Используйте коды ISO 3166 для стран. Чтобы указать любую точку мира, установите значение EARTH .
releasedEvent.startDate Дата или ДатаВремя Рекомендуетсяобязательно для ExclusiveEvent — дата начала публикации объекта.

Для PublicationEvent это обозначает начальную дату выпуска этой сущности, например дату первого выхода фильма в кинотеатрах.

Для ExclusiveEvent и FeaturedEvent это дата начала, когда объект является эксклюзивным или избранным.
releasedEvent.endDate Дата или ДатаВремя Рекомендуетсяобязательно для ExclusiveEvent . Это применимо только к типам ExclusiveEvent и FeaturedEvent .

Для ExclusiveEvent это дата истечения срока действия прав на контент.

Для FeaturedEvent это представляет последнюю дату, когда поставщик представляет сущность.

Если контент является эксклюзивным или избранным на постоянной основе, установите endDate , равное 20 годам от текущей даты.
releasedEvent.publishedBy Организация или человек Необязательно — организация или лицо, опубликовавшее этот объект.
description Текст Настоятельно рекомендуется Почему? Краткое содержание шоу. Краткое изложение сюжета предпочтительнее фактического изложения. Ограничение в 300 символов.
actor Человек , исполняющая группа или исполняющая роль Настоятельно рекомендуется Почему? Массив актеров сериала. См. руководство по моделированию здесь .
director Человек Настоятельно рекомендуется Почему? Режиссер(ы) шоу.
producer Организация или человек Настоятельно рекомендуется Почему? Продюсер(ы) шоу.
image Объект изображения Требуется для Google TV — изображения, относящиеся к сериалу. Дополнительные сведения об обязательных и необязательных свойствах, включаемых в image , см. в разделе Свойства изображения .
trailer.description Текст Описание трейлера. См. пример трейлера .
trailer.inLanguage Текст Язык трейлера в формате BCP 47 .
trailer.url URL-адрес URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками.
trailer.regionsAllowed Место Регионы, в которых разрешены СМИ. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 .
identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данную сущность. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора .
popularityScore ПопулярностьОценкаСпецификация Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы следует воспроизводить для пользователей. Эта оценка отражает популярность контента по сравнению с другим контентом в вашем каталоге; поэтому шкала оценок должна быть единообразной для всех ваших каналов и всех объектов в вашем каталоге. По умолчанию рейтинг популярности объекта равен 0.
popularityScore.@type Текст Всегда установлено значение PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), к которым применим этот показатель популярности. Если показатель популярности применим во всем мире, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность конкретного региона имеет приоритет над глобальной популярностью (EARTH).
review Обзор Обзор рейтингов сериала
review.reviewRating Рейтинг Обязательно, если предоставлен review . Используется для указания рейтинга, данного в обзоре.
contentRating Текст или рейтинг Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  • Рейтинговое агентство поставило рейтинг перед рейтингом с пробелом между ними. Например, рейтинг «TV-MA» агентства «TVPG» в США следует описывать как «TVPG TV-MA». Посмотреть список агентств .
  • Значение «РЕЙТИНГ НЕ ИЗВЕСТЕН» (без учета регистра), указывающее, что вы не знаете рейтинг контента.
contentRating.author Текст или организация Обязательно, если contentRating использует Rating — название рейтингового агентства. Список принятых рейтинговых агентств см. на странице «Рейтинговые агентства контента».
contentRating.ratingValue Текст Требуется, если contentRating использует Rating — значение рейтинга.
contentRating.advisoryCode Текст Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фэнтези-насилие, L = язык, S = сексуальный контент, V = насилие.

ТВЭпизод

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

Например, заголовок EIDR для первого эпизода первого сезона телесериала, известного как «Игра престолов», — «10.5240/B6A6-1B32-B5E5-D5CB-6B84-X».
editEIDR Текст Настоятельно рекомендуется Почему? - Идентификатор EIDR (Реестр развлекательных идентификаторов), представляющий конкретную редакцию/издание произведения кино или телевидения.

Например, первый эпизод первого сезона телесериала, известного как «Игра престолов» с названием EIDR «10.5240/B6A6-1B32-B5E5-D5CB-6B84-X», имеет одно изменение, например «10.5240/FB97-C847- 2969-D0AB-ECD1-C".

Свойство titleEIDR требуется , если указан editEIDR.
inLanguage Текст Оригинальный язык серии в формате BCP 47 .
episodeNumber Целое число Обязательно — число, указывающее позицию этого эпизода в порядке эпизодов в сезоне. episodeNumber необходимо перезапускать для каждого сезона; то есть первая серия каждого сезона должна быть 1.
partOfSeason ТВСезон Обязательно — телесезон, к которому относится этот выпуск.

Даже если TVEpisode не имеет соответствующего TVSeason , вам все равно необходимо предоставить свойства partOfSeason.@id и partOfSeason.seasonNumber SeasonNumber. Обходной путь:
  • Возьмите partofSeries.@id (например, http://www.example.com/my_favorite_tv_show ) и прикрепите поле запроса-заполнителя (например, ? Season1 ), чтобы создать уникальный partOfSeason.@id (например, http:// www.example.com/my_favorite_tv_show? Season1).
  • Установите partOfSeason.seasonNumber значение 1.
partOfSeason.@type Текст Обязательно — всегда устанавливайте TVSeason .
partOfSeason.@id URL-адрес Обязательно — @id TVSeason , частью которого является этот выпуск.
partOfSeason.seasonNumber Целое число Обязательно — число, обозначающее позицию этого сезона в порядке сезонов сериала.
partOfSeries Сериал Обязательно — сериал, к которому относится этот эпизод.
partOfSeries.@type Текст Обязательно — всегда установлено значение TVSeries .
partOfSeries.@id URL-адрес Обязательно — @id TVSeries , частью которого является этот эпизод.
partOfSeries.name Текст Обязательно – Название сериала.
partOfSeries.sameAs Текст URL-адрес справочной веб-страницы, по которой можно идентифицировать шоу; например, страница шоу в Википедии. Оно должно отличаться от свойства url .
potentialAction СмотретьДействие Обязательно, если применимо : объект разметки Action , предоставляющий подробную информацию о действии.
  • Если контент доступен в формате «Видео по запросу» (VoD), это свойство является обязательным; Объект разметки действия должен предоставлять глубокую ссылку на контент.
  • Если контент доступен на канале LiveTV, это свойство является необязательным; вместо этого связанный объект BroadcastService предоставляет глубокую ссылку на канал.
  • TVEpisode может быть доступен как на VoD, так и на LiveTV.
Используйте массив, чтобы указать разные глубокие ссылки в нескольких регионах. См. пример нескольких регионов и языков .
sameAs Настоятельно рекомендуется Почему? URL-адрес URL-адрес справочной веб-страницы, на которой можно идентифицировать эпизод; например, страница эпизода в Википедии. Оно должно отличаться от свойства url .
duration Продолжительность Время выполнения эпизода в формате ISO 8601 . Пожалуйста, используйте формат: «PT00H00M».
releasedEvent PublicationEvent , FeaturedEvent или ExclusiveEvent Настоятельно рекомендуется Почему?PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты выхода фильма в кинотеатрах.

Кроме того, используйте FeaturedEvent чтобы указать, что ваша служба позиционирует этот контент как оригинальный, избранный, специальный и т. д.

ExclusiveEvent указывает, что ваша служба имеет эксклюзивные права на распространение, и указывает, где и когда.

Подробности и примеры смотрите в разделе примеров .
releasedEvent.@type Текст Обязательно — обязательно всегда устанавливайте для этого свойства одно из следующих значений:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Страна Обязательно — регионы, связанные с этим событием.

Для PublicationEvent это регион, в котором был опубликован контент.

Для FeaturedEvent и ExclusiveEvent это регион, в котором контент является избранным или эксклюзивным.

Используйте коды ISO 3166 для стран. Чтобы указать любую точку мира, установите значение EARTH .
releasedEvent.startDate Дата или ДатаВремя Рекомендуетсяобязательно для ExclusiveEvent — дата начала публикации объекта.

Для PublicationEvent это обозначает начальную дату выпуска этой сущности, например дату первого выхода фильма в кинотеатрах.

Для ExclusiveEvent и FeaturedEvent это дата начала, когда объект является эксклюзивным или избранным.
releasedEvent.endDate Дата или ДатаВремя Рекомендуется — обязательно для ExclusiveEvent . Это применимо только к типам ExclusiveEvent и FeaturedEvent .

Для ExclusiveEvent это дата истечения срока действия прав на контент.

Для FeaturedEvent это представляет последнюю дату, когда поставщик представляет сущность.

Если контент является эксклюзивным или избранным на постоянной основе, установите endDate , равное 20 годам от текущей даты.
releasedEvent.publishedBy Организация или человек Необязательно — организация или лицо, опубликовавшее этот объект.
description Текст Настоятельно рекомендуется Почему? Краткое содержание эпизода. Краткое изложение сюжета предпочтительнее фактического изложения. Ограничение в 300 символов.
genre Текст Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"]
keywords Текст Ключевые слова или теги, используемые для описания этого контента. Также допускается использование массива ключевых слов. Например, ["характеристика, биография"] может представлять собой массив ключевых слов для описания контента.
actor Человек , исполняющая группа или исполняющая роль Настоятельно рекомендуется Почему? Массив актеров эпизода. См. руководство по моделированию здесь .
director Человек Настоятельно рекомендуется Почему? Режиссер(ы) эпизода.
producer Организация или человек Настоятельно рекомендуется Почему? Продюсер(ы) сезона.
image Объект изображения Настоятельно рекомендуется Почему? для Google TV — различные изображения, связанные с TVEpisode. Дополнительные сведения об обязательных и необязательных свойствах, включаемых в image , см. в разделе Свойства изображения .
trailer.description Текст Описание трейлера. См. пример трейлера .
trailer.inLanguage Текст Язык трейлера в формате BCP 47 .
trailer.url URL-адрес URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками.
trailer.regionsAllowed Место Регионы, в которых разрешены СМИ. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 .
review Обзор Обзор рейтингов телесериала
review.reviewRating Рейтинг Обязательно, если предоставлен review . Используется для указания рейтинга, данного в обзоре.
contentRating Текст или рейтинг Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  • Рейтинговое агентство поставило рейтинг перед рейтингом с пробелом между ними. Например, рейтинг «TV-MA» агентства «TVPG» в США следует описывать как «TVPG TV-MA». Посмотреть список агентств .
  • Значение «РЕЙТИНГ НЕ ИЗВЕСТЕН» (без учета регистра), указывающее, что вы не знаете рейтинг контента.
contentRating.author Текст или организация Обязательно, если contentRating использует Rating — название рейтингового агентства. Список принятых рейтинговых агентств см. на странице «Рейтинговые агентства контента».
contentRating.ratingValue Текст Требуется, если contentRating использует Rating — значение рейтинга.
contentRating.advisoryCode Текст Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фэнтези-насилие, L = язык, S = сексуальный контент, V = насилие.
identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данную сущность. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора .
popularityScore ПопулярностьОценкаСпецификация Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы следует воспроизводить для пользователей. Эта оценка отражает популярность контента по сравнению с другим контентом в вашем каталоге; поэтому шкала оценок должна быть единообразной для всех ваших каналов и всех объектов в вашем каталоге. По умолчанию рейтинг популярности объекта равен 0.
popularityScore.@type Текст Всегда установлено значение PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), к которым применим этот показатель популярности. Если показатель популярности применим во всем мире, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность конкретного региона имеет приоритет над глобальной популярностью (EARTH).

ТВСезон

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

Например, заголовок EIDR первого сезона телесериала, известного как «Игра престолов», — «10.5240/FD91-C72C-4161-FCBA-058B-1».
seasonNumber Целое число Обязательно — число, обозначающее позицию этого сезона в порядке сезонов сериала.
partOfSeries Сериал Обязательно — сериал, к которому относится этот сезон.
partOfSeries.@type Текст Обязательно — всегда установлено значение TVSeries .
partOfSeries.@id URL-адрес Обязательно – @id TVSeries , в котором участвует этот сезон.
partOfSeries.name Текст Обязательно – Название сериала.
partOfSeries.sameAs Текст URL-адрес справочной веб-страницы, по которой можно идентифицировать шоу; например, страница шоу в Википедии. Оно должно отличаться от свойства url .
potentialAction СмотретьДействие Обязательно, если применимо . Объект разметки Action , предоставляющий подробные сведения о действии.
  • Если контент доступен в формате «Видео по запросу» (VoD), это свойство является обязательным; Объект разметки действия должен предоставлять глубокую ссылку на контент.
  • Если контент доступен на канале LiveTV, это свойство является необязательным; вместо этого связанный объект BroadcastService предоставляет глубокую ссылку на канал.
  • TVSeason может быть доступен как на VoD, так и на LiveTV.
Используйте массив, чтобы указать разные глубокие ссылки в нескольких регионах. См. пример нескольких регионов и языков .
sameAs URL-адрес Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, на которой можно определить сезон; например, страница сезона в Википедии. Оно должно отличаться от свойства url .
releasedEvent PublicationEvent , FeaturedEvent или ExclusiveEvent Настоятельно рекомендуется Почему?PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты выхода фильма в кинотеатрах.

Кроме того, используйте FeaturedEvent чтобы указать, что ваша служба позиционирует этот контент как оригинальный, избранный, специальный и т. д.

ExclusiveEvent указывает, что ваша служба имеет эксклюзивные права на распространение, и указывает, где и когда.

Подробности и примеры смотрите в разделе примеров .
releasedEvent.@type Текст Обязательно — обязательно всегда устанавливайте для этого свойства одно из следующих значений:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Страна Обязательно — регионы, связанные с этим событием.

Для PublicationEvent это регион, в котором был опубликован контент.

Для FeaturedEvent и ExclusiveEvent это регион, в котором контент является избранным или эксклюзивным.

Используйте коды ISO 3166 для стран. Чтобы указать любую точку мира, установите значение EARTH .
releasedEvent.startDate Дата или ДатаВремя Рекомендуетсяобязательно для ExclusiveEvent — дата начала публикации объекта.

Для PublicationEvent это обозначает начальную дату выпуска этой сущности, например дату первого выхода фильма в кинотеатрах.

Для ExclusiveEvent и FeaturedEvent это дата начала, когда объект является эксклюзивным или избранным.
releasedEvent.endDate Дата или ДатаВремя Рекомендуется — обязательно для ExclusiveEvent . Это применимо только к типам ExclusiveEvent и FeaturedEvent .

Для ExclusiveEvent это дата истечения срока действия прав на контент.

Для FeaturedEvent это последняя дата, когда поставщик представляет сущность.

Если контент является эксклюзивным или избранным на постоянной основе, установите endDate , равное 20 годам от текущей даты.
releasedEvent.publishedBy Организация или человек Необязательно — организация или лицо, опубликовавшее этот объект.
description Текст Настоятельно рекомендуется Почему? Краткое содержание сезона. Краткое изложение сюжета предпочтительнее фактического изложения. Ограничение в 300 символов.
actor [ Человек , исполняющая группа или исполняющая роль Настоятельно рекомендуется Почему? Набор актеров сезона. См. руководство по моделированию здесь .
director Человек Настоятельно рекомендуется Почему? Множество режиссеров шоу.
producer Организация или человек Настоятельно рекомендуется Почему? Продюсер(ы) сезона.
image Объект изображения Изображения, связанные с TVSeason. Дополнительные сведения об обязательных и необязательных свойствах, включаемых в image , см. в разделе Свойства изображения .
genre Текст Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"]
keywords Текст Ключевые слова или теги, используемые для описания этого контента. Также допускается использование массива ключевых слов. Например, ["характеристика, биография"] может представлять собой массив ключевых слов для описания контента.
trailer.description Текст Описание трейлера. См. пример трейлера .
trailer.inLanguage Текст Язык трейлера в формате BCP 47 .
trailer.url URL-адрес URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками.
trailer.regionsAllowed Место Регионы, в которых разрешены СМИ. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 .
identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данную сущность. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора .
popularityScore ПопулярностьОценкаСпецификация Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы следует воспроизводить для пользователей. Эта оценка отражает популярность контента по сравнению с другим контентом в вашем каталоге; поэтому шкала оценок должна быть единообразной для всех ваших каналов и всех объектов в вашем каталоге. По умолчанию рейтинг популярности объекта равен 0.
popularityScore.@type Текст Всегда установлено значение PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), к которым применим этот показатель популярности. Если показатель популярности применим во всем мире, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность конкретного региона имеет приоритет над глобальной популярностью (EARTH).
review Обзор Обзор рейтингов телесезона
review.reviewRating Рейтинг Обязательно, если предоставлен review . Используется для указания рейтинга, данного в обзоре.
contentRating Текст или рейтинг Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  • Рейтинговое агентство поставило рейтинг перед рейтингом с пробелом между ними. Например, рейтинг «TV-MA» агентства «TVPG» в США следует описывать как «TVPG TV-MA». Посмотреть список агентств .
  • Значение «РЕЙТИНГ НЕ ИЗВЕСТЕН» (без учета регистра), указывающее, что вы не знаете рейтинг контента.
contentRating.author Текст или организация Обязательно, если contentRating использует Rating — название рейтингового агентства. Список принятых рейтинговых агентств см. на странице «Рейтинговые агентства контента».
contentRating.ratingValue Текст Требуется, если contentRating использует Rating — значение рейтинга.
contentRating.advisoryCode Текст Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фэнтези-насилие, L = язык, S = сексуальный контент, V = насилие.

Характеристики актера

Свойство actor в типах сущностей TVSeries , TVEpisode и TVSeason позволяет указать более подробную информацию об актерах, включая имена их персонажей и роли, которые они играют в телешоу. В следующих разделах описывается то же самое, а также несколько примеров, поясняющих использование.

Свойство Ожидаемый тип Описание
actor Человек , исполняющая группа или исполняющая роль Настоятельно рекомендуется Почему? : Массив актеров.
  • Используйте тип PerformanceRole , если известна играемая роль и (необязательно) имя персонажа актеров. В этом случае актер Person или PerformingGroup встроен в объект PerformanceRole .
  • Используйте тип Person , чтобы указать отдельных актеров, или PerformingGroup, чтобы предоставить подробную информацию об исполняющих группах/группах, когда роли, которые играют актеры, неизвестны.

Используйте массив для представления нескольких Person, PerformingGroups или PerformanceRoles.

Использование типов Person или PerformingGroup

Укажите следующие свойства при использовании типа Person или PerformingGroup .

Свойство Ожидаемый тип Описание
@type Человек или исполняющая группа Обязательно — всегда установлено значение «Человек» или «Исполняющая группа».
@id URL-адрес Настоятельно рекомендуется Почему? - Идентификатор актера или исполнительской группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
  • Глобально уникально в вашем каталоге для каждого актера/исполнительной группы.
  • Идентификатор должен быть стабильным и не меняться со временем. Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде унифицированного идентификатора ресурса (URI).
  • Ваша организация должна владеть доменом, используемым для значения @id .

Обратите внимание, что @id используемый в свойстве актера, должен использоваться последовательно во всем фиде. Например, если есть два фильма с участием одного и того же актера, то значение @id должно оставаться одинаковым для этих двух объектов актера.

name Текст Обязательно — имя актера/актрисы/актёра/исполнительной группы.
sameAs URL-адрес Настоятельно рекомендуется Почему? - URL-адрес справочной веб-страницы, на которой можно идентифицировать актера или исполнительскую группу; например, страница актера в Википедии. Оно должно отличаться от свойства @id .

Использование типа PerformanceRole

Укажите следующие свойства при использовании типа PerformanceRole .

Свойство Ожидаемый тип Описание
@type ПроизводительностьРоль Обязательно — всегда установлено значение PerformanceRole.
roleName Текст Настоятельно рекомендуется Почему? - Роль, сыгранная, исполненная или исполненная актером. Пожалуйста, ознакомьтесь со списком допустимых значений здесь .
characterName Текст Имя персонажа, сыгранного в какой-либо актерской или исполнительской роли. Не устанавливайте это поле, если тип актера — PerformingGroup .
actor Человек или исполняющая группа Необходимый -
  • Приведенные члены содержимого при использовании типа данных Person .
  • Исполняющая группа(ы)/диапазон(ы) контента, когда используется тип данных PerformingGroup .
actor.@type Человек или исполняющая группа Обязательно — всегда установлено значение «Человек» или «Исполняющая группа».
actor.@id URL-адрес Настоятельно рекомендуется Почему? - Идентификатор актера или исполнительской группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
  • Глобально уникально в вашем каталоге для каждого актера/исполнительной группы.
  • Идентификатор должен быть стабильным и не меняться со временем. Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде унифицированного идентификатора ресурса (URI).
  • Ваша организация должна владеть доменом, используемым для значения @id .

Обратите внимание, что @id используемый в свойстве актера, должен использоваться последовательно во всем фиде. Например, если есть два фильма с одним и тем же актером, то значение @id должно оставаться одинаковым для этих двух объектов актера.

actor.name Текст Обязательно — имя актера/актрисы/актёра/исполнительной группы.
actor.sameAs URL-адрес Настоятельно рекомендуется Почему? - URL-адрес справочной веб-страницы, на которой можно идентифицировать актера или исполнительскую группу; например, страница актера в Википедии. Оно должно отличаться от свойства actor.@id.

Допустимые имена ролей

Эти значения требуют, чтобы actor.@type был Person .

значение roleName Описание
"Камея" Эпизодическая роль, также называемая эпизодической ролью, представляет собой краткое появление известного человека в произведении исполнительского искусства.
"Голос актера" Голосовой спектакль — это спектакль, в котором используется голос актера, но актер не появляется на экране. Чаще всего это встречается в анимации, но также происходит, когда голос актера дублируется поверх речи другого актера.
"Двойной" Двойник — это человек, который заменяет другого актера так, что его лицо не показано.
«Актер MotionCapture» MotionCaptureActor — это человек, записывающий действия актеров-людей и использующий эту информацию для анимации цифровых моделей персонажей в компьютерной 2D- или 3D-анимации.

Эти значения обычно принимаются для типов Person и PerformingGroup .

значение roleName Описание
"Актер" Актер или актриса — это человек, который изображает персонажа в спектакле в традиционных средствах театра или в современных средствах массовой информации, таких как кино, радио и телевидение.
"Приглашенная звезда" «Приглашенная звезда — это актер, который играет вымышленную роль и появляется в одном или нескольких эпизодах. В некоторых случаях приглашенная звезда может играть важного повторяющегося персонажа и может появляться много раз в сериале, несмотря на то, что он не является участником основного состава. Приглашенные звезды должны быть указаны только на уровне эпизода и не должны добавляться на уровне TVSeries.
«Гость» «Гостья ток-шоу. Обратите внимание, что хотя «GuestStar» — это вымышленная роль, «Гость» — это невымышленное появление.
«Диктор» Диктор — это человек, который произносит вступительные и заключительные речи шоу, представляет ведущего, участников и/или знаменитых гостей, описывает доступные призы, разогревает публику перед записью и развлекает ее во время перерывов.
«Комментатор» Комментатор комментирует игру или событие в режиме реального времени, обычно во время прямой трансляции.
«Импрессионист» Импрессионист или мимик – это исполнитель, чье выступление состоит из имитации звуков, голосов и манер знаменитостей и героев мультфильмов.
"Хозяин" Человек, который представляет, представляет или ведет телевизионные программы, часто выступая в качестве посредника для программы и аудитории. «Хозяин» — это, как правило, научно-популярная роль.
"СоХост" Лицо, которое проводит мероприятие/программу совместно с другим лицом(ами).
"ГостьХост" Приглашенный ведущий — это ведущий, обычно ток-шоу, который ведет программу вместо обычного ведущего, когда он недоступен.
"Диктор" Человек, который представляет/информирует общественность о новостях и событиях, происходящих в местном, национальном и международном масштабе, через программу телевизионных новостей.
«Корреспондент» Корреспондент или репортер с места происшествия обычно является журналистом или комментатором журнала или агентом, который публикует репортажи в газете, радио- или телевизионных новостях или компании другого типа из удаленного, часто удаленного места.
"ШоуДжадж" Судья - это человек, которого часто считают экспертом в области шоу, и ему отводится роль «судьи» для критики участников, которые проходят прослушивание и участвуют в конкурсе телесериала.
"участник дискуссии" Член дискуссионной или консультативной группы радио- или телевизионной группы.
«Участник» Участником конкурса или телеигры является лицо, принимающее в них участие.
«Рассказчик» Рассказчик - это человек, который что -то рассказывает, особенно персонаж, который рассказывает о событиях романа или повествовательного стихотворения
"MusicalArtist" "Музыкальный художник может быть человеком, группой или вымышленным персонажем, который обычно выступал перед аудиторией на регулярной основе или записал музыкальные треки или музыкальные альбомы. Композиторы и лирики должны иметь этот тип только в том случае Музыкальная работа подразумевает, что они также вносят свой вклад в качестве основного исполнителя.

Дифференциация между основной и вспомогательной ролью актера

Чтобы различить главных/обычных и гостевых/вспомогательных актеров в телешоу, добавьте основной актерский состав только в TVSeries Entines и добавьте только гостевого актера или актеров с вспомогательными ролями на объектах TVEpisode . Убедитесь, что основной/обычный актерский состав не добавляется в объекты TVEpisode .

Примеры

TVSeries , TVEpisode и TVSeason пример

Сериал

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

ТВЭпизод

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

ТВСезон

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

Примеры имущества Actor

Роль актера неизвестна

Когда роль актера неизвестна, наша рекомендация состоит в том, чтобы просто предоставить информацию актера, используя либо человека , либо тип эксплуатации

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

Роль актера известна

Когда роль актера известна, наша рекомендация состоит в том, чтобы предоставить информацию актера, используя тип Performancerole

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

Известные роли для подмножества актеров

Когда метаданные роли производительности не известны, наша рекомендация состоит в том, чтобы предоставить информацию актера, используя либо человека , либо тип эксплуатации . Для другого случая, когда эта информация известна, используйте тип Performancerole . Эти типы могут быть добавлены в одном и том же массиве вместе .

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

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