В этом разделе представлены подробные сведения о свойствах разметки контента для типов сущностей 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-адрес | Обязательно – @idTVSeason, частью которого является этот выпуск. | 
| partOfSeason.seasonNumber | Целое число | Обязательно — число, обозначающее позицию этого сезона в порядке сезонов сериала. | 
| partOfSeries | Сериал | Обязательно — сериал, к которому относится этот эпизод. | 
| partOfSeries.@type | Текст | Обязательно — всегда установлено значение TVSeries. | 
| partOfSeries.@id | URL-адрес | Обязательно — @idTVSeries, частью которого является этот эпизод. | 
| 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-адрес | Обязательно — @idTVSeries, в котором участвует этот сезон. | 
| 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"
  }
]
Связанные страницы
На следующих страницах вы найдете темы, связанные с этими свойствами: