Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Proprietà immagini

Questa sezione descrive in dettaglio le proprietà di markup dei contenuti di image per film, programmi TV, trasmissioni TV in diretta ed eventi sportivi. Questo markup consente ai provider di descrivere il tipo di immagine, ad esempio se si tratta di un'immagine del titolo, di sfondo o iconica, e l'utilizzo suggerito.

Tabella delle specifiche

La proprietà image può essere fornita per i tipi di entità Movie, TVSeries, TVSeason, TVEpisode, SportsEvent o BroadcastEvent. La tabella seguente descrive le proprietà disponibili per la proprietà image. Tieni presente che la proprietà additionalProperty include un nome di proprietà personalizzata chiamato contentAttributes, che contiene un array di valori che descrivono il tipo di immagine e l'uso previsto.

Proprietà	Tipo previsto	Descrizione
`@context`	Testo	Obbligatorio: imposta sempre su `"http://schema.org"`.
`@type`	Testo	Obbligatorio: imposta sempre su `ImageObject`.
`contentUrl`	URL	Obbligatorio: l'URL dell'immagine.
`additionalProperty`	PropertyValue	Obbligatorio: definisce la proprietà `contentAttributes`, che descrive il tipo di immagine e l'uso previsto. Per maggiori dettagli, leggi `contentAttributes`.
`character`	Person	Obbligatorio, se applicabile: un personaggio immaginario associato all'immagine. Questo campo è obbligatorio se `contentAttribute` include `castInCharacter`. Nota: puoi utilizzare il tipo `Person` qui anche se il personaggio non è umano.
`inLanguage`	Testo	Obbligatorio se applicabile: la lingua del testo utilizzato nell'immagine. Utilizza uno dei codici lingua dello standard IETF BCP 47. Se l'immagine include un `contentAttribute` di `hasTitle`, questa proprietà è obbligatoria.
`regionsAllowed`	Luogo	Consigliato: le regioni in cui l'immagine è consentita. Se non specificato, si presuppone che l'immagine sia consentita ovunque. Specifica i paesi in formato ISO 3166.
`datePublished`	Data	Obbligatoria se applicabile: la data dopo la quale l'immagine è disponibile, nel formato ISO 8601 (incluso il fuso orario). La data può essere impostata nel futuro. Se esistono limitazioni basate sul tempo per l'utilizzo dell'immagine, questa proprietà è obbligatoria se l'immagine non deve essere visualizzata prima della data specificata. Se non esiste una limitazione di questo tipo, può essere omessa. È necessario che l'immagine corrispondente venga fornita nel feed almeno 7 giorni prima della data di pubblicazione. In questo modo, aumenterai le probabilità che i contenuti vengano mostrati sulle piattaforme Google in tempo.
`expires`	Data	Obbligatoria se applicabile: la data dopo la quale l'immagine non è più disponibile, nel formato ISO 8601 (incluso il fuso orario). Se i contenuti sono sempre disponibili dopo la pubblicazione, puoi omettere questa proprietà. È necessario che eventuali aggiornamenti alla data di scadenza vengano apportati nel feed almeno 7 giorni prima della data di scadenza. In questo modo, aumenteranno le probabilità che i contenuti non vengano più visualizzati sulle piattaforme Google alla data di scadenza.
`audience`	Pubblico	Consigliato: il pubblico di destinazione o preferito per questa immagine.
`audience.geographicArea`	AdministrativeArea	Consigliata: le regioni previste o preferite per questa immagine. Al contrario, utilizza `regionsAllowed` per specificare limitazioni rigide. Se `audience.geographicArea` non è specificato, si presume che sia destinato all'utilizzo ovunque. Specifica i paesi in formato ISO 3166.
`copyrightHolder`	Organization o Person	Consigliato: la parte che detiene il copyright dell'immagine.
`keywords`	Testo	Consigliato: parole chiave o tag utilizzati per descrivere l'immagine. È possibile fornire più `keywords` utilizzando un array. Ad esempio, ["feature, biography"]
`name`	Testo	Consigliato: il nome dell'immagine.
`width`	Intero	Facoltativo: larghezza dell'immagine in pixel, espressa come numero intero positivo (ad esempio, `1920`). Non includere stringhe di unità come `"px"`.
`height`	Intero	Facoltativo: l'altezza dell'immagine in pixel, espressa come numero intero positivo (ad esempio, `1080`). Non includere stringhe di unità come `"px"`.

contentAttributes

La proprietà contentAttributes di image descrive il tipo di immagine e ne definisce gli utilizzi suggeriti. Le categorie nel seguente elenco includono i valori contentAttributes che i fornitori devono includere in ogni ImageObject.

Tipo

