В этом разделе представлены сведения о свойствах разметки контента для типов сущностей 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 (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, titleEIDR для телесериала, известного как «Игра престолов», — «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 | ImageObject | Требуется для Google TV — изображения, относящиеся к сериалу. Дополнительные сведения об обязательных и необязательных свойствах для включения в image см. в разделе Свойства изображения . |
trailer.description | Текст | Описание трейлера. См. Пример трейлера . |
trailer.inLanguage | Текст | Язык трейлера в формате BCP 47 . |
trailer.url | URL-адрес | URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками. |
trailer.regionsAllowed | Место | Регионы, где СМИ разрешены. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 . |
identifier | Стоимость имущества | Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора . |
popularityScore | PopularityScoreSpecification | Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0. |
popularityScore.@type | Текст | Всегда устанавливайте PopularityScoreSpecification . |
popularityScore.value | Число | Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность. |
popularityScore.eligibleRegion | Страна | Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью. |
review | Обзор | Обзор рейтингов сериалов |
review.reviewRating | Рейтинг | Требуется, если предоставлен review Используется для указания рейтинга, данного в обзоре. |
contentRating | Текст или рейтинг | Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, допускаются два варианта:
|
contentRating.author | Текст или организация | Требуется, если contentRating используется Rating — название рейтингового агентства. На странице Content Rating Agency приведен список одобренных рейтинговых агентств. |
contentRating.ratingValue | Текст | Требуется, если contentRating используется Rating — значение рейтинга. |
contentRating.advisoryCode | Текст | Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фантазия с насилием, L = язык, S = сексуальное содержание, V = насилие. |
ТВЭпизод
Свойство | Ожидаемый тип | Описание |
---|---|---|
@context | Текст | Обязательное – всегда установлено ["http://schema.org", {"@language": "xx"}]
|
@type | Текст | Обязательно — всегда установлено значение TVEpisode . |
@id | URL-адрес | Обязательно - Идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
url -адрес объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url -адрес объекта как @id . См. раздел «Идентификатор» для получения более подробной информации. |
url | URL-адрес | Обязательно — канонический URL контента , который Google использует для сопоставления контента в вашем фиде с контентом в базах данных Google.url должен соответствовать следующим требованиям:
urlTemplate целевого объекта. |
name | Текст | Обязательно - Название эпизода.
|
titleEIDR | Текст | Настоятельно рекомендуется Почему? - Идентификатор EIDR (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, titleEIDR для первого эпизода первого сезона телесериала, известного как «Игра престолов», имеет вид «10.5240/B6A6-1B32-B5E5-D5CB-6B84-X». |
editEIDR | Текст | Настоятельно рекомендуется Почему? - Идентификатор EIDR (реестр идентификаторов развлечений), представляющий конкретную редакцию/редакцию произведения кино или телевидения. Например, первый эпизод первого сезона телесериала, известного как «Игра престолов», чей заголовок EIDR — «10.5240/B6A6-1B32-B5E5-D5CB-6B84-X», имеет одно редактирование, например, «10.5240/FB97-C847- 2969-D0AB-ECD1-C". Свойство titleEIDR требуется , когда предоставляется editEIDR. |
inLanguage | Текст | Оригинальный язык сериала в формате BCP 47 . |
episodeNumber | Целое число | Обязательное — число, указывающее позицию этой серии в порядке следования серий в сезоне. episodeNumber нужно перезапускать для каждого сезона; то есть первая серия каждого сезона должна быть 1. |
partOfSeason | ТВСезон | Обязательное поле — телесезон, к которому принадлежит этот выпуск. Даже если TVEpisode не имеет соответствующего TVSeason , вам все равно необходимо предоставить свойства partOfSeason.@id и partOfSeason.seasonNumber . Обходной путь:
|
partOfSeason.@type | Текст | Обязательно — всегда установлено значение TVSeason . |
partOfSeason.@id | URL-адрес | Обязательно — @id TVSeason , частью которого является этот выпуск. |
partOfSeason.seasonNumber | Целое число | Обязательное — число, указывающее позицию этого сезона в порядке следования сезонов в сериале. |
partOfSeries | Сериал | Обязательное поле — сериал, к которому принадлежит этот выпуск. |
partOfSeries.@type | Текст | Обязательно — всегда установлено значение TVSeries . |
partOfSeries.@id | URL-адрес | Обязательно — @id TVSeries , частью которого является этот выпуск. |
partOfSeries.name | Текст | Обязательно - Название сериала. |
partOfSeries.sameAs | Текст | URL-адрес справочной веб-страницы, которая может идентифицировать шоу; например, страница шоу в Википедии. Это должно отличаться от свойства url . |
potentialAction | СмотретьДействие | Обязательно, если применимо — объект разметки Action , предоставляющий сведения о действии.
|
sameAs | Настоятельно рекомендуется Почему? URL-адрес | URL-адрес справочной веб-страницы, которая может идентифицировать эпизод; например, страница эпизода в Википедии. Это должно отличаться от свойства url . |
duration | Продолжительность | Продолжительность эпизода в формате ISO 8601 . Пожалуйста, используйте формат: "PT00H00M". |
releasedEvent | PublicationEvent , FeaturedEvent или ExclusiveEvent | Настоятельно рекомендуется Почему? - PublicationEvent используется для указания исходного (глобального или локального) выпуска контента издателем, например исходной даты кинотеатрального выпуска фильма.Кроме того, используйте FeaturedEvent чтобы указать, что ваша служба продает этот контент как оригинальный, рекомендуемый, специальный и т. д.ExclusiveEvent указывает, что ваша служба имеет исключительные права на распространение и указывает, где и когда.Подробности и примеры см. в разделе примеров . |
releasedEvent.@type | Текст | Обязательно — всегда устанавливайте для этого свойства одно из следующих значений:
|
releasedEvent.location | Страна | Обязательно — регионы, связанные с этим событием. Для PublicationEvent это регион, в котором был опубликован контент.Для FeaturedEvent и ExclusiveEvent это регион, в котором контент является избранным или эксклюзивным.Используйте коды ISO 3166 для стран. Чтобы указать везде в мире, установите EARTH . |
releasedEvent.startDate | Дата или дата и время | Рекомендуется — требуется для ExclusiveEvent — дата начала публикации объекта.Для PublicationEvent это обозначает начальную дату выпуска этого объекта, например дату, когда фильм был впервые выпущен в кинотеатрах.Для ExclusiveEvent и FeaturedEvent это представляет начальную дату, когда объект является эксклюзивным или рекомендуемым. |
releasedEvent.endDate | Дата или дата и время | Рекомендуется — требуется для ExclusiveEvent — применимо только к типам ExclusiveEvent и FeaturedEvent .Для ExclusiveEvent это дата истечения срока действия прав на содержимое.Для FeaturedEvent это последняя дата, когда провайдер представляет объект.Если содержимое является бессрочным эксклюзивным или рекомендуемым, установите endDate на 20 лет с текущей даты. |
releasedEvent.publishedBy | Организация или лицо | Необязательно — организация или лицо, опубликовавшее этот объект. |
description | Текст | Настоятельно рекомендуется Почему? Синопсис эпизода. Синопсис сюжета предпочтительнее фактического резюме. ограничение в 300 символов.
|
genre | Текст | Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"] |
keywords | Текст | Ключевые слова или теги, используемые для описания этого контента. Также разрешен массив ключевых слов. Например, ["особенность, биография"] может быть массивом ключевых слов для описания контента. |
actor | Персона или исполнительская группа или исполнительская роль | Настоятельно рекомендуется Почему? Массив актеров эпизода. См. руководство по моделированию здесь . |
director | Человек | Настоятельно рекомендуется Почему? Режиссер (ы) эпизода. |
producer | Организация или лицо | Настоятельно рекомендуется Почему? Производитель(и) сезона. |
image | ImageObject | Настоятельно рекомендуется Почему? для Google TV — различные изображения, связанные с телеэпизодом. Дополнительные сведения об обязательных и необязательных свойствах для включения в image см. в разделе Свойства изображения . |
trailer.description | Текст | Описание трейлера. См. Пример трейлера . |
trailer.inLanguage | Текст | Язык трейлера в формате BCP 47 . |
trailer.url | URL-адрес | URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками. |
trailer.regionsAllowed | Место | Регионы, где СМИ разрешены. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 . |
review | Обзор | Обзор рейтингов телесериала |
review.reviewRating | Рейтинг | Требуется, если предоставлен review Используется для указания рейтинга, данного в обзоре. |
contentRating | Текст или рейтинг | Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, допускаются два варианта:
|
contentRating.author | Текст или организация | Требуется, если contentRating используется Rating — название рейтингового агентства. На странице Content Rating Agency приведен список одобренных рейтинговых агентств. |
contentRating.ratingValue | Текст | Требуется, если contentRating используется Rating — значение рейтинга. |
contentRating.advisoryCode | Текст | Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фантазия с насилием, L = язык, S = сексуальное содержание, V = насилие. |
identifier | Стоимость имущества | Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора . |
popularityScore | PopularityScoreSpecification | Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0. |
popularityScore.@type | Текст | Всегда устанавливайте PopularityScoreSpecification . |
popularityScore.value | Число | Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность. |
popularityScore.eligibleRegion | Страна | Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью. |
ТВСезон
Свойство | Ожидаемый тип | Описание |
---|---|---|
@context | Текст | Обязательное – всегда установлено ["http://schema.org", {"@language": "xx"}]
|
@type | Текст | Обязательно — всегда установлено значение TVSeason . |
@id | URL-адрес | Обязательно - Идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
url -адрес объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем вам использовать url -адрес объекта как @id . См. раздел «Идентификатор» для получения более подробной информации. |
url | URL-адрес | Обязательно — канонический URL контента , который Google использует для сопоставления контента в вашем фиде с контентом в базах данных Google.url должен соответствовать следующим требованиям:
urlTemplate целевого объекта. |
name | Текст | Требуется - Название этого телесезона.
|
titleEIDR | Текст | Настоятельно рекомендуется Почему? - Идентификатор EIDR (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, titleEIDR для первого сезона телесериала, известного как «Игра престолов», — «10.5240/FD91-C72C-4161-FCBA-058B-1». |
seasonNumber | Целое число | Обязательное — число, указывающее позицию этого сезона в порядке следования сезонов в сериале. |
partOfSeries | Сериал | Обязательно - сериал, которому принадлежит этот сезон. |
partOfSeries.@type | Текст | Обязательно — всегда установлено значение TVSeries . |
partOfSeries.@id | URL-адрес | Обязательно — @id TVSeries , частью которого является этот сезон. |
partOfSeries.name | Текст | Обязательно - Название сериала. |
partOfSeries.sameAs | Текст | URL-адрес справочной веб-страницы, которая может идентифицировать шоу; например, страница шоу в Википедии. Это должно отличаться от свойства url . |
potentialAction | СмотретьДействие | Обязательно, если применимо — объект разметки Action , предоставляющий сведения о действии.
|
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 | ImageObject | Изображения, связанные с TVSeason. Дополнительные сведения об обязательных и необязательных свойствах для включения в image см. в разделе Свойства изображения . |
genre | Текст | Упорядоченный список всех соответствующих жанров. Например: ["Action", "Fashion", "Environment", "Football"] |
keywords | Текст | Ключевые слова или теги, используемые для описания этого контента. Также разрешен массив ключевых слов. Например, ["особенность, биография"] может быть массивом ключевых слов для описания контента. |
trailer.description | Текст | Описание трейлера. См. Пример трейлера . |
trailer.inLanguage | Текст | Язык трейлера в формате BCP 47 . |
trailer.url | URL-адрес | URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками. |
trailer.regionsAllowed | Место | Регионы, где СМИ разрешены. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 . |
identifier | Стоимость имущества | Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данный объект. Допускается использование нескольких идентификаторов. Подробнее см. в разделе Свойства идентификатора . |
popularityScore | PopularityScoreSpecification | Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0. |
popularityScore.@type | Текст | Всегда устанавливайте PopularityScoreSpecification . |
popularityScore.value | Число | Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность. |
popularityScore.eligibleRegion | Страна | Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью. |
review | Обзор | Обзор рейтингов телесезона |
review.reviewRating | Рейтинг | Требуется, если предоставлен review Используется для указания рейтинга, данного в обзоре. |
contentRating | Текст или рейтинг | Требуется для контента для взрослых, в противном случае настоятельно рекомендуется — общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, допускаются два варианта:
|
contentRating.author | Текст или организация | Требуется, если contentRating используется Rating — название рейтингового агентства. На странице Content Rating Agency приведен список одобренных рейтинговых агентств. |
contentRating.ratingValue | Текст | Требуется, если contentRating используется Rating — значение рейтинга. |
contentRating.advisoryCode | Текст | Консультативный код для контента. Допустимые значения включают D, FV, L, S и V. D = диалог, FV = фантазия с насилием, L = язык, S = сексуальное содержание, V = насилие. |
Спецификации актера
Свойство actor
в типах сущностей TVSeries
, TVEpisode
и TVSeason
позволяет указать дополнительные сведения об актерах, включая имена их персонажей и роли, которые они играют в телешоу. Следующие разделы охватывают то же самое, а также несколько примеров, поясняющих использование.
Свойство | Ожидаемый тип | Описание |
---|---|---|
actor | Персона или исполнительская группа или исполнительская роль | Настоятельно рекомендуется Почему? : массив актеров.
Используйте массив для представления нескольких Person, PerformingGroups или PerformanceRoles. |
Использование типов Person
или PerformingGroup
Укажите следующие свойства, если используется тип Person или PerformingGroup .
Свойство | Ожидаемый тип | Описание |
---|---|---|
@type | Человек или исполнительская группа | Обязательное — всегда установлено значение Person или PerformingGroup . |
@id | URL-адрес | Настоятельно рекомендуется Почему? - Идентификатор актера или исполняющей группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
Обратите внимание, что |
name | Текст | Обязательно - Имя актера/актрисы/участника актерского состава/исполняющей группы. |
sameAs | URL-адрес | Настоятельно рекомендуется Почему? - URL-адрес справочной веб-страницы, которая может идентифицировать актера или исполняющую группу; например, страница актера в Википедии. Это должно отличаться от свойства @id . |
Использование типа PerformanceRole
Укажите следующие свойства при использовании типа PerformanceRole.
Свойство | Ожидаемый тип | Описание |
---|---|---|
@type | ПроизводительностьРоль | Обязательное — всегда установлено значение PerformanceRole. |
roleName | Текст | Настоятельно рекомендуется Почему? - Роль, сыгранная, исполненная или исполняемая актером. См. список допустимых значений здесь . |
characterName | Текст | Имя персонажа, сыгранного в какой-либо актёрской или исполнительской роли. Не устанавливайте это поле, если тип актера — PerformingGroup . |
actor | Человек или исполнительская группа | Требуется -
|
actor.@type | Человек или исполнительская группа | Обязательное — всегда установлено значение Person или PerformingGroup . |
actor.@id | URL-адрес | Настоятельно рекомендуется Почему? - Идентификатор актера или исполняющей группы в формате URI; например, https://example.com/actor/abc. @id должен соответствовать следующим требованиям:
Обратите внимание, что |
actor.name | Текст | Обязательно - Имя актера/актрисы/участника актерского состава/исполняющей группы. |
actor.sameAs | URL-адрес | Настоятельно рекомендуется Почему? - URL-адрес справочной веб-страницы, которая может идентифицировать актера или исполняющую группу; например, страница актера в Википедии. Это должно отличаться от свойства Actor.@id. |
Допустимые имена ролей
Эти значения требуют, чтобы actor.@type
был Person
.
значение roleName | Описание |
---|---|
"Камея" | Эпизодическая роль, также называемая эпизодическим появлением, представляет собой краткое появление известного человека в произведении исполнительского искусства. |
"Голос актера" | Голосовой спектакль - это спектакль, в котором используется голос актера, но актер не появляется на экране. Это чаще всего встречается в анимации, но также происходит, когда голос актера дублируется поверх речи другого актера. |
"Двойной" | Двойник - это человек, который заменяет другого актера так, что его лицо не отображается. |
"Актер захвата движения" | MotionCaptureActor относится к человеку, записывающему действия актеров и использующему эту информацию для анимации цифровых моделей персонажей в 2D- или 3D-анимации компьютера. |
Эти значения общеприняты для типов Person
и PerformingGroup
.
значение roleName | Описание |
---|---|
"Актер" | An actor or actress is a person who portrays a character in a performance in the traditional medium of the theater or in modern media such as film, radio, and television. |
"GuestStar" | "A guest star is an actor who plays a fictional role and appears in one or a few episodes. In some cases a guest star may play an important recurring character and may appear many times in a series, despite not being a member of the main cast. Set value to "GuestStar" when the cast has a guest performance or is a guest on the show. Guest stars should only be provided at the episode level, and should not be added at the TVSeries level. |
"Guest" | "A guest on a talk show. Note that while "GuestStar" is a fictional role, "Guest" is a non fictional appearance. |
"Announcer" | An announcer is a person who delivers opening and closing spiels for the show, introduces the host, contestants and/or celebrity guests, describes the prizes available, and warms up the audience before taping and keeps them entertained during breaks. |
"Commentator" | A commentator provides a real-time commentary of a game or event, usually during a live broadcast. |
"Impressionist" | An impressionist or a mimic is a performer whose act consists of imitating sounds, voices and mannerisms of celebrities and cartoon characters. |
"Host" | A person who introduces, presents or hosts television programs, often serving as a mediator for the program and the audience. The "Host" is generally a non-fiction role. |
"CoHost" | A person who hosts an event/program jointly with another person(s). |
"GuestHost" | A guest host is a host, usually of a talk show, that hosts the program in lieu of the regular host when not available. |
"Newscaster" | A person who presents/informs the public about news and events happening on a local, national, and international scale through a TV news program. |
"Correspondent" | A correspondent or on-the-scene reporter is usually a journalist or commentator for a magazine, or an agent who contributes reports to a newspaper, or radio or television news, or another type of company, from a remote, often distant, location. |
"ShowJudge" | A judge is a person who is often considered an expert in the field of the show and is given the role of "judge" to critique contestants that audition for and enter the competition of the TV series. |
"Panelist" | A member of a discussion or advisory panel of a radio or television panel. |
"Contestant" | A contestant in a competition or game show is a person who takes part in it. |
"StoryNarrator" | Narrator is a person who narrates something, especially a character who recounts the events of a novel or narrative poem |
"MusicalArtist" | "A Musical artist can be a person or a group or a fictional character that have typically performed in front of an audience on a regular basis or have recorded musical tracks or musical albums. Composers and lyricists should only have this type if the credits of some musical work imply they also contribute as main performer. This type can be used to associate permanent Musicians or Musician Groups, and guest Musicians or Musician Groups to shows. |
Differentiating between a main and supporting role of an actor
To differentiate between the main/regular and guest/supporting actors in a TV show, add the main cast on TVSeries
entities only and add only the guest cast or cast with supporting roles on the TVEpisode
entities. Make sure the main/regular cast is not added to the TVEpisode
entities.
Examples
TVSeries
, TVEpisode
, and TVSeason
example
TVSeries
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show/",
"url": "http://www.example.com/my_favorite_tv_show/",
"name": "My Favorite TV Show",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.1,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite TV show.",
"contentRating": "RATING NOT KNOWN",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0903747"
}
]
}
TVEpisode
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVEpisode",
"@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
"url": "http://www.example.com/my_favorite_tv_show/s7/e14",
"name": "John Doe returns with a horse.",
"episodeNumber": 14,
"contentRating": "TVPG TV-MA",
"partOfSeason": {
"@type": "TVSeason",
"@id": "http://www.example.com/my_favorite_tv_show/s7",
"seasonNumber": 7
},
"partOfSeries": {
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show",
"name": "My Favorite TV Show",
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
"duration": "PT00H25M",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2014-01-09",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 3.9,
"eligibleRegion": "EARTH"
},
"description": "John Doe returns to the village three years after his disappearance.",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
],
"identifier": {
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt3453320"
}
}
TVSeason
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "TVSeason",
"@id": "http://www.example.com/my_favorite_tv_show/s7",
"url": "http://www.example.com/my_favorite_tv_show/s7",
"name": "Season 7",
"seasonNumber": 7,
"partOfSeries": {
"@type": "TVSeries",
"@id": "http://www.example.com/my_favorite_tv_show",
"name": "My Favorite TV Show",
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
},
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/IOSPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"availabilityStarts": "2017-07-21T10:35:29Z",
"availabilityEnds": "2018-10-21T10:35:29Z",
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2010-09-23",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "The seventh season of My Favorite TV Show.",
"actor": [
{
"@type": "Person",
"@id": "http://www.example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "Person",
"@id": "http://www.example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
]
}
Actor
property examples
Role of actor is unknown
When the role of an actor is unknown, our recommendation is to just provide the actor information using either the Person or PerformingGroup type
"actor": [
{
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
},
{
"@type": "PerformingGroup",
"@id": "https://example.com/artists/ramones",
"name": "Ramones",
"sameAs": "https://en.wikipedia.org/wiki/Ramones"
}
]
Role of actor is known
When the role of an actor is known, our recommendation is to provide the actor information using the PerformanceRole type
"actor": [
{
"@type": "PerformanceRole",
"roleName": "GuestStar",
"characterName": "Dr. Peter Venkman",
"actor": {
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
}
},
{
"@type": "PerformanceRole",
"roleName": "Host",
"actor": {
"@type": "Person",
"@id": "https://example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
}
}
]
Known roles for subset of actors
When performance role metadata is not known, our recommendation is to provide the actor information using either the Person or PerformingGroup type. For the other case where this info is known use the PerformanceRole type. These types can be added in the same array together .
"actor": [
{
"@type": "PerformanceRole",
"roleName": "Host",
"actor": {
"@type": "Person",
"@id": "https://example.com/actor/john_doe",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/john_doe"
}
},
{
"@type": "Person",
"@id": "https://example.com/actor/jane_doe",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/jane_doe"
},
{
"@type": "PerformingGroup",
"@id": "https://example.com/artists/ramones",
"name": "Ramones",
"sameAs": "https://en.wikipedia.org/wiki/Ramones"
}
]
Related pages
Check out the following pages for the topics related to these properties: