Эта страница переведена с помощью Cloud Translation API.

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

В этом разделе представлены подробные сведения о свойствах разметки контента для типов сущностей 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 объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой. В форме унифицированного идентификатора ресурса (URI) Домен, используемый для значения @id, должен принадлежать вашей организации. Поскольку `url` сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать `url` сущности в формате `@id` . Более подробную информацию см. в разделе «Идентификатор» .
`url`	URL	Обязательно — канонический URL-адрес контента, который Google использует для сопоставления контента в вашей ленте с контентом в базах данных Google. `url` должен соответствовать следующим требованиям: `url` должен быть уникальным во всем мире. `url` должен содержать рабочий канонический URL, который Google может проиндексировать. Для воспроизведения прямой ссылки используйте свойство `urlTemplate` целевого объекта.
`name`	Текст	Обязательно — название шоу. Используйте массив для перечисления имен на разных языках. См. пример " Несколько регионов и языков" . Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
`titleEIDR`	Текст	Настоятельно рекомендуется. Почему? — Идентификатор EIDR (Entertainment Identifier Registry), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, идентификатор titleEIDR для телесериала «Игра престолов» — «10.5240/C1B5-3BA1-8991-A571-8472-W».
`potentialAction`	WatchAction	Обязательный (при необходимости ) объект разметки действия , содержащий подробную информацию о действии. Если контент доступен в формате «Видео по запросу» (VoD), это свойство является обязательным; объект разметки Action должен содержать прямую ссылку на контент. Если контент доступен на канале LiveTV, это свойство является необязательным; вместо этого связанная сущность `BroadcastService` предоставляет прямую ссылку на канал. `TVSeries` может быть доступен как в формате VoD, так и в формате LiveTV. Используйте массив для указания различных прямых ссылок в нескольких регионах. См. пример " Несколько регионов и языков" .
`sameAs`	URL	Настоятельно рекомендуется. Почему? URL-адрес веб-страницы, которая позволяет идентифицировать сериал; например, страница сериала в Википедии. Этот адрес должен отличаться от свойства `url` .
`inLanguage`	Текст	Настоятельно рекомендуется. Оригинальный язык сериала в формате BCP 47 .
`genre`	Текст	Упорядоченный список всех соответствующих жанров. Например: `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Текст	Ключевые слова или теги, используемые для описания данного контента. Также допускается использование массива ключевых слов. Например, ["feature, biography"] может представлять собой массив ключевых слов для описания контента.
`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`	Спецификация показателя популярности	Настоятельно рекомендуется. Почему? Это показатель, который 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` - название рейтингового агентства. Список принимаемых рейтинговых агентств см. на странице « Агентства по рейтингу контента».
`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 объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой. В форме унифицированного идентификатора ресурса (URI) Домен, используемый для значения @id, должен принадлежать вашей организации. Поскольку `url` сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать `url` сущности в формате `@id` . Более подробную информацию см. в разделе «Идентификатор» .
`url`	URL	Обязательно — канонический URL-адрес контента, который Google использует для сопоставления контента в вашей ленте с контентом в базах данных Google. `url` должен соответствовать следующим требованиям: `url` должен быть уникальным во всем мире. `url` должен содержать рабочий канонический URL, который Google может проиндексировать. Для воспроизведения прямой ссылки используйте свойство `urlTemplate` целевого объекта.
`name`	Текст	Обязательно — название эпизода. Используйте массив для перечисления имен на разных языках. См. пример представления на нескольких языках . Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
`titleEIDR`	Текст	Настоятельно рекомендуется. Почему? — Идентификатор EIDR (Entertainment Identifier Registry), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, titleEIDR для первого эпизода первого сезона телесериала «Игра престолов» — это "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
`editEIDR`	Текст	Настоятельно рекомендуется. Почему? — Идентификатор EIDR (Entertainment Identifier Registry), представляющий собой конкретную редакцию/издание фильма или телесериала. Например, в первом эпизоде первого сезона телесериала «Игра престолов», заголовок которого имеет формат "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`	WatchAction	Обязательный (при необходимости ) объект разметки действия , содержащий подробную информацию о действии. Если контент доступен в формате «Видео по запросу» (VoD), это свойство является обязательным; объект разметки Action должен содержать прямую ссылку на контент. Если контент доступен на канале LiveTV, это свойство является необязательным; вместо этого связанная сущность `BroadcastService` предоставляет прямую ссылку на канал. Эпизод `TVEpisode` может быть доступен как в формате VoD, так и в прямом эфире. Используйте массив для указания различных прямых ссылок в нескольких регионах. См. пример " Несколько регионов и языков" .
`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`	Текст	Ключевые слова или теги, используемые для описания данного контента. Также допускается использование массива ключевых слов. Например, ["feature, biography"] может представлять собой массив ключевых слов для описания контента.
`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` - название рейтингового агентства. Список принимаемых рейтинговых агентств см. на странице « Агентства по рейтингу контента».
`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:` популярность, специфичная для данного региона, имеет приоритет над глобальной (земной) популярностью.

