Se usó la API de Cloud Translation para traducir esta página.

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

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

Punto clave: La entidad MediaService debe estar encerrada dentro del array dataFeedElement. Consulta el ejemplo a continuación.

Punto clave: Cada envío de feed de Acciones multimedia debe incluir una sola entidad MediaService para cada proveedor de vínculos directos que se incluya en el feed.

Tabla de especificaciones

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: Es 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 formato de identificador de recursos unificado (URI). Tu organización debe ser propietaria del dominio.
`name`	Texto	Obligatorio: Es el nombre del proveedor. Si tu marca tiene nombres específicos de configuración regional, indícalos en un array. Para ver un ejemplo de esto, 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 ícono de marca, repetido para cada tamaño. En el resultado de la acción de mirar o escuchar, Google asocia los vínculos directos de tu contenido con el ícono de tu marca. El archivo de imagen del ícono de tu 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 bordes y 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 × 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 × 44 píxeles, con un archivo de no más de 1 KB 112 × 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 de palabras en blanco en formato de archivo PNG. (la resolución más alta disponible, sin preferencia por la relación de aspecto) Un ícono de marca de palabras de color en formato de archivo PNG. (la resolución más alta disponible, sin preferencia por la relación de aspecto) Asegúrate de que las imágenes tengan suavizado de bordes y no estén distorsionadas ni pixeladas.
`brandIcon.contentURL`	URL	Obligatorio: Es la URL de la imagen.
`brandIcon.height`	Número	Obligatorio: Es la altura de la imagen, en píxeles.
`brandIcon.width`	Número	Obligatorio: Es 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 sus usos previstos.
`brandIcon.additionalProperty.@type`	Texto	Obligatorio: Se establece en `PropertyValue`.
`brandIcon.additionalProperty.name`	Texto	Obligatorio: Se establece en `contentAttributes`.
`brandIcon.additionalProperty.value`	Texto	Obligatorio: Es la idoneidad del fondo. Para que sea válido, establece al menos uno de los siguientes valores: `forDarkBackground`: Es una imagen, por lo general, un ícono transparente, que es adecuada para usar en un fondo oscuro. `forLightBackground`: Es una imagen, por lo general, un ícono transparente, que es adecuada para usar sobre un fondo claro.
`application`	SotfwareApplication	Obligatorio si se proporcionan aplicaciones para iOS, Android, Cast o Android TV: Es la lista de las aplicaciones de tu marca en los siguientes campos: 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: En las plataformas Android, Android TV y iOS, debes especificar esta URL 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 para Android TV, debes especificarlo como el vínculo al archivo APK de Android TV. Si el proveedor no ofrece reproducción en Android TV, esta no es una propiedad obligatoria.
`application.identifier`	Texto	Obligatorio si corresponde: En el caso de 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 app de la App Store. Por ejemplo, `967093455` Android: Es el nombre del paquete de Android de Play Store. Por ejemplo: `com.abc.media.android`. Cast: Es el ID de la app de Cast. Por ejemplo, `ACDA4FDE` AndroidTV: Es el nombre del paquete de AndroidTV 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: Es la lista de `MediaSubscriptions` disponibles que admite el proveedor del reloj.
`baseSubscriptionTier`	MediaSubscription	Obligatorio si corresponde: Si un proveedor de relojes tiene un paquete de suscripción básico, debes configurarlo en la instancia de suscripción para que el contenido esté disponible para todos los suscriptores. De lo contrario, esta propiedad no es obligatoria.
`userRequestsFulfilledBy`	Texto	Opcional: Establece una de las siguientes partes que completa las solicitudes del usuario: `Google`: Google realiza todas las solicitudes. Básicamente, Google muestra el vínculo directo del contenido solicitado. `Provider`: El proveedor de contenido (el proveedor de servicios en la nube) entrega todas las solicitudes. En esencia, el proveedor muestra el vínculo directo del contenido solicitado o inicia 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 corresponden a los tipos de contenido de tu catálogo que se incluyen en el feed: `["VoD"]`: El proveedor solo incluye contenido de video on demand (VoD) en el feed. El contenido de VOD incluye películas y programas de TV. `["LiveTV"]`: El proveedor solo incluye TV en vivo, que incluye contenido de Channels y BroadcastEvent en el feed. `["VoD", "LiveTV"]`: El proveedor incluye contenido de VOD y de TV en vivo en el feed. `["Music"]`: El proveedor solo incluye entidades musicales en el feed. Esto incluye el contenido de Álbumes, Artistas, Canciones y Playlists. `["Radio"]`: El proveedor solo incluye entidades de Radio en el feed. `["Music", "Radio"]`: El proveedor incluye entidades de música y radio en el feed. Esto incluye el contenido de Álbumes, Artistas, Canciones, Playlist y Estaciones de radio. Nota: Las herramientas de validación usan esto para aplicar las validaciones adecuadas.

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