В этом разделе представлены подробные сведения о свойствах разметки контента для типа сущности Movie .
Таблица технических характеристик
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
@context | Текст | Обязательно – всегда установлено значение ["http://schema.org", {"@language": "xx"}]
|
@type | Текст | Обязательно — всегда устанавливайте значение Movie для фильмов. |
@id | URL-адрес | Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .@id должен соответствовать следующим требованиям:
url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» . |
url | URL-адрес | Обязательно – канонический URL-адрес контента, который Google использует для сопоставления контента вашего фида с контентом в базах данных Google.url должен соответствовать следующим требованиям:
urlTemplate целевого объекта. |
name | Текст | Обязательно – Название фильма.
|
titleEIDR | Текст | Настоятельно рекомендуется Почему? - Идентификатор EIDR (Реестр идентификаторов развлечений), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, название EIDR фильма «Охотники за привидениями» — «10.5240/7EC7-228A-510A-053E-CBB8-J». |
editEIDR | Текст | Настоятельно рекомендуется Почему? - Идентификатор EIDR (Реестр развлекательных идентификаторов), представляющий конкретную редакцию/издание произведения кино или телевидения. Например, фильм «Охотники за привидениями» с названием EIDR «10.5240/7EC7-228A-510A-053E-CBB8-J» имеет несколько изменений, например «10.5240/1F2A-E1C5-680A-14C6-E76B-I» и «10.5240/8A35-3BEE-6497-5D12-9E4F-3». Свойство titleEIDR требуется , если указан editEIDR. |
potentialAction | СмотретьДействие | Обязательно, если применимо : объект разметки Action , предоставляющий подробную информацию о действии.
|
sameAs | URL-адрес | Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, по которой можно идентифицировать фильм; например, страница фильма в Википедии. Оно должно отличаться от свойства url . |
inLanguage | Текст | Оригинальный язык фильма в формате BCP 47 . |
genre | Текст | Упорядоченный список всех соответствующих жанров. Например: ["Действие", "Мода", "Окружающая среда", "Футбол"] |
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 символов.
|
duration | Продолжительность | Время выполнения фильма в формате ISO 8601 . Пожалуйста, используйте формат: «PT00H00M». |
director | Человек | Настоятельно рекомендуется Почему? Режиссер(ы) фильма. |
actor | Человек | Настоятельно рекомендуется Почему? Актеры фильма. |
producer | Организация или человек | Настоятельно рекомендуется Почему? Продюсер(ы) фильма. |
image | Объект изображения | Требуется для Google TV — изображения, связанные с фильмом. Дополнительные сведения об обязательных и необязательных свойствах, включаемых в image , см. в разделе Свойства изображения . |
trailer.description | Текст | Описание трейлера. См. пример трейлера . |
trailer.inLanguage | Текст | Язык трейлера в формате BCP 47 . |
trailer.url | URL-адрес | URL-адрес трейлера, размещенного в открытом доступе и загруженного соответствующими производственными студиями или авторизованными источниками. |
trailer.regionsAllowed | Место | Регионы, в которых разрешены СМИ. Если не указано, то предполагается, что это разрешено везде. Укажите страны в формате ISO 3166 . |
identifier | Стоимость имущества | Настоятельно рекомендуется Почему? - Внешний или другой идентификатор, однозначно идентифицирующий данную сущность. Допускается использование нескольких идентификаторов. Подробности смотрите в разделе Свойства идентификатора . |
review | Обзор | Обзор рейтингов фильма |
review.reviewRating | Рейтинг | Требуется, если предоставляется отзыв. Используется для указания рейтинга, данного в обзоре. |
contentRating | Текст или рейтинг | Требуется для контента для взрослых, в противном случае настоятельно рекомендуется . Почему? - Общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
|
contentRating.author | Организация | Обязательно, если contentRating использует Rating — название рейтингового агентства. |
contentRating.ratingValue | Текст | Требуется, если contentRating использует Rating — значение рейтинга. |
contentRating.advisoryCode | Текст | Консультативный код для контента. Допустимые значения: D, FV, L, S и V. D = Диалог, FV = Фэнтези-насилие, L = Язык, S = Сексуальный контент, V = Насилие. |
popularityScore | ПопулярностьОценкаСпецификация | Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы следует воспроизводить для пользователей. Эта оценка отражает популярность контента по сравнению с другим контентом в вашем каталоге; поэтому шкала оценок должна быть одинаковой для всех ваших каналов и всех объектов в вашем каталоге. По умолчанию рейтинг популярности объекта равен 0. |
popularityScore.@type | Текст | Всегда установлено значение PopularityScoreSpecification . |
popularityScore.value | Число | Неотрицательное числовое значение, указывающее на популярность объекта; более высокий балл означает более высокую популярность. |
popularityScore.eligibleRegion | Страна | Регион(ы), к которым применим этот показатель популярности. Если показатель популярности применим во всем мире, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .Note: Популярность конкретного региона имеет приоритет над глобальной популярностью (EARTH). |
category | Текст | Обязательно, если применимо . Заполните это свойство, если объект является вариантом Movie . Установите category на любое из следующих значений:
|
workExample | Фильм | Указывает варианты фильма. Включите это свойство в основную сущность Movie , а не в сущности Movie для вариантов версий. |
workExample.@id | URL-адрес | Для вариантов Movie это свойство предоставляет @id сущности Movie , вариантом которого является данный фильм. |
workExample.@type | Текст | Обязательно — всегда установлено значение Movie . Это можно представить как массив для Movie с несколькими вариантами. |
workExample.@id | URL-адрес | Обязательно — @id варианта Movie . |
workExample.name | Текст | Обязательно — название варианта Movie . |
workExample.category | Текст | Обязательно — тип варианта фильма конкретной версии. Установите категорию на любое из следующих значений:
|
Пример
Основной фильм
Фильм с расширенной версией.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie",
"url": "http://www.example.com/my_favorite_movie",
"name": "My Favorite Movie",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "https://example.com/package/example"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
"contentRating": "RATING NOT KNOWN",
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 78,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
},
"description": "This is my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"workExample": {
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut"
"category": "Extended Cut"
}
}
Расширенный вариант выреза
Расширенная версия основного фильма.
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "Movie",
"@id": "http://www.example.com/my_favorite_movie_extended_cut",
"url": "http://www.example.com/my_favorite_movie_extended_cut",
"name": "My Favorite Movie Extended Cut",
"potentialAction": {
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/my_favorite_movie_extended_cut?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",
"availabilityStarts": "2018-07-21T10:35:29Z",
"availabilityEnds": "2019-10-21T10:35:29Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package",
"identifier": "example.com:example_package"
},
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "CA"
}
]
}
},
"sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie_extended_cut",
"contentRating": {
"@type": "Rating",
"author": "MPAA",
"ratingValue": "R",
"advisoryCode": "FV"
},
"releasedEvent": {
"@type": "PublicationEvent",
"startDate": "2008-01-20",
"location": {
"@type": "Country",
"name": "US"
}
},
"description": "This is the extended cut of my favorite movie.",
"actor": [
{
"@type": "Person",
"name": "John Doe",
"sameAs": "https://en.wikipedia.org/wiki/John_Doe"
},
{
"@type": "Person",
"name": "Jane Doe",
"sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
}
],
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "IMDB_ID",
"value": "tt0123456"
}
],
"exampleOfWork": {
"@id": "http://www.example.com/my_favorite_movie",
}
"category": "Extended Cut"
}
Связанные страницы
На следующих страницах вы найдете темы, связанные с этими свойствами: