Свойства разметки контента MediaService (обязательно)

В этом разделе представлены подробные сведения о свойствах разметки контента для типа сущности MediaService , который фиксирует конфигурацию для вашей интеграции Media Action.

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

Свойство Ожидаемый тип Описание
@type Текст

Обязательно — всегда установлено значение MediaService .

@context Текст

Обязательно — всегда установлено значение ["http://schema.org", {"@language": "xx"}] .

@id URL-адрес

Обязательно — уникальный идентификатор вашего бренда; например, https://example.com .

Идентификатор должен соответствовать следующим требованиям:

  • Он уникален во всем вашем каталоге.
  • Это статично. Идентификатор должен быть стабильным и не меняться со временем.
  • Он имеет формат унифицированного идентификатора ресурса (URI).
  • Его домен должен принадлежать вашей организации.
name Текст

Обязательно – Имя провайдера.

Если у вашего бренда есть названия, специфичные для локали, перечислите их в массиве. Пример этого см. в примере MediaService .

brandIcon Объект изображения

Требуется для всех действий «Просмотр» и «Прослушивание» . Файл изображения значка вашего бренда, повторяющийся для каждого размера. В результате действия «Просмотр/прослушивание» Google связывает глубокие ссылки вашего контента со значком вашего бренда.

Файл изображения значка вашего бренда должен соответствовать следующим требованиям:

  • Это файл PNG.
  • Его фон прозрачный.
  • Его форма по своей природе круглая.
  • Убедитесь, что изображения сглажены и не искажены/пикселизированы.

Это свойство необходимо повторить, поскольку необходимо предоставить пять изображений, по одному для каждого из следующих размеров:

  • 16х16 пикселей, размер файла не более 1 КБ.
  • 20х20 пикселей, размер файла не более 1 КБ.
  • 40х40 пикселей, размер файла не более 1 КБ.
  • 44х44 пикселей, размер файла не более 1 КБ.
  • 112х112 пикселей, размер файла не более 3 КБ.

Дополнительное требование для интеграции с GoogleTV . Эти изображения значка вашего бренда будут отображаться в верхней части Руководства по программированию, на кнопках действий просмотра и в настройках Google TV. Предоставьте три значка, отвечающих следующим требованиям:

  • Один квадратный значок в формате PNG. (с разрешением 512х512 пикселей, соотношение сторон 1:1)
  • Один белый значок с надписью в формате PNG. (самое высокое доступное разрешение, без предпочтения соотношения сторон)
  • Один цветной значок надписи в формате PNG. (самое высокое доступное разрешение, без предпочтения соотношения сторон)

Убедитесь, что изображения сглажены и не искажены/пикселизированы.

brandIcon.contentURL URL-адрес

Обязательно — URL-адрес изображения.

brandIcon.height Число

Обязательно — высота изображения в пикселях.

brandIcon.width Число

Обязательно — ширина изображения в пикселях.

brandIcon.additionalProperty СвойствоЗначение

Обязательное — дополнительное свойство, используемое для описания типа изображения и определяет его предполагаемое использование.

brandIcon.additionalProperty.@type Текст

Обязательно — установите PropertyValue .

brandIcon.additionalProperty.name Текст

Обязательно — установите contentAttributes .

brandIcon.additionalProperty.value Текст

Обязательно – пригодность фона.

Чтобы быть действительным, установите хотя бы одно из следующих значений:

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

Требуется, если предоставляются приложения для iOS, Android, Cast или AndroidTV. Список приложений вашего бренда, включающий следующее:

  • iOS
  • Андроид
  • Бросать
  • AndroidTV
application.@type Текст

Обязательно — всегда установлено значение SoftwareApplication .

application.operatingSystem Текст

Обязательно — установите одно из следующих значений:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL-адрес

Обязательно, если применимо . Для платформ Android, AndroidTV и iOS необходимо указать это в качестве ссылки на ваше приложение в App Store и Play Store.

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

application.installUrl URL-адрес

Обязательно, если применимо . Если провайдер предлагает воспроизведение мультимедиа через приложение AndroidTV, вы должны указать это в качестве ссылки на APK-файл AndroidTV.

Если поставщик не поддерживает воспроизведение AndroidTV, это свойство не является обязательным.

application.identifier

Текст

Обязательно, если применимо . Для платформ, соответствующих одному из следующих значений, установите его соответствующим образом. В противном случае это свойство не требуется:

  • iOS: идентификатор приложения App Store. Например, 967093455 .
  • Android: название пакета Android в Play Store. Например, com.abc.media.android .
  • Cast: идентификатор приложения Cast. Например, ACDA4FDE .
  • AndroidTV: название пакета AndroidTV в Play Store. Например, com.abc.media.atv.android .
parentOrganization Организация

Обязательно — родительский поставщик услуги.

parentOrganization.@type Текст

Обязательно — всегда установлено значение Organization .

parentOrganization.name Текст

Обязательно — название организации.

subscriptions Медиаподписка

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

baseSubscriptionTier Медиаподписка

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

userRequestsFulfilledBy Текст

Необязательно — установите одну из следующих сторон, которая выполняет запросы пользователей:

  • Google : Все запросы выполняются Google. По сути, Google возвращает глубокую ссылку на запрошенный контент.
  • Provider : все запросы выполняются поставщиком контента – облачным поставщиком. По сути, провайдер возвращает глубокую ссылку на запрошенный контент или инициирует воспроизведение непосредственно на своих устройствах.

По умолчанию для этого свойства установлено значение Google .

mediaOffered Текст

Обязательно — установите один из следующих параметров, которые соответствуют типам контента вашего каталога, включенного в фид:

Пример Медиасервиса 

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadUrl": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadUrl": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadUrl": "https://google.play.store/com.abc.media.atv.android",
          "installUrl": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}