Свойства разметки контента фильмов

В этом разделе представлены подробные сведения о свойствах разметки контента для типа сущности Movie .

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

Свойство Ожидаемый тип Описание
@context Текст Обязательно – всегда установлено значение ["http://schema.org", {"@language": "xx"}]
  • Где «xx» представляет язык строк в фиде. Для каждого контекста корневого объекта в параметре @language должен быть установлен соответствующий код языка в формате формата BCP 47 . Например, если в качестве языка установлен испанский, предполагается, что имена будут на испанском, даже если язык субтитров/дублирования — английский.
@type Текст Обязательно — всегда устанавливайте значение Movie для фильмов.
@id URL-адрес Обязательно — идентификатор контента в формате URI; например, https://example.com/1234abc .
@id должен соответствовать следующим требованиям:
  • Глобальная уникальность в вашем каталоге
  • Статический; Идентификатор должен быть стабильным и не меняться со временем (даже если изменяется свойство URL-адреса шоу). Она будет рассматриваться как непрозрачная строка и не обязательно должна быть рабочей ссылкой.
  • В виде единого идентификатора ресурса (URI).
  • Домен, используемый для значения @id, должен принадлежать вашей организации.
Поскольку url объекта соответствует всем требованиям в качестве идентификатора, мы рекомендуем использовать url объекта в качестве @id . Более подробную информацию смотрите в разделе «Идентификатор» .
url URL-адрес Обязательно – канонический URL-адрес контента, который Google использует для сопоставления контента вашего фида с контентом в базах данных Google.
url должен соответствовать следующим требованиям:
  • url должен быть глобально уникальным
  • url должен содержать работающий канонический URL-адрес, который может сканировать Google.
Глубокую ссылку воспроизведения можно найти в свойстве 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 , предоставляющий подробную информацию о действии.
  • Если контент доступен в формате «Видео по запросу» (VoD), это свойство является обязательным; Объект разметки действия должен обеспечивать глубокую ссылку на контент.
  • Если контент доступен на канале LiveTV, это свойство является необязательным; вместо этого связанный объект BroadcastService предоставляет глубокую ссылку на канал.
  • Movie может быть доступен как в формате VoD, так и в LiveTV.
Используйте массив, чтобы указать разные глубокие ссылки в нескольких регионах. См. пример нескольких регионов и языков .
sameAs URL-адрес Настоятельно рекомендуется Почему? URL-адрес справочной веб-страницы, по которой можно идентифицировать фильм; например, страница фильма в Википедии. Оно должно отличаться от свойства url .
inLanguage Текст Оригинальный язык фильма в формате BCP 47 .
genre Текст Упорядоченный список всех соответствующих жанров. Например: ["Действие", "Мода", "Окружающая среда", "Футбол"]
keywords Текст Ключевые слова или теги, используемые для описания этого контента. Также допускается использование массива ключевых слов. Например, ["характеристика, биография"] может представлять собой массив ключевых слов для описания контента.
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 символов.
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 Текст или рейтинг Требуется для контента для взрослых, в противном случае настоятельно рекомендуется . Почему? - Общий рейтинг контента. Если рейтинг контента указан в виде текстовой строки, принимаются два варианта:
  • Рейтинговое агентство поставило рейтинг перед рейтингом с пробелом между ними. Например, рейтинг «PG-13» агентства «MPAA» в США следует описывать как «MPAA PG-13». Посмотреть список агентств .
  • Значение «РЕЙТИНГ НЕ ИЗВЕСТЕН» (без учета регистра), указывающее, что вы не знаете рейтинг фильма.
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 на любое из следующих значений:
  • Home Release : версия, продаваемая или сдаваемая в аренду для домашнего просмотра.
  • Theatrical Release : версия, выпущенная в кинотеатрах.
  • International Release : версия, отредактированная для выпуска на международном уровне.
  • Remastered : версия, в которой изображения, звук или и то, и другое улучшены до более современного стандарта.
  • Unrated : версия, не проверенная MPAA или аналогичным агентством.
  • Director Cut : версия, представляющая собой одобренную режиссером редакцию.
  • Extended Cut : версия, которая длиннее театральной версии.
workExample Фильм Указывает варианты фильма. Включите это свойство в основную сущность Movie , а не в сущности Movie для вариантов версий.
workExample.@id URL-адрес Для вариантов Movie это свойство предоставляет @id сущности Movie , вариантом которого является данный фильм.
workExample.@type Текст Обязательно — всегда установлено значение Movie . Это можно представить как массив для Movie с несколькими вариантами.
workExample.@id URL-адрес Обязательно — @id варианта Movie .
workExample.name Текст Обязательно — название варианта Movie .
workExample.category Текст Обязательно — тип фильма конкретной версии. Установите категорию на любое из следующих значений:
  • Home Release : версия, продаваемая или сдаваемая в аренду для домашнего просмотра.
  • Theatrical Release : версия, выпущенная в кинотеатрах.
  • International Release : версия, отредактированная для выпуска на международном уровне.
  • Remastered : версия, в которой изображения, звук или и то, и другое улучшены до более современного стандарта.
  • Unrated : версия, не проверенная MPAA или аналогичным агентством.
  • Director Cut : версия, представляющая собой одобренную режиссером редакцию.
  • Extended Cut : версия, которая длиннее театральной версии.

Пример

Основной фильм

Фильм с расширенной версией.

{
  "@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"
}

На следующих страницах вы найдете темы, связанные с этими свойствами: