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

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

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

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

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

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

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

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

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

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

expires Дата

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

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

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

audience Аудитория Рекомендуемые — предполагаемая или предпочтительная аудитория для этого изображения.
audience.geographicArea Административная область Рекомендуемые — предполагаемые или предпочтительные регионы для этого изображения. В отличие от этого, используйте regionsAllowed для указания жестких ограничений. Если audience.geographicArea не указан, предполагается, что он предназначен для повсеместного использования. Укажите страны в формате ISO 3166 .
copyrightHolder Организация или лицо Рекомендовано . Сторона, владеющая авторскими правами на изображение.
keywords Текст Рекомендуемые — ключевые слова или теги, используемые для описания этого изображения. Несколько keywords могут быть предоставлены с использованием массива. Например, ["особенность, биография"]
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 : фон изображения прозрачен. Обычно это используется для изображений, которые представляют собой просто заголовок или логотип и ничего больше.

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

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

  • centered : Преобладающая фигура расположена в центре изображения.
  • rightCentered : преобладающая фигура расположена справа от изображения, что оставляет левую сторону относительно пустой для текста и наложений пользовательского интерфейса.
  • leftCentered : преобладающая фигура расположена в левой части изображения, что оставляет правую сторону относительно пустой для текста и наложений пользовательского интерфейса.

Чтобы быть действительным, включите не более одной из этих позиций.

Примеры изображений с их предполагаемым использованием

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

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

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, мы просим поставщиков предоставлять все типы изображений из следующей таблицы.

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

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 ) 600x600
4:3, логотип канала ( logo ) 800x600
1:1, логотип канала ( logo ) 600x600
16:9, логотип канала ( logo ) 3840x2160

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

 1800x1000

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

  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"]
      }
    ]
  }
}

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

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