iconic: un'immagine illustrativa che esemplifica il programma. Spesso si tratta di un rendering artistico.
sceneStill: un estratto di un'immagine del programma.
castInCharacter: una foto di un membro del cast nel ruolo del personaggio. Se utilizzi questo valore, includi anche la proprietà character per identificare il personaggio specifico nell'immagine. Se sono presenti più personaggi, ad esempio in un cast, includi più proprietà character come array.
logo: l'immagine contiene solo un logo. Può essere un logo grafico o un logo del titolo. Includi l'overlay corrispondente per specificare quale.

Per essere valido, utilizza uno e un solo tipo.

Uso consigliato

poster: un'immagine poster per il programma. Nelle UI dei computer, possono essere utilizzati nei caroselli. Questi potrebbero contenere o meno il titolo dello show.
background: un'immagine adatta per essere utilizzata come sfondo con overlay di testo o UI. Queste immagini non contengono testo.

Per essere valido, includi al massimo uno di questi utilizzi consigliati.

Idoneità delle dimensioni

smallFormat: un'immagine adatta a schermi più piccoli, come quelli degli smartphone. Qualsiasi testo o logo nell'immagine è leggibile su uno schermo di piccole dimensioni.
largeFormat: un'immagine adatta a schermi più grandi o poster stampati.

Nota: in genere, la maggior parte delle immagini è adatta ai formati di grandi dimensioni. Le eccezioni sono le immagini a bassa risoluzione, che apparirebbero sgranate se ridimensionate a una dimensione maggiore.

Un'immagine può utilizzare entrambi i valori.

Idoneità dello sfondo

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

Per essere valido, utilizza al massimo un valore di idoneità dello sfondo.

Sovrapposizioni

hasTitle: il titolo del programma o il nome del personaggio o dell'attore incluso nell'immagine. Assicurati di includere la proprietà inLanguage per l'immagine.
noTitle: l'immagine non include il titolo.
hasLogo: l'immagine include il logo di un film o di un programma, del proprietario dei contenuti o del distributore.
noLogo: l'immagine non include un logo.
hasCopyright: l'immagine include una nota sul copyright visibile.
noCopyright: l'immagine non include una nota sul copyright visibile. In genere, Google non può utilizzare queste immagini senza modifiche.
hasMatte: l'immagine ha un mascherino. Potrebbero essere orizzontali (letterbox), verticali (pillarbox) o entrambi (windowbox). A volte le immagini vengono incorniciate per adattarle a un formato. In genere, Google non può utilizzare queste immagini senza modifiche.
noMatte: l'immagine non ha un passepartout.
transparentBackground: lo sfondo dell'immagine è trasparente. In genere, questo attributo viene utilizzato per le immagini che contengono solo un titolo o un logo e nient'altro.

Per essere valido, è consentito un solo attributo per titolo, logo, copyright e matte.

Posizione della figura predominante

centered: la figura predominante è posizionata al centro dell'immagine.
rightCentered: la figura predominante è posizionata verso il lato destro dell'immagine, lasciando il lato sinistro relativamente vuoto per il testo e gli overlay della UI.
leftCentered: la figura predominante è posizionata verso il lato sinistro dell'immagine, lasciando il lato destro relativamente vuoto per il testo e gli overlay dell'interfaccia utente.

Per essere valida, includi al massimo una di queste posizioni.

Immagini di esempio con l'utilizzo previsto

Una UI TV che mostra un'immagine di sfondo con testo e overlay UI.

Una UI della TV che mostra caroselli con immagini di poster su un'immagine di sfondo.

Un'interfaccia utente mobile con un'immagine poster e un'immagine di sfondo `iconic`.

Un'interfaccia utente mobile con un'immagine poster e un'immagine di sfondo `sceneStill`.

Immagini di esempio e i relativi contentAttributes

`contentAttributes: ["iconic", "poster", "centered", "hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["iconic", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "background", "rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered"]`

`contentAttributes: ["castInCharacter", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character: {name: "Captain Pulsar"}`

`contentAttributes: ["logo", "hasTitle", "hasLogo", "noCopyright", "noMatte", "centered", "smallFormat", "largeFormat"]`

`contentAttributes: ["logo", "hasTitle", "hasLogo" "noCopyright", "noMatte", "centered", "transparentBackground", "forLightBackground", "forDarkBackground", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "noMatte"]`

`contentAttributes: ["iconic", "poster", "centered", "noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat", "largeFormat"]`

`contentAttributes: ["sceneStill", "background", "centered", "smallFormat", "largeFormat", "noTitle", "noLogo", "hasCopyright", "hasMatte"]`

Tipi di immagini preferiti per i prodotti Google

I diversi prodotti e piattaforme Google richiedono tipi di immagini e proporzioni differenti. Per garantire che i contenuti vengano visualizzati correttamente su tutti i prodotti Google, chiediamo ai fornitori di fornire tutti i tipi di immagini della tabella seguente.

Proporzioni e contentAttributes	Risoluzione minima (pixel)	Film	Serie TV	Stagione TV	Puntata TV	Servizio di trasmissione
16:9, `iconic` `poster`	3840x2160
2:3, `iconic` `poster`	1000x1500
4:3, `iconic` `poster`	800x600
1:1, `iconic` `poster`	600x600
3:4, `iconic` `poster`	600x800
16:9, `iconic` `background` [preferito] o `sceneStill`	3840x2160
2:3, `iconic` `background` [preferito] o `sceneStill`	1000x1500
3:4, `iconic` `background` [preferito] o `sceneStill`	600x800
1:1, logo del programma (`hasLogo`)	600x600
4:3, logo del canale (`logo`)	800x600
1:1, logo del canale (`logo`)	600x600
16:9, logo del canale (`logo`)	3840x2160
9:5, `hasTitle` `logo` (con `transparentBackground` ed entrambi `forLightBackground` e `forDarkBackground`)	1800 x 1000

Quando invii le immagini, si applicano le seguenti linee guida:

Le immagini devono essere in formato JPEG, PNG o WebP.
Includi le immagini con la risoluzione più alta che hai.
Le dimensioni dei file non devono superare i 20 MB.
centered immagini sono preferite. Alcuni prodotti possono utilizzare anche le immagini di sfondo rightCentered e leftCentered, quindi puoi includerle se le hai.
Preferiamo immagini che funzionino sia per smallFormat che per largeFormat.
Puoi includere dimensioni delle immagini oltre a quelle elencate nella tabella precedente.
Verifica che le proporzioni di ogni immagine corrispondano a uno dei valori comuni elencati nella tabella precedente. In caso contrario, viene visualizzato un avviso.

Immagini di esempio con schema

Gli esempi riportati di seguito mostrano come formattare lo schema per le immagini associate a film o programmi TV.

Immagine di sfondo di un film con due personaggi

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/my_favorite_movie",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A Movie poster",
    "Keywords": ["Mauren, Lord Wingflap the Destroyer"],
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" },
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"},
                           {"@type": "Country", "name": "CA"},
                           {"@type": "Country", "name": "AU"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Immagine di sfondo della serie TV limitata a due regioni

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "TVSeries",
  "@id": "http://www.example.com/mountain_view",
  "url": "http://www.example.com/mountain_view",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mountain View: A TV Show",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "regionsAllowed": [{ "@type": "Country", "name": "US" },
                       { "@type": "Country", "name": "GB" }],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "background", "rightCentered", "smallFormat",
                  "largeFormat", "noTitle", "noLogo", "noCopyright", "noMatte"]
      }
    ]
  }
}

Immagine del poster di un film destinata a due regioni

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": [{ "@type": "Country", "name": "US" },
                 { "@type": "Country", "name": "GB" }],
    "character": [
      {
        "@type": "Person",
        "name": "Captain Pulsar"
      }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "smallFormat", "largeFormat", "hasTitle",
                  "hasLogo", "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Poster di un film di grande formato con testo sia in coreano che in inglese

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["kr", "en"],
    "audience": { "@type": "Country", "name": "KR" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" },
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
  }
}

Rappresentazione di più immagini per regione

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-us.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "inLanguage": ["en"],
    "audience": { "@type": "Country", "name": "US" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}

Rappresentazione di immagini con limitazioni di tempo

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "Movie",
  "@id": "http://www.example.com/pulsar_quest",
  "url": "http://www.example.com/pulsar_quest",

  ...,


  "image": [{
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Pulsar Quest: A New Frontier poster",
    "contentUrl": "http://example.com/images/pulsar-quest-jp.jpg",
    "copyrightHolder": {
      "@type": "Organization",
      "name": "ExampleOrganization Studios, Inc."
    },
    "datePublished": "2022-10-31T17:00:00Z",
    "expires": "2025-10-31T16:59:59Z",
    "inLanguage": ["ja"],
    "audience": { "@type": "Country", "name": "JP" },
    "character": [
      { "@type": "Person", "name": "Captain Pulsar" },
      { "@type": "Person", "name": "Space Cadet Shaniah" },
      { "@type": "Person", "name": "Rove the Rover" }
    ],
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                  "noCopyright", "noMatte", "centered"]
      }
    ]
    },{
      "@context": "http://schema.org",
      "@type": "ImageObject",
      "name": "Pulsar Quest: A New Frontier poster",
      "contentUrl": "http://example.com/images/pulsar-quest-kr.jpg",
      "copyrightHolder": {
        "@type": "Organization",
        "name": "ExampleOrganization Studios, Inc."
      },
      "datePublished": "2021-10-31T17:00:00Z",
      "expires": "2023-10-31T16:59:59Z",
      "inLanguage": ["kr"],
      "audience": { "@type": "Country", "name": "KR" },
      "character": [
        { "@type": "Person", "name": "Captain Pulsar" },
        { "@type": "Person", "name": "Space Cadet Shaniah" },
        { "@type": "Person", "name": "Rove the Rover" }
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentAttributes",
          "value": ["iconic", "poster", "largeFormat", "hasTitle", "hasLogo",
                    "noCopyright", "noMatte", "centered"]
        }
      ]
    }]
}