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

En esta sección, se proporcionan los detalles de las propiedades del lenguaje de marcado de contenido para el tipo de entidad MediaService, que captura la configuración de tu integración de acciones multimedia.

Tabla de especificaciones

Propiedad Tipo esperado Descripción
@type Text

Obligatorio: Siempre se establece en MediaService.

@context Text

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

@id URL

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

El identificador debe cumplir con los siguientes requisitos:

  • Es única en todo el mundo en 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 unificado de identificador de recursos (URI).
  • El dominio debe ser propiedad de tu organización.
name Text

Obligatorio: El nombre del proveedor.

Si tu marca tiene nombres específicos de una configuración regional, inclúyelos en un array. Para ver un ejemplo, consulta el ejemplo de MediaService.

brandIcon ImageObject

Obligatorio para todas las acciones de reproducción y reproducción: Es el archivo de imagen del ícono de marca, repetido para cada tamaño. En el resultado de la acción de reproducción o escucha, Google asocia los vínculos directos de tu contenido al ícono de tu 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 de naturaleza redonda.
  • Asegúrese de que las imágenes tengan suavizado y que no estén distorsionadas ni pixeladas

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

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

Requisito adicional para las integraciones de Google TV: Estas imágenes del ícono de tu marca se mostrarán en la parte superior de la guía de programación, en los botones de acción de reproducció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. (la resolución más alta disponible; no hay preferencia por la relación de aspecto)
  • Un ícono de marca denominativa de color en formato PNG. (la resolución más alta disponible; no hay preferencia por la relación de aspecto)

Asegúrese de que las imágenes tengan suavizado y que no estén distorsionadas ni pixeladas.

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: Ancho de la imagen en píxeles.

brandIcon.additionalProperty PropertyValue

Obligatorio: La propiedad adicional que se usa para describir el tipo de imagen y define sus usos previstos.

brandIcon.additionalProperty.@type Text

Obligatorio: Se establece en PropertyValue.

brandIcon.additionalProperty.name Text

Obligatorio: Se establece en contentAttributes.

brandIcon.additionalProperty.value Text

Obligatorio: La idoneidad del fondo.

Para que sea válido, configura al menos uno de los siguientes valores:

  • forDarkBackground: Es una imagen, por lo general, un ícono transparente, adecuada para usar sobre un fondo oscuro.
  • forLightBackground: Es una imagen, generalmente un ícono transparente, que es adecuada para usarla sobre un fondo claro.
application SotfwareApplication

Obligatorio si se proporcionan aplicaciones para iOS, Android, Cast o Android TV: La lista de aplicaciones de marca en los siguientes dispositivos:

  • iOS
  • Android
  • Transmisión
  • AndroidTV
application.@type Text

Obligatorio: Siempre se establece en SoftwareApplication.

application.operatingSystem Text

Obligatorio: Establece una de las siguientes opciones:

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

Obligatorio si corresponde: Para las plataformas Android, iOS y Android TV, debes especificarlo 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 reproducción de contenido multimedia a través de una app de Android TV, debes especificarlo como el vínculo al archivo APK de Android TV.

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

application.identifier

Text

Obligatorio si corresponde: Para las plataformas que corresponden a uno de los siguientes valores, configúralo según corresponda. De lo contrario, esta propiedad no es obligatoria:

  • iOS: Es el identificador de la aplicación de App Store. Por ejemplo, 967093455
  • Android: Es el nombre del paquete de Android para Play Store. Por ejemplo: com.abc.media.android.
  • Transmitir: 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: El proveedor superior del servicio.

parentOrganization.@type Text

Obligatorio: Siempre se establece en Organization.

parentOrganization.name Text

Obligatorio: El nombre de la organización.

subscriptions Suscripción multimedia

Opcional: Es la lista de MediaSubscriptions disponibles que admite el proveedor de reloj.

baseSubscriptionTier Suscripción multimedia

Obligatorio si corresponde: Si un proveedor de reloj y el proveedor tienen un paquete de suscripción base, debes establecerlo en la instancia de suscripción para el contenido disponible para todos los suscriptores. De lo contrario, esta propiedad no es obligatoria.

userRequestsFulfilledBy Text

Opcional: configura cualquiera de las siguientes partes que cumple con las solicitudes de los usuarios:

  • Google: Google entrega todas las solicitudes. Básicamente, Google muestra el vínculo directo del contenido solicitado.
  • Provider: El proveedor de contenido (el proveedor de Cloud) se encarga de todas las solicitudes. En esencia, el proveedor muestra el vínculo directo al contenido solicitado o inicia la reproducción directamente en sus dispositivos.

De forma predeterminada, esta propiedad se establece en Google.

mediaOffered Text

Obligatorio: Se establece como una de las siguientes opciones, que corresponde 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"
      }
    }
  ]
}