ТВСезон

Свойство	Ожидаемый тип	Описание
`@context`	Текст	Обязательно - Всегда устанавливайте значение `["http://schema.org", {"@language": "xx"}]` Где "xx" обозначает язык строк в потоке. Для каждого контекста корневой сущности параметр @language должен быть установлен на соответствующий код языка в формате BCP 47. Например, если язык установлен на испанский, предполагается, что имена на испанском, даже если язык субтитров/дубляжа — английский.
`@type`	Текст	Обязательно - Всегда устанавливайте значение `TVSeason` .
`@id`	URL	Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc . `@id` должен соответствовать следующим требованиям: Уникальный дизайн во всем вашем каталоге. Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство url объекта show). Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой. В форме унифицированного идентификатора ресурса (URI) Домен, используемый для значения @id, должен принадлежать вашей организации. Поскольку `url` сущности соответствует всем требованиям к идентификатору, мы рекомендуем использовать `url` сущности в формате `@id` . Более подробную информацию см. в разделе «Идентификатор» .
`url`	URL	Обязательно — канонический URL-адрес контента, который Google использует для сопоставления контента в вашей ленте с контентом в базах данных Google. `url` должен соответствовать следующим требованиям: `url` должен быть уникальным во всем мире. `url` должен содержать рабочий канонический URL, который Google может проиндексировать. Для воспроизведения прямой ссылки используйте свойство `urlTemplate` целевого объекта.
`name`	Текст	Обязательно — название этого телесезона. Используйте массив для перечисления имен на разных языках. См. пример представления на нескольких языках . Обратите внимание, что для каждой локали поддерживается только одно имя (пара «язык-страна»).
`titleEIDR`	Текст	Настоятельно рекомендуется. Почему? — Идентификатор EIDR (Entertainment Identifier Registry), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, идентификатор 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`	WatchAction	Обязательный (при необходимости ) объект разметки действия , содержащий подробную информацию о действии. Если контент доступен в формате «Видео по запросу» (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	Изображения относятся к телевизионному сезону. Более подробную информацию об обязательных и необязательных свойствах, которые необходимо включить в `image` , см. в разделе «Свойства изображения» .
`genre`	Текст	Упорядоченный список всех соответствующих жанров. Например: `["Action", "Fashion", "Environment", "Football"]`
`keywords`	Текст	Ключевые слова или теги, используемые для описания данного контента. Также допускается использование массива ключевых слов. Например, ["feature, biography"] может представлять собой массив ключевых слов для описания контента.
`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:` популярность, специфичная для данного региона, имеет приоритет над глобальной (земной) популярностью.
`review`	Обзор	Рейтинги телесезона по результатам рецензий
`review.reviewRating`	Рейтинг	Обязательно, если `review` предоставлен. Используется для указания оценки, данной в отзыве.
`contentRating`	Текст или оценка	Обязателен для контента для взрослых, в противном случае настоятельно рекомендуется — Общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, допускаются два варианта: Рейтинговое агентство добавляет к рейтингу пробел между словами. Например, рейтинг "TV-MA" от агентства "TVPG" в США следует обозначать как "TVPG TV-MA". См. список агентств . Значение "Рейтинг неизвестен" (регистр не учитывается) указывает на то, что рейтинг контента вам неизвестен.
`contentRating.author`	Организация	Обязательно, если `contentRating` использует `Rating` - название рейтингового агентства. Список принимаемых рейтинговых агентств см. на странице « Агентства по рейтингу контента».
`contentRating.ratingValue`	Текст	Обязательно, если `contentRating` использует `Rating` — значение рейтинга.
`contentRating.advisoryCode`	Текст	Рекомендованный код для контента. Допустимые значения: D, FV, L, S и V. D = Диалоги, FV = Фантастическое насилие, L = Ненормативная лексика, S = Сексуальное содержание, V = Насилие.

Технические характеристики актёра

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

Свойство Ожидаемый тип Описание

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

actor

Лицо , Исполнительная группа или Исполнительная роль

Настоятельно рекомендуется. Почему? : Широкий выбор актеров.

Используйте тип PerformanceRole, если известна исполняемая роль и (при необходимости) имя персонажа, участвующего (участвующих) в актёрском составе. В этом случае в объект PerformanceRole встраивается объект ActorPerson или PerformingGroup .
Используйте тип «Человек» , чтобы указать конкретного(ых) актера(ов), или «Группа исполнителей» , чтобы предоставить подробную информацию об исполнительской группе(ах)/группе(ах), если роль(и), которую(ые) играет(ют) участник(и) труппы, неизвестны.

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

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

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

Свойство	Ожидаемый тип	Описание
`@type`	Лицо или исполнительская группа	Обязательно - всегда выбирайте Person или PerformingGroup.
`@id`	URL	Настоятельно рекомендуется. Почему? — Идентификатор актеров или исполнительской группы в формате URI; например, https://example.com/actor/abc. `@id` должен соответствовать следующим требованиям: Уникальные для всего вашего каталога данные по каждому актеру/группе исполнителей. Идентификатор должен быть стабильным и не меняться со временем. Он будет рассматриваться как непрозрачная строка и не обязательно должен быть рабочей ссылкой. В форме унифицированного идентификатора ресурса (URI) Домен, используемый для значения `@id` , должен принадлежать вашей организации. Обратите внимание, что `@id` используемый в свойстве actor, должен использоваться единообразно во всей ленте. Например, если есть два фильма с участием одного и того же актера, то значение `@id` должно оставаться одинаковым для этих двух объектов actor.
`name`	Текст	Обязательно — имя актера/актрисы/участника труппы/исполняющей группы.
`sameAs`	URL	Настоятельно рекомендуется. Почему? — URL-адрес веб-страницы, которая позволяет идентифицировать актера или исполнительскую группу; например, страница актера в Википедии. Этот URL-адрес должен отличаться от свойства `@id` .

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

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

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

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

Для этих значений actor.@type должен быть Person .

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

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

значение `roleName`	Описание
"Актер"	Актер или актриса — это человек, который воплощает образ персонажа в представлении в традиционном театральном формате или в современных средствах массовой информации, таких как кино, радио и телевидение.
"Гостевая звезда"	«Приглашенная звезда — это актер, который играет вымышленную роль и появляется в одном или нескольких эпизодах. В некоторых случаях приглашенная звезда может играть важного второстепенного персонажа и появляться в сериале много раз, несмотря на то, что не является членом основного актерского состава. Установите значение «Приглашенная звезда», если актер играет эпизодическую роль или является гостем в сериале. Приглашенных звезд следует указывать только на уровне эпизода, а не добавлять на уровне телесериала».
«Гость»	"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.
"Хозяин"	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.
"Диктор"	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.

Примеры

`TVSeries` , `TVEpisode` , and `TVSeason` example

Сериал

{
  "@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` 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:

Свойства разметки контента телешоу Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Сериал

Эпизод ТВ

ТВСезон

Технические характеристики актёра

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

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

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

Differentiating between a main and supporting role of an actor

Примеры

TVSeries , TVEpisode , and TVSeason example

Сериал

Эпизод ТВ

ТВСезон

Actor property examples

Role of actor is unknown

Role of actor is known

Known roles for subset of actors

Related pages

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

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

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

`TVSeries` , `TVEpisode` , and `TVSeason` example

`Actor` property examples