Propiedades de lenguaje de marcado del contenido de MediaService (obligatorio)

En esta sección, se brindan detalles sobre las propiedades de lenguaje de marcado del contenido de la Tipo de entidad MediaService que captura la configuración de tu acción multimedia integración

Tabla de especificación

Propiedad Tipo esperado Descripción
@type Texto

Obligatorio: Siempre se establece en MediaService.

@context Texto

Obligatorio: Siempre se establece en ["http://schema.org", {"@language": "xx"}].

@id URL

Obligatorio: Un identificador único para tu marca. por ejemplo, https://example.com

El identificador debe cumplir con los siguientes requisitos:

  • Es único a nivel global en todo tu catálogo.
  • Es estático. El ID debe ser fijo y mantener el mismo formato con el paso del tiempo.
  • Está en el formato del identificador unificado de recursos (URI).
  • El dominio debe ser propiedad de tu organización.
name Texto

Obligatorio: Es el nombre del proveedor.

Si tu marca tiene nombres específicos de la configuración regional, enuméralos en un array. Por ejemplo, consulta el ejemplo de MediaService.

brandIcon ImageObject

Obligatorio para todas las acciones de reproducción y de escucha: Es el archivo de imagen de tu marca. repetido para cada tamaño. En el resultado de las acciones de Mirar/Escuchar, Google asocia tu vínculos directos del contenido a tu ícono de marca.

El archivo de imagen del ícono de marca debe cumplir con los siguientes requisitos:

  • Es un archivo PNG.
  • Su fondo es transparente.
  • Su forma es redonda.
  • Asegúrate de que las imágenes tengan suavizado de contorno y que no estén distorsionadas ni pixeladas

Esta propiedad se debe repetir, ya que debes proporcionar cinco imágenes, una para cada una las siguientes dimensiones:

  • Debe ser de 16 x 16 píxeles, con un archivo de no más de 1 KB
  • Debe ser de 20 x 20 píxeles, con un archivo máximo de 1 KB.
  • Debe ser de 40 x 40 píxeles, con un archivo máximo de 1 KB.
  • Debe ser de 44 x 44 píxeles, con un archivo de no más de 1 KB.
  • Debe ser de 112 x 112 píxeles, con un archivo de no más de 3 KB

Requisito adicional para integraciones de Google TV: estas imágenes de tu marca aparecerá en la parte superior de la Guía de programación, en los botones de acciones de visualización y en la configuración de Google TV. Proporciona tres íconos que cumplan con los siguientes requisitos:

  • Un ícono cuadrado en formato de archivo PNG. (con una resolución de 512 x 512 px y una relación de aspecto de 1:1)
  • Un ícono de marca denominativa blanca en formato de archivo PNG. (resolución más alta disponible, sin preferencia para la relación de aspecto)
  • Ícono de marca denominativa de un color en formato de archivo PNG. (resolución más alta disponible, sin preferencia para la relación de aspecto)

Asegúrate de que las imágenes tengan suavizado de contorno y que no se distorsionen ni se pixelen.

brandIcon.contentURL URL

Obligatorio: Es la URL de la imagen.

brandIcon.height Número

Obligatorio: La altura de la imagen en píxeles.

brandIcon.width Número

Obligatorio: El ancho de la imagen en píxeles.

brandIcon.additionalProperty PropertyValue

Obligatorio: Es la propiedad adicional que se usa para describir el tipo de imagen y definir su para los usos previstos.

brandIcon.additionalProperty.@type Texto

Obligatorio: Configúralo como PropertyValue.

brandIcon.additionalProperty.name Texto

Obligatorio: Configúralo como contentAttributes.

brandIcon.additionalProperty.value Texto

Obligatorio: La idoneidad para el fondo

Para que sea válida, establécela en al menos uno de los siguientes valores:

  • forDarkBackground: Es una imagen, generalmente un ícono transparente, que es adecuado para usar sobre un fondo oscuro.
  • forLightBackground: Es una imagen, generalmente un ícono transparente, que es adecuado para usarlo sobre un fondo claro.
application SotfwareApplication

Obligatorio si se proporcionan aplicaciones para iOS, Android, Cast o AndroidTV: Es la lista de tus aplicaciones de marca según los siguientes elementos:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.@type Texto

Obligatorio: Siempre se establece en SoftwareApplication.

application.operatingSystem Texto

Obligatorio: Establece una de las siguientes opciones:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL

Obligatorio si corresponde: Para las plataformas Android, iOS y Android, debes especifica esto como el vínculo a tu aplicación en App Store y Play Store.

Para todas las demás plataformas, esta no es una propiedad obligatoria.

application.installUrl URL

Obligatorio si corresponde: Si el proveedor ofrece la reproducción de contenido multimedia a través de una app para Android TV, debes especificarlo como el vínculo al archivo APK de Android TV.

Si el proveedor no ofrece la reproducción de Android TV, esta no es una propiedad obligatoria.

application.identifier

Texto

Obligatorio si corresponde: Para plataformas que correspondan a una de las siguientes opciones valores, configúralos según corresponda. De lo contrario, no se requiere esta propiedad:

  • iOS: Es el identificador de la app de App Store. Por ejemplo, 967093455
  • Android: Es el nombre del paquete de Android de Play Store. Por ejemplo: com.abc.media.android.
  • Cast: El ID de la app de Cast. Por ejemplo, ACDA4FDE
  • AndroidTV: Es el nombre del paquete de Android TV de Play Store. Por ejemplo: com.abc.media.atv.android.
parentOrganization Organization

Obligatorio: Es el proveedor superior del servicio.

parentOrganization.@type Texto

Obligatorio: Siempre se establece en Organization.

parentOrganization.name Texto

Obligatorio: Es el nombre de la organización.

subscriptions MediaSubscription

Opcional: La lista de MediaSubscriptions disponibles compatibles con el proveedor del reloj.

baseSubscriptionTier MediaSubscription

Obligatorio si corresponde: Si un proveedor de relojes y proveedor tiene una base suscripción, debes establecerlo en la instancia de suscripción para el contenido disponible para todos los suscriptores. De lo contrario, no se requiere esta propiedad.

userRequestsFulfilledBy Texto

Opcional: Se establece en cualquiera de las siguientes partes que cumplen con los requisitos del usuario. solicitudes:

  • Google: Google completa todas las solicitudes. Básicamente, Google devuelve el vínculo directo al contenido solicitado.
  • Provider: El proveedor de contenido, el de servicios en la nube. En esencia, el proveedor devuelve el vínculo directo para el contenido solicitado. o inician la reproducción directamente en sus dispositivos.

De forma predeterminada, esta propiedad se establece en Google.

mediaOffered Texto

Obligatorio: Establece una de las siguientes opciones que correspondan a los tipos de contenido de tu catálogo que se incluyen en el feed:

Ejemplo de MediaService

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