Proprietà immagini

Questa sezione descrive in dettaglio le proprietà di markup dei contenuti di image per film e programmi TV. Questo markup consente ai fornitori di descrivere il tipo di immagine, ad esempio se si tratta di un titolo, uno sfondo o un'immagine iconica, nonché il suo utilizzo suggerito.

Tabella delle specifiche

La proprietà image può essere fornita per i tipi di entità Movie, TVSeries, TVSeason o TVEpisode. La seguente tabella 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 il suo utilizzo previsto.

Proprietà Tipo previsto Descrizione
@context Testo Obbligatorio: impostato sempre su "http://schema.org".
@type Testo Obbligatorio: impostato sempre su ImageObject.
contentUrl URL Obbligatorio: l'URL dell'immagine.
additionalProperty PropertyValue Obbligatorio: definisce la proprietà contentAttributes, che descrive il tipo di immagine e la sua destinazione d'uso. Per maggiori dettagli, leggi contentAttributes.
character Person

Obbligatorio se applicabile: un personaggio immaginario associato all'immagine. Questo è obbligatorio se contentAttribute include castInCharacter.
inLanguage Testo Obbligatorio se applicabile: la lingua del testo utilizzata 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 viene specificato, si presume che l'immagine sia consentita ovunque. Specifica i paesi in formato ISO 3166.
datePublished Data

Obbligatorio se applicabile: la data dopo la quale l'immagine è disponibile, in formato ISO 8601 (incluso il fuso orario).

  • La data può essere impostata in futuro.

Se ci sono limitazioni temporali per l'utilizzo dell'immagine, questa proprietà è obbligatoria se l'immagine non deve essere visualizzata prima della data indicata. Se non esiste una limitazione di questo tipo, può essere omessa. È necessario che l'immagine corrispondente sia fornita nel feed almeno 7 giorni prima della data di pubblicazione. In questo modo, aumenterai le probabilità che i contenuti vengano visualizzati sulle piattaforme Google in tempo.

expires Data

Obbligatorio 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à.

È obbligatorio che eventuali aggiornamenti della data di scadenza vengano apportati nel feed almeno 7 giorni prima della data di scadenza. In questo modo aumenterai 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 Consigliato: 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'uso 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 questa immagine. È possibile fornire più keywords utilizzando un array. Ad esempio, ["feature, biography"]
name Testo Consigliato: il nome dell'immagine.

contentAttributes

La proprietà contentAttributes di image descrive il tipo di immagine e definisce i relativi utilizzi suggeriti. Le categorie nell'elenco seguente includono i valori contentAttributes che i fornitori devono includere con ogni ImageObject.

Tipo

  • iconic: un'immagine che illustri il programma. Spesso si tratta di un rendering artistico.
  • sceneStill: un'immagine estratta dal programma.
  • castInCharacter: una foto di un membro del cast nei panni del suo personaggio. Se utilizzi questo valore, includi anche la proprietà character per identificare il carattere 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 di questi.

  • poster: un'immagine del poster del programma. Nelle UI dei computer, possono essere utilizzati nei carousel. Potrebbero contenere o meno il titolo del programma.
  • background: un'immagine adatta per l'utilizzo 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 gli smartphone. Qualsiasi testo o logo nell'immagine sia leggibile su uno schermo piccolo.

  • largeFormat: un'immagine adatta a schermi più grandi o poster stampati.

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 un programma, il proprietario dei contenuti o il 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'opacità. Può essere orizzontale (letterbox), verticale (pillarbox) o entrambi (windowbox). A volte le immagini vengono ritagliate per adattarle a un formato. In genere, Google non può utilizzare queste immagini senza modifiche.
  • noMatte: l'immagine non ha un'opacizzazione.
  • transparentBackground: lo sfondo dell'immagine è trasparente. Questo formato viene solitamente utilizzato per le immagini che contengono solo un titolo o un logo e nient'altro.

Per essere validi, sono consentiti un solo titolo, un solo logo, un solo copyright e un solo attributo opaco.

Posizione della figura predominante

  • centered: la figura predominante è posizionata al centro dell'immagine.
  • rightCentered: la figura predominante è posizionata verso il lato destro dell'immagine, il che lascia il lato sinistro relativamente vuoto per gli overlay di testo e UI.
  • leftCentered: la figura predominante è posizionata verso il lato sinistro dell'immagine, il che lascia il lato destro relativamente vuoto per i sovrapposizioni di testo e UI.

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

Immagini di esempio con l'uso previsto

Un'interfaccia utente della TV che mostra un'immagine di sfondo con testo e overlay dell'interfaccia utente.
Un'interfaccia utente della TV che mostra caroselli con immagini di poster su un'immagine di sfondo.
Un'interfaccia utente mobile con un'immagine del poster e un'immagine di sfondoiconic.
Un'interfaccia utente mobile con un'immagine del poster e un'immagine di sfondosceneStill.

Immagini di esempio e relativi attributi dei contenuti

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 desiderati per i prodotti Google

Prodotti e piattaforme Google diversi richiedono tipi di immagini e proporzioni diverse. Per garantire che i contenuti vengano visualizzati correttamente su tutti i prodotti Google, chiediamo ai fornitori di fornire tutti i tipi di immagini riportati nella 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 [opzione preferita] o sceneStill

 3840x2160

2:3, iconic background [opzione preferita] o sceneStill

 1000x1500

3:4, iconic background [opzione preferita] o sceneStill

 600x800
1:1, Mostra logo (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 e sia forLightBackground sia forDarkBackground)

 1800 x 1000

Quando invii immagini, si applicano le seguenti linee guida:

  1. Le immagini devono essere in formato JPEG, PNG o WebP.
  2. Includi le immagini con la massima risoluzione.
  3. Le dimensioni dei file non devono superare i 20 MB.
  4. Sono preferibili le immagini centered. Le immagini di sfondo rightCentered e leftCentered possono essere utilizzate anche da alcuni prodotti, quindi puoi includerle se le hai.
  5. Preferiamo le immagini che funzionano sia per smallFormat che per largeFormat.
  6. Puoi includere dimensioni delle immagini diverse da quelle elencate nella tabella precedente.
  7. Verifica che le proporzioni di ogni immagine siano 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"]
      }
    ]
  }
}

L'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 del 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 film in formato grande in coreano e 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"]
        }
      ]
    }]
}