В этом разделе представлены подробные сведения о свойствах разметки контента для типов сущностей TVSeries , TVEpisode и TVSeason .
 Предоставление TVSeason как полноценного объекта не является обязательным. Подробности см. в разделе «Отношения TVSeries, TVSeason и TVEpisode» .
Таблица технических характеристик
Сериал
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 @context | Текст |  Обязательно – всегда установлено значение ["http://schema.org", {"@language": "xx"}]
  | 
 @type | Текст |  Обязательно — всегда установлено значение TVSeries . | 
 @id | URL-адрес |  Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
 url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» . | 
 url | URL-адрес |  Обязательно – канонический URL-адрес контента, который Google использует для сопоставления контента вашего фида с контентом в базах данных Google.url должен соответствовать следующим требованиям:
 urlTemplate целевого объекта. | 
 name | Текст |  Обязательно – Название шоу.
  | 
 titleEIDR | Текст |  Настоятельно рекомендуется Почему? - Идентификатор EIDR (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, название EIDR для сериала, известного как «Игра престолов», — «10.5240/C1B5-3BA1-8991-A571-8472-W».  | 
 potentialAction | СмотретьДействие |  Обязательно, если применимо : объект разметки Action , предоставляющий подробную информацию о действии.
  | 
 sameAs | URL-адрес |  Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, по которой можно идентифицировать шоу; например, страница шоу в Википедии. Оно должно отличаться от свойства url . | 
 inLanguage | Текст | Оригинальный язык серии в формате BCP 47 . | 
 genre | Текст |  Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"] | 
 keywords | Текст | Ключевые слова или теги, используемые для описания этого контента. Также допускается использование массива ключевых слов. Например, ["характеристика, биография"] может представлять собой массив ключевых слов для описания контента. | 
 releasedEvent |  PublicationEvent , FeaturedEvent или ExclusiveEvent |  Настоятельно рекомендуется Почему? – PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты выхода фильма в кинотеатрах.Кроме того, используйте FeaturedEvent , чтобы указать, что ваша служба позиционирует этот контент как оригинальный, избранный, специальный и т. д.ExclusiveEvent указывает, что ваша служба имеет эксклюзивные права на распространение, и указывает, где и когда.Подробности и примеры смотрите в разделе примеров .  | 
 releasedEvent.@type | Текст |  Обязательно — обязательно всегда устанавливайте для этого свойства одно из следующих значений:
  | 
 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 | Текст или рейтинг |  Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  | 
 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"}]
  | 
 @type | Текст |  Обязательно — всегда установлено значение TVEpisode . | 
 @id | URL-адрес |  Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
 url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» . | 
 url | URL-адрес |  Обязательно – канонический URL-адрес контента, который Google использует для сопоставления контента вашего фида с контентом в базах данных Google.url должен соответствовать следующим требованиям:
 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 . Обходной путь:
  | 
 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 , предоставляющий подробную информацию о действии.
  | 
 sameAs | Настоятельно рекомендуется Почему? URL-адрес |  URL-адрес справочной веб-страницы, на которой можно идентифицировать эпизод; например, страница эпизода в Википедии. Оно должно отличаться от свойства url . | 
 duration | Продолжительность | Время выполнения эпизода в формате ISO 8601 . Пожалуйста, используйте формат: «PT00H00M». | 
 releasedEvent |  PublicationEvent , FeaturedEvent или ExclusiveEvent |  Настоятельно рекомендуется Почему? – PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты выхода фильма в кинотеатрах.Кроме того, используйте FeaturedEvent , чтобы указать, что ваша служба позиционирует этот контент как оригинальный, избранный, специальный и т. д.ExclusiveEvent указывает, что ваша служба имеет эксклюзивные права на распространение, и указывает, где и когда.Подробности и примеры смотрите в разделе примеров .  | 
 releasedEvent.@type | Текст |  Обязательно — обязательно всегда устанавливайте для этого свойства одно из следующих значений:
  | 
 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 | Текст или рейтинг |  Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  | 
 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"}]
  | 
 @type | Текст |  Обязательно — всегда устанавливайте TVSeason . | 
 @id | URL-адрес |  Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
 url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» . | 
 url | URL-адрес |  Обязательно – канонический URL-адрес контента, который Google использует для сопоставления контента вашего фида с контентом в базах данных Google.url должен соответствовать следующим требованиям:
 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 , предоставляющий подробную информацию о действии.
  | 
 sameAs | URL-адрес |  Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, на которой можно определить сезон; например, страница сезона в Википедии. Оно должно отличаться от свойства url . | 
 releasedEvent |  PublicationEvent , FeaturedEvent или ExclusiveEvent |  Настоятельно рекомендуется Почему? – PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты выхода фильма в кинотеатрах.Кроме того, используйте FeaturedEvent , чтобы указать, что ваша служба позиционирует этот контент как оригинальный, избранный, специальный и т. д.ExclusiveEvent указывает, что ваша служба имеет эксклюзивные права на распространение, и указывает, где и когда.Подробности и примеры смотрите в разделе примеров .  | 
 releasedEvent.@type | Текст |  Обязательно — обязательно всегда устанавливайте для этого свойства одно из следующих значений:
  | 
 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 | Текст или рейтинг |  Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  | 
 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 | Человек , исполняющая группа или исполняющая роль |  Настоятельно рекомендуется Почему? : Массив актеров.
 Используйте массив для представления нескольких Person, PerformingGroups или PerformanceRoles.  | 
Использование типов Person или PerformingGroup
Укажите следующие свойства при использовании типа Person или PerformingGroup .
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 @type | Человек или исполняющая группа | Обязательно — всегда установлено значение «Человек» или «Исполняющая группа» . | 
 @id | URL-адрес |  Настоятельно рекомендуется Почему? - Идентификатор актера или исполнительской группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
  Обратите внимание, что   | 
 name | Текст | Обязательно — имя актера/актрисы/актёра/исполнительной группы. | 
 sameAs | URL-адрес |  Настоятельно рекомендуется Почему? - URL-адрес справочной веб-страницы, на которой можно идентифицировать актера или исполнительскую группу; например, страница актера в Википедии. Оно должно отличаться от свойства @id . | 
 Использование типа PerformanceRole
Укажите следующие свойства при использовании типа PerformanceRole .
| Свойство | Ожидаемый тип | Описание | 
|---|---|---|
 @type | ПроизводительностьРоль | Обязательно — всегда установлено значение PerformanceRole. | 
 roleName | Текст | Настоятельно рекомендуется Почему? - Роль, сыгранная, исполненная или исполненная актером. Пожалуйста, ознакомьтесь со списком допустимых значений здесь . | 
 characterName | Текст | Имя персонажа, сыгранного в какой-либо актерской или исполнительской роли. Не устанавливайте это поле, если тип актера — PerformingGroup . | 
 actor | Человек или исполняющая группа |  Необходимый -
  | 
 actor.@type | Человек или исполняющая группа | Обязательно — всегда установлено значение «Человек» или «Исполняющая группа» . | 
 actor.@id | URL-адрес |  Настоятельно рекомендуется Почему? - Идентификатор актера или исполнительской группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
  Обратите внимание, что   | 
 actor.name | Текст | Обязательно — имя актера/актрисы/актёра/исполнительной группы. | 
 actor.sameAs | URL-адрес | Настоятельно рекомендуется Почему? - URL-адрес справочной веб-страницы, на которой можно идентифицировать актера или исполнительскую группу; например, страница актера в Википедии. Оно должно отличаться от свойства actor.@id. | 
Допустимые имена ролей
 Эти значения требуют, чтобы actor.@type был Person .
 значение roleName | Описание | 
|---|---|
| "Камея" | Эпизодическая роль, также называемая эпизодической ролью, представляет собой краткое появление известного человека в произведении исполнительского искусства. | 
| «Актер голоса» | Голосовой спектакль — это спектакль, в котором используется голос актера, но актер не появляется на экране. Чаще всего это встречается в анимации, но также происходит, когда голос актера дублируется поверх речи другого актера. | 
| "Двойной" | Двойник — это человек, который заменяет другого актера так, что его лицо не показано. | 
| «Актер MotionCapture» | MotionCaptureActor — это человек, записывающий действия актеров-людей и использующий эту информацию для анимации цифровых моделей персонажей в компьютерной 2D- или 3D-анимации. | 
 Эти значения обычно принимаются для типов Person и PerformingGroup .
 значение roleName | Описание | 
|---|---|
| «Актер» | Актер или актриса — это человек, который изображает персонажа в спектакле в традиционных средствах театра или в современных средствах массовой информации, таких как кино, радио и телевидение. | 
| «Гостья Стар» | «Приглашенная звезда — это актер, который играет вымышленную роль и появляется в одном или нескольких эпизодах. В некоторых случаях приглашенная звезда может играть важного повторяющегося персонажа и может появляться много раз в сериале, несмотря на то, что он не является членом основного актерского состава. Установите значение «GuestStar», когда актерский состав выступает в качестве гостя или является гостем в шоу. Приглашенные звезды должны указываться только на уровне эпизода и не должны добавляться на уровне сериала. | 
| «Гость» | «Гостья ток-шоу. Обратите внимание, что хотя «GuestStar» — это вымышленная роль, «Гость» — это невымышленное появление. | 
| «Диктор» | Диктор — это человек, который произносит вступительные и заключительные речи шоу, представляет ведущего, участников и/или знаменитых гостей, описывает доступные призы, разогревает публику перед записью и развлекает ее во время перерывов. | 
| «Комментатор» | Комментатор комментирует игру или событие в режиме реального времени, обычно во время прямой трансляции. | 
| «Импрессионист» | Импрессионист или мимик – это исполнитель, чье выступление состоит из имитации звуков, голосов и манер знаменитостей и героев мультфильмов. | 
| "Хозяин" | Человек, который представляет, представляет или ведет телевизионные программы, часто выступая в качестве посредника для программы и аудитории. «Хозяин» — это, как правило, научно-популярная роль. | 
| "СоХост" | Лицо, которое проводит мероприятие/программу совместно с другим лицом(ами). | 
| "ГостьХост" | Приглашенный ведущий — это ведущий, обычно ток-шоу, который ведет программу вместо обычного ведущего, когда он недоступен. | 
| "Диктор" | Человек, который представляет/информирует общественность о новостях и событиях, происходящих в местном, национальном и международном масштабе, через программу телевизионных новостей. | 
| «Корреспондент» | Корреспондент или репортер с места происшествия обычно является журналистом или комментатором журнала или агентом, который публикует репортажи в газете, радио- или телевизионных новостях или компании другого типа из удаленного, часто удаленного места. | 
| "ШоуДжадж" | Судья - это человек, которого часто считают экспертом в области шоу, и ему отводится роль «судьи» для критики участников, которые проходят прослушивание и участвуют в конкурсе телесериала. | 
| "участник дискуссии" | Член дискуссионной или консультативной группы радио- или телевизионной группы. | 
| «Участник» | Участником конкурса или телеигры является лицо, принимающее в них участие. | 
| «Рассказчик» | Рассказчик — это человек, который что-то рассказывает, особенно персонаж, который рассказывает о событиях романа или повествовательной поэмы. | 
| «Музыкальный артист» | «Музыкальный исполнитель может быть человеком, группой или вымышленным персонажем, который обычно регулярно выступал перед публикой или записал музыкальные треки или музыкальные альбомы. Композиторы и авторы текстов должны иметь этот тип только в том случае, если авторы какого-либо музыкального произведения подразумевают, что они также вносят свой вклад в качестве основного исполнителя. Этот тип может использоваться для присоединения к выступлениям постоянных музыкантов или музыкальных групп, а также приглашенных музыкантов или музыкальных групп. | 
Различение главной и второстепенной роли актера.
 Чтобы различать главных/постоянных актеров и приглашенных/второстепенных актеров в телешоу, добавьте только основной актерский состав в сущности TVSeries и добавьте только приглашенный актерский состав или актерский состав с второстепенными ролями в сущности 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 
Роль актера неизвестна
Если роль актера неизвестна, мы рекомендуем просто предоставить информацию об актере, используя тип Person или PerformingGroup.
"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"
      }
  }
]
Известные роли для группы актеров
Если метаданные роли производительности неизвестны, мы рекомендуем предоставить информацию об актере, используя тип Person или PerformingGroup . В другом случае, когда эта информация известна, используйте тип 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"
  }
]
Связанные страницы
На следующих страницах вы найдете темы, связанные с этими свойствами: