Proprietà del markup dei contenuti di MediaService (obbligatorio)

Questa sezione fornisce i dettagli delle proprietà di markup dei contenuti per il tipo di entità MediaService che acquisisce la configurazione per l'integrazione di Media Action.

Tabella delle specifiche

Proprietà Tipo previsto Descrizione
@type Testo

Obbligatorio: impostato sempre su MediaService.

@context Testo

Obbligatorio: impostato sempre su ["http://schema.org", {"@language": "xx"}].

@id URL

Obbligatorio: un identificatore univoco per il tuo brand, ad esempio https://example.com.

L'identificatore deve rispettare i seguenti requisiti:

  • Deve essere univoco a livello globale nel tuo catalogo.
  • È statico. L'ID deve essere stabile e non cambiare nel corso del tempo.
  • Deve essere nel formato URI (Uniform Resource Identifier).
  • Il dominio deve essere di proprietà della tua organizzazione.
name Testo

Obbligatorio: il nome del fornitore.

Se il tuo brand ha nomi specifici per le impostazioni internazionali, elencali in un array. Per un esempio, consulta l'esempio MediaService.

brandIcon ImageObject

Obbligatorio per tutte le azioni di visualizzazione e di ascolto: il file immagine dell'icona del brand ripetuto per ogni dimensione. Nel risultato Azione di visualizzazione/ascolto, Google associa i link diretti dei tuoi contenuti all'icona del tuo brand.

Il file immagine dell'icona del brand deve rispettare i seguenti requisiti:

  • Si tratta di un file PNG.
  • Lo sfondo è trasparente.
  • La sua forma è rotonda.
  • Assicurati che le immagini siano con anti-aliasing e non distorte/pixelate

Questa proprietà deve essere ripetuta perché devi fornire cinque immagini, una per ciascuna delle seguenti dimensioni:

  • 16 x 16 pixel, con un file non superiore a 1 KB
  • 20 x 20 pixel, con un file non superiore a 1 KB
  • 40 x 40 pixel, con un file non superiore a 1 KB
  • 44 x 44 pixel, con un file non superiore a 1 KB
  • 112 x 112 pixel, con un file non superiore a 3 KB

Requisito aggiuntivo per le integrazioni di Google TV: queste immagini dell'icona del tuo brand verranno visualizzate nella parte superiore della Guida alla programmazione, sui pulsanti Azione di visualizzazione e nelle impostazioni di Google TV. Fornisci tre icone che soddisfino i seguenti requisiti:

  • Un'icona quadrata in formato file PNG. (con una risoluzione di 512 x 512 px e proporzioni 1:1)
  • Un'icona del logo in bianco in formato file PNG. (la risoluzione più alta disponibile, nessuna preferenza per le proporzioni)
  • Un'icona del logo a colori in formato file PNG. (la risoluzione più alta disponibile, nessuna preferenza per le proporzioni)

Assicurati che le immagini siano con anti-aliasing e non distorte/pixelate.

brandIcon.contentURL URL

Obbligatorio: l'URL dell'immagine.

brandIcon.height Number

Obbligatorio: l'altezza dell'immagine, in pixel.

brandIcon.width Number

Obbligatorio: la larghezza dell'immagine, in pixel.

brandIcon.additionalProperty PropertyValue

Obbligatorio: la proprietà aggiuntiva utilizzata per descrivere il tipo di immagine e definirne gli scopi previsti.

brandIcon.additionalProperty.@type Testo

Obbligatorio: impostato su PropertyValue.

brandIcon.additionalProperty.name Testo

Obbligatorio: impostato su contentAttributes.

brandIcon.additionalProperty.value Testo

Obbligatorio: l'idoneità dello sfondo.

Per essere valido, imposta almeno uno dei seguenti valori:

  • forDarkBackground: un'immagine, in genere un'icona trasparente, adatta per l'uso su uno sfondo scuro.
  • forLightBackground: un'immagine, in genere un'icona trasparente, adatta per l'uso su uno sfondo chiaro.
