Proprietà del markup dei contenuti di MediaService (obbligatorio)

Questa sezione fornisce i dettagli delle proprietà del markup dei contenuti per il tipo di entità MediaService, che acquisisce la configurazione per l'integrazione della tua azione multimediale

Tabella delle specifiche

Proprietà Tipo previsto Descrizione
@type Testo

Obbligatorio: sempre impostato su MediaService.
@context Testo

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

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

L'identificatore deve rispettare i seguenti requisiti:

  • È globalmente unico nel tuo catalogo.
  • È statico. L'ID deve essere stabile e non cambiare nel corso del tempo.
  • È nel formato URI (Unified 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 le azioni di ascolto: il file immagine dell'icona del brand, ripetuto per ogni dimensione. Nel risultato dell'azione Guarda/ascolta, 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:

  • È un file PNG.
  • Lo sfondo è trasparente.
  • La sua forma è rotonda.
  • Assicurati che le immagini non presentino alias e che non siano distorte o pixelate

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

  • 16 x 16 pixel, con un file di dimensioni non superiori a 1 kB
  • 20 x 20 pixel, con un file di dimensioni non superiori a 1 kB
  • 40 x 40 pixel, con un file di dimensioni non superiori a 1 kB
  • 44 x 44 pixel, con un file di dimensioni non superiori a 1 kB
  • 112 x 112 pixel, con un file di dimensioni non superiori a 3 kB

Requisito aggiuntivo per le integrazioni di Google TV: queste immagini dell'icona del brand verranno mostrate nella parte superiore della Guida alla programmazione, nei pulsanti di azione Guarda e nelle impostazioni di Google TV. Fornisci tre icone che soddisfano i seguenti requisiti:

  • Un'icona quadrata in formato file PNG. (con una risoluzione di 512x512 px, proporzioni 1:1)
  • Icona con marchio denominativo bianco in formato file PNG. (massima risoluzione disponibile, nessuna preferenza per le proporzioni)
  • Icona con marchio denominativo colorato in formato PNG. (massima risoluzione disponibile, nessuna preferenza per le proporzioni)

Assicurati che le immagini siano senza alias e che non siano distorte o 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 utilizzi previsti.
brandIcon.additionalProperty.@type Testo

Obbligatorio: imposta PropertyValue.
brandIcon.additionalProperty.name Testo

Obbligatorio: imposta contentAttributes.
brandIcon.additionalProperty.value Testo

Obbligatorio: l'idoneità per lo sfondo.

Per essere valido, imposta almeno uno dei seguenti valori:

  • forDarkBackground: un'immagine, in genere un'icona trasparente, adatta per essere utilizzata su uno sfondo scuro.
  • forLightBackground:un'immagine, in genere un'icona trasparente, adatta per essere utilizzata su uno sfondo chiaro.
application Applicazione Sotfware

Obbligatorio se vengono fornite le applicazioni per iOS, Android, Google Cast o AndroidTV. L'elenco delle tue applicazioni del brand nei seguenti campi:

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

Obbligatorio: sempre impostato 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, AndroidTV e iOS, devi specificare questo link alla tua applicazione nell'App Store e nel Play Store.

Per tutte le altre piattaforme, non si tratta di una proprietà obbligatoria.
application.installUrl URL

Obbligatorio se applicabile: se il fornitore offre la riproduzione di contenuti multimediali tramite un'app AndroidTV, devi specificare questo URL come link al file APK di AndroidTV.

Se il fornitore non offre la riproduzione su AndroidTV, non si tratta di una proprietà obbligatoria.
application.identifier

Testo

Obbligatorio se applicabile: per le piattaforme che corrispondono a uno dei seguenti valori, impostalo di conseguenza. Questa proprietà non è altrimenti 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.
  • Trasmetti:l'ID app di 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: sempre impostato su Organization.
parentOrganization.name Testo

Obbligatorio: il nome dell'organizzazione.
subscriptions Abbonamento multimediale

Facoltativo: l'elenco di MediaSubscriptions disponibili supportati dal provider dell'orologio.
baseSubscriptionTier Abbonamento multimediale

Obbligatorio se applicabile: se un fornitore di orologi e il provider hanno un pacchetto di abbonamento di base, devi impostare l'istanza dell'abbonamento per i contenuti disponibili per tutti gli abbonati. Questa proprietà non è altrimenti obbligatoria.
userRequestsFulfilledBy Testo

Facoltativo: imposta una delle seguenti parti che soddisfa 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 sono soddisfatte dal provider di contenuti: il cloud provider. In sostanza, il provider restituisce il link diretto per i contenuti richiesti o avvia la riproduzione direttamente sui propri dispositivi.

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

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

  • ["VoD"]: il provider include solo contenuti video on demand (VoD) nel feed. I contenuti VoD includono Film e Programmi TV.
  • ["LiveTV"]: il provider include solo la TV in diretta, che include i contenuti dei canali e BroadcastEvent nel feed.
  • ["VoD", "LiveTV"]: il fornitore include sia i contenuti VoD sia i contenuti TV in diretta nel feed.
  • ["Music"]: il fornitore include solo entità musicali nel feed. Ciò include i contenuti Album, Artisti, Brani e Playlist.
  • ["Radio"]: il fornitore include solo entità Radio nel feed.
  • ["Music", "Radio"]: il fornitore include entità musicali e radio nel feed. Ciò include contenuti relativi a album, artisti, canzoni, 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"
      }
    }
  ]
}