Свойства изображения

В этом разделе подробно описаны свойства разметки контента image для фильмов и сериалов. Эта разметка позволяет поставщикам описывать тип изображения, например, является ли оно титульным, фоновым или знаковым, и предлагаемое его использование.

Таблица спецификаций

Свойство image можно указать для объектов следующих типов: Movie, TVSeries, TVSeason и TVEpisode. В таблице ниже описаны доступные свойства для свойства image. Обратите внимание, что свойство additionalProperty включает в себя название дополнительного параметра contentAttributes, которое содержит массив значений, описывающих тип изображения и его предполагаемое использование.

Свойство Ожидаемый тип Описание
@context Текст Обязательный параметр. Всегда имеет значение "http://schema.org".
@type Текст Обязательный параметр. Всегда имеет значение ImageObject.
contentUrl URL Обязательное свойство. URL изображения.
additionalProperty PropertyValue Обязательное свойство. Определяет свойство contentAttributes, которое описывает тип изображения и его назначение. Подробную информацию можно найти в статье contentAttributes.
character Person

Обязательное свойство (если применимо). Вымышленный персонаж, связанный с изображением. Это свойство обязательно, если contentAttribute включает castInCharacter.

inLanguage Текст Обязательный (если применимо). Язык текста на изображении. Используйте один из языковых кодов по стандарту IETF BCP 47. Если изображение содержит contentAttribute типа hasTitle, это свойство является обязательным.
regionsAllowed Place Рекомендуется. Регионы, в которых разрешено изображение. Если регионы не указаны, будет считаться, что изображение разрешено везде. Страны необходимо указывать в формате ISO 3166.
datePublished Дата

Обязательное свойство, если применимо. Дата, после которой изображение становится доступным, в формате ISO 8601 (включая часовой пояс).

  • Дату можно установить в будущем.

Если на использование изображения наложены временные ограничения, это свойство является обязательным, если изображение не должно показываться до указанной даты. Если такого ограничения нет, его можно опустить. Изображение должно быть добавлено в фид не позднее чем за семь дней до даты публикации. Это повысит вероятность того, что контент будет вовремя показан на платформах Google.

expires Дата

Обязательное свойство, если применимо. Дата, после которой изображение станет недоступно, в формате ISO 8601 (включая часовой пояс).

  • Если контент доступен всегда, это свойство можно не указывать.

Обновлять дату окончания срока действия в фиде необходимо не позднее чем за семь дней до ее наступления. Это повысит вероятность того, что контент перестанет показываться в сервисах Google в указанную дату.

audience Аудитория Рекомендуется. Целевая или предпочтительная аудитория для этого изображения.
audience.geographicArea AdministrativeArea Рекомендуемые. Регионы, для которых предназначено изображение. В отличие от него, regionsAllowed задает строгие ограничения. Если свойство audience.geographicArea не указано, то считается, что видео предназначено для всех регионов. Страны необходимо указывать в формате ISO 3166.
copyrightHolder Organization или Person Рекомендуется. Сторона, которой принадлежат авторские права на изображение.
keywords Текст Рекомендуется. Ключевые слова или теги, описывающие изображение. Вы можете указать несколько значений keywords, используя массив. Пример: ["feature, biography"].
name Текст Рекомендуемые – название изображения.

contentAttributes

Свойство contentAttributes объекта image описывает тип изображения и определяет рекомендуемые способы его использования. В списке ниже приведены категории, которые включают значения contentAttributes, которые поставщики должны указывать для каждого ImageObject.

Тип

  • iconic – изображение, которое иллюстрирует шоу. Часто это художественное изображение.
  • sceneStill: отрывок из шоу.
  • castInCharacter – фотография актера в образе персонажа. Если вы используете это значение, добавьте свойство character, чтобы указать конкретного персонажа на изображении. Если персонажей несколько, например в ансамбле, добавьте несколько свойств character в виде массива.
  • logo – на изображении есть только логотип. Это может быть графический логотип или логотип с названием. Чтобы указать, какой именно, добавьте соответствующий оверлей.

Чтобы разметка была действительной, используйте только один из этих типов.

  • poster: постер шоу. В пользовательских интерфейсах компьютеров их можно использовать в каруселях. На них может быть название шоу.
  • background – изображение, которое можно использовать в качестве фона для текста или элементов интерфейса. На этих изображениях нет текста.

Чтобы значение было действительным, укажите не более одного рекомендуемого использования.

Подходящий размер

  • smallFormat – изображение, подходящее для небольших экранов, например мобильных телефонов. Текст и логотипы на изображении легко читаются на маленьком экране.
  • largeFormat – изображение, которое подходит для больших экранов или печатных плакатов.

Для одного изображения можно использовать оба значения.

Соответствие требованиям бренда

  • forDarkBackground – изображение, обычно прозрачный логотип, которое подходит для использования на темном фоне.
  • forLightBackground – изображение, обычно прозрачный логотип, которое подходит для использования на светлом фоне.

Чтобы значение было действительным, используйте не более одного значения соответствия фона.

