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

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

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

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

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

@context Текст

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

@id URL-адрес

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

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

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

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

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

brandIcon ImageObject

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

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

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

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

  • 16x16 пикселей, размер файла не более 1 КБ
  • 20x20 пикселей, размер файла не более 1 КБ
  • 40x40 пикселей, размер файла не более 1 КБ
  • 44x44 пикселя, размер файла не более 1 КБ
  • 112x112 пикселей, размер файла не более 3 КБ

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

  • Один квадратный значок в формате файла PNG. (с разрешением 512x512 пикселей, соотношение сторон 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 Маркете. Например, com.abc.media.android .
  • Cast: идентификатор приложения Cast. Например, ACDA4FDE .
  • AndroidTV: название пакета AndroidTV в Play Маркете. Например, 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"
      }
    }
  ]
}