В этом разделе представлены сведения о свойствах разметки содержимого для типа объекта 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/8А35-3БЭЭ-6497-5Д12-9Э4Ф-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 | ImageObject | Требуется для 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 | PopularityScoreSpecification | Настоятельно рекомендуется Почему? Оценка, которую Google использует, а также другие сигналы, чтобы определить, какие медиафайлы воспроизводить для пользователей. Эта оценка представляет популярность контента по отношению к другому контенту в вашем каталоге; поэтому шкала оценки должна быть одинаковой для всех ваших фидов, среди всех объектов в вашем каталоге. По умолчанию показатель популярности сущности равен 0. |
popularityScore.@type | Текст | Всегда устанавливайте PopularityScoreSpecification . |
popularityScore.value | Число | Неотрицательное числовое значение, указывающее популярность объекта; более высокий балл означает более высокую популярность. |
popularityScore.eligibleRegion | Страна | Регион(ы), где применяется этот показатель популярности. Если показатель популярности применим глобально, установите значение EARTH . По умолчанию для этого свойства установлено значение EARTH .Note: Популярность, зависящая от региона, имеет приоритет над глобальной (ЗЕМЛЯ) популярностью. |
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"
}
Связанные страницы
Ознакомьтесь со следующими страницами для тем, связанных с этими свойствами: