Proprietà del markup dei contenuti di MediaService (obbligatorio)

Questa sezione fornisce i dettagli sulle proprietà di markup dei contenuti per Tipo di entità MediaService che acquisisce la configurazione della tua azione multimediale integrazione

Tabella delle specifiche

Proprietà Tipo previsto Descrizione
@type Testo

Obbligatorio - Imposta sempre su MediaService.
@context Testo

Obbligatorio - Imposta sempre 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:

  • È unica a livello globale 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 singole località, elencali in un array. Ad esempio, Fai riferimento all'esempio di MediaService.
brandIcon ImageObject

Obbligatorio per tutte le azioni di visualizzazione e di ascolto: il file immagine del tuo brand ripetuta per ogni dimensione. Nel risultato Azione di visualizzazione/ascolto, Google associa il tuo link diretti dei 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 siano con anti-alias e non siano distorte/pixelate

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

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

Requisiti aggiuntivi per le integrazioni di Google TV: queste immagini del tuo brand verrà visualizzata nella parte superiore della Guida alla programmazione, sui pulsanti Azione dell'orologio 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, proporzioni 1:1)
  • Icona con un marchio denominativo bianco in formato file PNG. (massima risoluzione disponibile, nessuna preferenza per le proporzioni)
  • Icona con un marchio denominativo colorato in formato file PNG. (massima risoluzione disponibile, nessuna preferenza per le proporzioni)

Assicurati che le immagini siano con anti-alias e non siano 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

Obbligatoria: la proprietà aggiuntiva utilizzata per descrivere il tipo di immagine e ne definisce il tipo per usi previsti.
brandIcon.additionalProperty.@type Testo

Obbligatorio: imposta su PropertyValue.
brandIcon.additionalProperty.name Testo

Obbligatorio: imposta su contentAttributes.
brandIcon.additionalProperty.value Testo

Obbligatoria: l'idoneità in background.

Per essere valido, imposta almeno uno dei seguenti valori:

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

Obbligatorio se vengono fornite applicazioni iOS, Android, Cast o AndroidTV. L'elenco delle applicazioni del tuo brand in quanto segue:

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

Obbligatorio - Imposta sempre su SoftwareApplication.
application.operatingSystem Testo

Obbligatorio: imposta una delle seguenti opzioni:

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

Obbligatorio se applicabile. Per le piattaforme Android, AndroidTV e iOS, devi: specificalo 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 una Per l'app AndroidTV, devi specificarla come link al file APK AndroidTV.

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

Testo

Obbligatorio se applicabile: per le piattaforme che corrispondono a una delle seguenti opzioni occorre impostarla di conseguenza. Questa proprietà non è obbligatoria in caso contrario:

  • 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 Google Cast. 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 - Imposta sempre su Organization.
parentOrganization.name Testo

Obbligatorio: il nome dell'organizzazione.
subscriptions MediaSubscription

Facoltativo - L'elenco di MediaSubscriptions disponibili supportate dal fornitore dello smartwatch.
baseSubscriptionTier MediaSubscription

Obbligatorio se applicabile: se un fornitore di orologi e il fornitore ha una base abbonamento, devi impostarlo sull'istanza di abbonamento per i contenuti disponibili a tutti gli abbonati. Questa proprietà non è obbligatoria in caso contrario.
userRequestsFulfilledBy Testo

Facoltativo: da impostare sul ruolo di una delle seguenti parti che soddisfa l'utente richieste:

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

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

Obbligatorio - Imposta uno dei valori seguenti, che corrisponde ai tipi di contenuti in il catalogo incluso nel feed:

  • ["VoD"] - Il fornitore include solo i contenuti Video on Demand (VoD) nella feed. I contenuti VOD includono Film e Programmi TV.
  • ["LiveTV"] - Il fornitore include solo la TV in diretta, che include Canali e BroadcastEvent presenti nel feed.
  • ["VoD", "LiveTV"] - Il fornitore include sia contenuti VOD e TV in diretta in il feed.
  • ["Music"]: il fornitore include solo entità musicali nel feed. Questo include Album, artisti, brani e Playlist contenuti.
  • ["Radio"]: il fornitore include solo le entità Radio nel feed.
  • ["Music", "Radio"]: il fornitore include entità musicali e radio nel feed. Questo include Album, artisti, brani, Playlist, e Radio Station contenuti.

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