application SotfwareApplication

Obbligatorio se vengono fornite applicazioni per iOS, Android, Cast o Android TV: l'elenco delle applicazioni del tuo brand nei seguenti dispositivi:

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

Obbligatorio: impostato sempre su SoftwareApplication.

application.operatingSystem Testo

Obbligatorio: imposta uno dei seguenti valori:

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

Obbligatorio se applicabile: per le piattaforme Android, Android TV e iOS, devi specificare questo valore come link alla tua applicazione nell'App Store e nel Play Store.

Per tutte le altre piattaforme, questa non è una proprietà obbligatoria.

application.installUrl URL

Obbligatorio se applicabile: se il fornitore offre la riproduzione di contenuti multimediali tramite un'app Android TV, devi specificarlo come link al file APK di Android TV.

Se il fornitore non offre la riproduzione su Android TV, questa non è una proprietà obbligatoria.

application.identifier

Testo

Obbligatorio se applicabile: per le piattaforme che corrispondono a uno dei seguenti valori, impostalo di conseguenza. In caso contrario, questa proprietà non è obbligatoria:

  • iOS: l'identificatore dell'app dell'App Store. Ad esempio, 967093455.
  • Android: il nome del pacchetto Android del Play Store. Ad esempio, com.abc.media.android.
  • Trasmissione:l'ID dell'app Trasmissione. Ad esempio, ACDA4FDE.
  • AndroidTV: il nome del pacchetto AndroidTV del Play Store. Ad esempio, com.abc.media.atv.android.
parentOrganization Organizzazione

Obbligatorio: il fornitore principale del servizio.

parentOrganization.@type Testo

Obbligatorio: impostato sempre su Organization.

parentOrganization.name Testo

Obbligatorio: il nome dell'organizzazione.

subscriptions MediaSubscription

Facoltativo: l'elenco dei MediaSubscriptions supportati dal fornitore dello smartwatch.

baseSubscriptionTier MediaSubscription

Obbligatorio se applicabile: se un fornitore di orologi ha un pacchetto di abbonamento di base, devi impostarlo sull'istanza di abbonamento per i contenuti disponibili per tutti gli abbonati. In caso contrario, questa proprietà non è obbligatoria.

userRequestsFulfilledBy Testo

Facoltativo: imposta una delle seguenti parti che soddisfano le richieste degli utenti:

  • Google: tutte le richieste vengono soddisfatte da Google. In sostanza, Google restituisce il link diretto per i contenuti richiesti.
  • Provider: tutte le richieste vengono soddisfatte dal fornitore di contenuti, ovvero dal cloud provider. In sostanza, il fornitore restituisce il link diretto per i contenuti richiesti o avvia la riproduzione direttamente sui suoi dispositivi.

Per impostazione predefinita, questa proprietà è impostata su Google.

mediaOffered Testo

Obbligatorio: imposta uno dei seguenti valori, che corrispondono ai tipi di contenuti nel tuo catalogo inclusi nel feed:

  • ["VoD"]: il fornitore include nel feed solo contenuti video on demand (VoD). I contenuti VoD includono film e programmi TV.
  • ["LiveTV"]: il fornitore include nel feed solo la TV in diretta, che include contenuti di Canali e BroadcastEvent.
  • ["VoD", "LiveTV"]: il fornitore include nel feed sia i contenuti VoD sia i contenuti TV in diretta.
  • ["Music"]: il fornitore include nel feed solo le entità musicali. Sono inclusi contenuti di album, artisti, brani e playlist.
  • ["Radio"]: il fornitore include nel feed solo le entità Radio.
  • ["Music", "Radio"]: il fornitore include nel feed entità musicali e radiofoniche. Sono inclusi contenuti di album, artisti, brani, playlist e stazioni radio.

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