Наложения

  • hasTitle – название шоу или имя персонажа или актера, изображенного на картинке. Обязательно добавьте свойство inLanguage для изображения.
  • noTitle: на изображении нет названия.
  • hasLogo: на изображении есть логотип фильма или сериала, владельца контента или дистрибьютора.
  • noLogo: на изображении нет логотипа.
  • hasCopyright: на изображении есть видимое уведомление об авторских правах.
  • noCopyright: на изображении нет видимого уведомления об авторских правах. Как правило, Google не может использовать такие изображения без изменений.
  • hasMatte: у изображения есть маска. Это могут быть горизонтальные полосы (леттербокс), вертикальные полосы (пилларбокс) или и те, и другие (виндоубокс). Иногда изображения матируются, чтобы соответствовать соотношению сторон. Как правило, Google не может использовать такие изображения без изменений.
  • noMatte: На изображении нет паспарту.
  • transparentBackground: фон изображения прозрачный. Обычно это делается для изображений, которые представляют собой только заголовок или логотип.

Чтобы файл был действительным, в нем должно быть только по одному атрибуту title, logo, copyright и matte.

Положение преобладающей фигуры

  • centered – основной объект расположен в центре изображения.
  • rightCentered: основной персонаж расположен в правой части изображения, а левая часть относительно пуста, что позволяет разместить на ней текст и элементы интерфейса.
  • leftCentered: основной объект расположен в левой части изображения, а правая часть относительно пуста, что позволяет разместить на ней текст и элементы интерфейса.

Чтобы значение было допустимым, укажите не более одной позиции.

Примеры изображений и их назначение

Интерфейс телевизора с фоновым изображением, текстом и оверлеем.
Интерфейс телевизора, в котором на фоновом изображении показываются карусели с постерами.
Интерфейс мобильного приложения с постером и фоновым изображением.iconic
Интерфейс мобильного приложения с постером и фоновым изображением.sceneStill

Примеры изображений и их атрибуты contentAttributes

contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]
contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]
contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]
contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}
contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]
contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]
contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]
contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]

Рекомендуемые типы изображений для товаров в Google

Для разных сервисов и платформ Google требуются разные типы изображений и соотношения сторон. Чтобы контент правильно отображался во всех продуктах Google, поставщики должны предоставить все типы изображений, перечисленные в таблице ниже.

Соотношение сторон и атрибуты contentAttributes Минимальное разрешение (в пикселях) Фильм Сериал Сезон телесериала Серия Телевещание
16:9, iconic poster 3840x2160
2:3, iconic poster 1000x1500
4:3, iconic poster 800x600
1:1, iconic poster 600 × 600

3:4, iconic poster

600x800

16:9, iconic background [рекомендуется] или sceneStill

3840x2160

2:3, iconic background [рекомендуется] или sceneStill

1000x1500

3:4, iconic background [рекомендуется] или sceneStill

600x800
1:1, логотип шоу (hasLogo) 600 × 600
4:3, логотип канала (logo) 800x600
1:1, логотип канала (logo) 600 × 600
16:9, логотип канала (logo) 3840x2160

9:5, hasTitle logo (с transparentBackground, forLightBackground и forDarkBackground)

1800 x 1000

При отправке изображений соблюдайте следующие правила:

  1. Изображения должны быть в формате JPEG, PNG или WebP.
  2. Используйте изображения с самым высоким разрешением.
  3. Размер файла не должен превышать 20 МБ.
  4. Рекомендуется добавить centered. В некоторых продуктах также можно использовать фоновые изображения rightCentered и leftCentered, поэтому вы можете добавить их, если они у вас есть.
  5. Рекомендуем использовать изображения, которые подходят и для smallFormat, и для largeFormat.
  6. Вы можете использовать и другие размеры изображений, помимо указанных в таблице выше.
  7. Убедитесь, что соотношение сторон каждого изображения соответствует одному из распространенных значений, перечисленных в таблице выше. В противном случае вы получите предупреждение.

Примеры изображений со схемой

Ниже приведены примеры того, как форматировать схему для изображений, связанных с фильмами или сериалами.

Фоновое изображение фильма с двумя персонажами

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/my_favorite_movie",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A Movie poster",
    "Keywords": ["Mauren, Lord Wingflap the Destroyer"],
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" },
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"},
                           {"@type": "Country", "name": "CA"},
                           {"@type": "Country", "name": "AU"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Фоновое изображение сериала ограничено двумя регионами

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/mountain_view",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A TV Show",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "regionsAllowed": [{ "@type": "Country", "name": "US" },
                       { "@type": "Country", "name": "GB" }],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "background", "rightCentered", "smallFormat",
                  "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
      }
    ]
  }
}

Постер фильма для двух регионов

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": [{ "@type": "Country", "name": "US" },
                 { "@type": "Country", "name": "GB" }],
    "character": [
      {
        "@type": "Person",
        "name": "Captain Pulsar"
      }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
                  "hasLogo", "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Большой постер фильма на корейском и английском языках

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["kr", "en"],
    "audience": { "@type": "Country", "name": "KR" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" },
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Как добавить несколько изображений для одного региона

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["en"],
    "audience": { "@type": "Country", "name": "US" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}

Представление изображений с ограниченным временем

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "datePublished": "2022-10-31T17:00:00Z",
    "expires": "2025-10-31T16:59:59Z",
    "inLanguage": ["ja"],
    "audience": { "@type": "Country", "name": "JP" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "datePublished": "2021-10-31T17:00:00Z",
      "expires": "2023-10-31T16:59:59Z",
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}