В этом разделе представлена подробная информация о свойствах разметки содержимого для типа сущности 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 (Entertainment Identifier Registry), представляющий на самом общем/абстрактном уровне произведение кино или телевидения. Например, идентификатор titleEIDR для фильма «Охотники за привидениями» — «10.5240/7EC7-228A-510A-053E-CBB8-J». |
editEIDR | Текст | Настоятельно рекомендуется. Почему? — Идентификатор EIDR (Entertainment Identifier Registry), представляющий собой конкретную редакцию/издание фильма или телесериала. Например, в фильме «Охотники за привидениями», название которого в формате 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 | WatchAction | Обязательный (при необходимости ) объект разметки действия , содержащий подробную информацию о действии.
|
sameAs | URL | Настоятельно рекомендуется. Почему? URL-адрес веб-страницы, которая может идентифицировать фильм; например, страница фильма в Википедии. Он должен отличаться от свойства url . |
inLanguage | Текст | Настоятельно рекомендуется. Оригинальная версия фильма на языке оригинала в формате BCP 47 . |
genre | Текст | Упорядоченный список всех соответствующих жанров. Например: ["Экшн", "Мода", "Окружающая среда", "Футбол"] |
keywords | Текст | Ключевые слова или теги, используемые для описания данного контента. Также допускается использование массива ключевых слов. Например, ["feature, biography"] может представлять собой массив ключевых слов для описания контента. |
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 | Спецификация показателя популярности | Настоятельно рекомендуется. Почему? Это показатель, который 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"
}
Похожие страницы
Для получения информации по соответствующим темам ознакомьтесь со следующими страницами: