Свойства разметки контента телепередач

В этом разделе представлены сведения о свойствах разметки контента для типов сущностей 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 (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения.

Например, titleEIDR для телесериала, известного как «Игра престолов», — «10.5240/C1B5-3BA1-8991-A571-8472-W».
potentialAction СмотретьДействие Обязательно, если применимообъект разметки Action , предоставляющий сведения о действии.
  • Если содержимое доступно в видео по запросу (VoD), это свойство является обязательным; объект разметки Action должен предоставлять прямую ссылку на контент.
  • Если контент доступен на канале 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 ImageObject Требуется для Google TV — изображения, относящиеся к сериалу. Дополнительные сведения об обязательных и необязательных свойствах для включения в image см. в разделе Свойства изображения .
trailer.description Текст Описание трейлера. См. Пример трейлера .
trailer.inLanguage Текст Язык трейлера в формате BCP 47 .
trailer.url URL-адрес URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками.
trailer.regionsAllowed Место Регионы, где СМИ разрешены. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 .
identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора .
popularityScore PopularityScoreSpecification Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0.
popularityScore.@type Текст Всегда устанавливайте PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью.
review Обзор Обзор рейтингов сериалов
review.reviewRating Рейтинг Требуется, если предоставлен review Используется для указания рейтинга, данного в обзоре.
contentRating Текст или рейтинг Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, допускаются два варианта:
  • Рейтинговое агентство поставило перед рейтингом пробел. Например, рейтинг "TV-MA" от агентства "TVPG" в США следует описывать как "TVPG TV-MA". См. список агентств .
  • Значение «РЕЙТИНГ НЕИЗВЕСТНО» (без учета регистра), указывающее на то, что вы не знаете рейтинг контента.
contentRating.author Текст или организация Требуется, если contentRating используется Rating — название рейтингового агентства. На странице Content Rating Agency приведен список одобренных рейтинговых агентств.
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 (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения.

Например, titleEIDR для первого эпизода первого сезона телесериала, известного как «Игра престолов», имеет вид «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 . Обходной путь:
  • Возьмите 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), это свойство является обязательным; объект разметки Action должен предоставлять прямую ссылку на содержимое.
  • Если контент доступен на канале 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 ImageObject Настоятельно рекомендуется Почему? для Google TV — различные изображения, связанные с телеэпизодом. Дополнительные сведения об обязательных и необязательных свойствах для включения в 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 — название рейтингового агентства. На странице Content Rating Agency приведен список одобренных рейтинговых агентств.
contentRating.ratingValue Текст Требуется, если contentRating используется Rating — значение рейтинга.
contentRating.advisoryCode Текст Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фантазия с насилием, L = язык, S = сексуальное содержание, V = насилие.
identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора .
popularityScore PopularityScoreSpecification Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0.
popularityScore.@type Текст Всегда устанавливайте PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью.

ТВСезон

Свойство Ожидаемый тип Описание
@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 (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения.

Например, titleEIDR для первого сезона телесериала, известного как «Игра престолов», — «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), это свойство является обязательным; объект разметки Action должен предоставлять прямую ссылку на содержимое.
  • Если контент доступен на канале 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 ImageObject Изображения, связанные с TVSeason. Дополнительные сведения об обязательных и необязательных свойствах для включения в image см. в разделе Свойства изображения .
genre Текст Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"]
keywords Текст Ключевые слова или теги, используемые для описания этого контента. Также разрешен массив ключевых слов. Например, ["особенность, биография"] может быть массивом ключевых слов для описания контента.
trailer.description Текст Описание трейлера. См. Пример трейлера .
trailer.inLanguage Текст Язык трейлера в формате BCP 47 .
trailer.url URL-адрес URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками.
trailer.regionsAllowed Место Регионы, где СМИ разрешены. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 .
identifier Стоимость имущества Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора .
popularityScore PopularityScoreSpecification Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0.
popularityScore.@type Текст Всегда устанавливайте PopularityScoreSpecification .
popularityScore.value Число Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность.
popularityScore.eligibleRegion Страна Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .
Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью.
review Обзор Обзор рейтингов телесезона
review.reviewRating Рейтинг Требуется, если предоставлен review Используется для указания рейтинга, данного в обзоре.
contentRating Текст или рейтинг Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, допускаются два варианта:
  • Рейтинговое агентство поставило перед рейтингом пробел. Например, рейтинг "TV-MA" от агентства "TVPG" в США следует описывать как "TVPG TV-MA". См. список агентств .
  • Значение «РЕЙТИНГ НЕИЗВЕСТНО» (без учета регистра), указывающее на то, что вы не знаете рейтинг контента.
contentRating.author Текст или организация Требуется, если contentRating используется Rating — название рейтингового агентства. На странице Content Rating Agency приведен список одобренных рейтинговых агентств.
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 Человек или исполнительская группа Обязательное — всегда установлено значение Person или PerformingGroup .
@id URL-адрес Настоятельно рекомендуется Почему? - Идентификатор актера или исполняющей группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
  • Глобально уникальный в вашем каталоге для каждого актера / исполняющей группы
  • ID должен быть стабильным и не меняться со временем. Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде унифицированного идентификатора ресурса (URI)
  • Ваша организация должна владеть доменом, используемым для значения @id .

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

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

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

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

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

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

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

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

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

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

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

значение roleName Описание
"Актер" An actor or actress is a person who portrays a character in a performance in the traditional medium of the theater or in modern media such as film, radio, and television.
"GuestStar" "A guest star is an actor who plays a fictional role and appears in one or a few episodes. In some cases a guest star may play an important recurring character and may appear many times in a series, despite not being a member of the main cast. Set value to "GuestStar" when the cast has a guest performance or is a guest on the show. Guest stars should only be provided at the episode level, and should not be added at the TVSeries level.
"Guest" "A guest on a talk show. Note that while "GuestStar" is a fictional role, "Guest" is a non fictional appearance.
"Announcer" An announcer is a person who delivers opening and closing spiels for the show, introduces the host, contestants and/or celebrity guests, describes the prizes available, and warms up the audience before taping and keeps them entertained during breaks.
"Commentator" A commentator provides a real-time commentary of a game or event, usually during a live broadcast.
"Impressionist" An impressionist or a mimic is a performer whose act consists of imitating sounds, voices and mannerisms of celebrities and cartoon characters.
"Host" A person who introduces, presents or hosts television programs, often serving as a mediator for the program and the audience. The "Host" is generally a non-fiction role.
"CoHost" A person who hosts an event/program jointly with another person(s).
"GuestHost" A guest host is a host, usually of a talk show, that hosts the program in lieu of the regular host when not available.
"Newscaster" A person who presents/informs the public about news and events happening on a local, national, and international scale through a TV news program.
"Correspondent" A correspondent or on-the-scene reporter is usually a journalist or commentator for a magazine, or an agent who contributes reports to a newspaper, or radio or television news, or another type of company, from a remote, often distant, location.
"ShowJudge" A judge is a person who is often considered an expert in the field of the show and is given the role of "judge" to critique contestants that audition for and enter the competition of the TV series.
"Panelist" A member of a discussion or advisory panel of a radio or television panel.
"Contestant" A contestant in a competition or game show is a person who takes part in it.
"StoryNarrator" Narrator is a person who narrates something, especially a character who recounts the events of a novel or narrative poem
"MusicalArtist" "A Musical artist can be a person or a group or a fictional character that have typically performed in front of an audience on a regular basis or have recorded musical tracks or musical albums. Composers and lyricists should only have this type if the credits of some musical work imply they also contribute as main performer. This type can be used to associate permanent Musicians or Musician Groups, and guest Musicians or Musician Groups to shows.

Differentiating between a main and supporting role of an actor

To differentiate between the main/regular and guest/supporting actors in a TV show, add the main cast on TVSeries entities only and add only the guest cast or cast with supporting roles on the TVEpisode entities. Make sure the main/regular cast is not added to the TVEpisode entities.

Examples

TVSeries , TVEpisode , and TVSeason example

TVSeries

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

TVEpisode

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

TVSeason

{
  "@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 property examples

Role of actor is unknown

When the role of an actor is unknown, our recommendation is to just provide the actor information using either the Person or PerformingGroup type

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

Role of actor is known

When the role of an actor is known, our recommendation is to provide the actor information using the PerformanceRole type

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

Known roles for subset of actors

When performance role metadata is not known, our recommendation is to provide the actor information using either the Person or PerformingGroup type. For the other case where this info is known use the PerformanceRole type. These types can be added in the same array together .

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

Check out the following pages for the topics related to these properties: