Proprietà immagini

In questa sezione vengono descritte le proprietà di markup dei contenuti di image per film e programmi TV visualizzati. Questo markup consente ai fornitori di descrivere il tipo di immagine, ad esempio se che si tratti di un titolo, di uno sfondo o di un'immagine iconica e l'uso suggerito.

Tabella delle specifiche

La proprietà image può essere fornita per Movie, TVSeries TVSeason, o TVEpisode tipi di entità. Nella tabella seguente vengono descritte le proprietà disponibili per l'attributo image proprietà. Tieni presente che la proprietà additionalProperty include una la proprietà personalizzata contentAttributes, che contiene un array di valori che descrive 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 ulteriori dettagli, lettura contentAttributes
character Person

Obbligatorio se applicabile. Un personaggio immaginario associato a dell'immagine. Questa operazione è necessaria se contentAttribute include castInCharacter.
inLanguage Testo Obbligatorio se applicabile: la lingua del testo utilizzata nei dell'immagine. Utilizza uno dei codici lingua disponibili in Standard IETF BCP 47. Se l'immagine include un elemento contentAttribute di hasTitle, questa proprietà è obbligatoria.
regionsAllowed Luogo Consigliata: le regioni in cui l'immagine è consentita. In caso contrario specificato, si presume che l'immagine sia consentita ovunque. Specifica i paesi in Formato ISO 3166.
datePublished Data

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

  • La data può essere impostata nel futuro.

Se esistono limitazioni temporali per l'utilizzo dell'immagine, questa proprietà è obbligatorio se l'immagine non deve essere visualizzata prima della data specificata. In caso contrario, una limitazione può essere omessa. È obbligatorio che l'immagine corrispondente venga fornito nel feed almeno 7 giorni prima della data di pubblicazione. In questo modo aumentare le probabilità che i contenuti vengano visualizzati in tempo sulle piattaforme Google.

expires Data

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

  • Se i contenuti sono sempre disponibili dopo la pubblicazione, puoi omettere questa opzione proprietà.

È necessario che eventuali aggiornamenti alla data di scadenza siano apportati nel feed almeno 7 giorni prima della data di scadenza. Ciò aumenterà le probabilità che i contenuti vengano interrotti verranno mostrati sulle piattaforme Google alla data di scadenza.

audience Pubblico Consigliato: il pubblico di destinazione o preferito per questo argomento. dell'immagine.
audience.geographicArea AdministrativeArea Consigliate: le aree geografiche previste o preferite per questa immagine. Al contrario, usa regionsAllowed per specificare limitazioni. Se audience.geographicArea non è specificato, si presume che sia destinato all'uso ovunque. Specifica paesi in Formato ISO 3166.
copyrightHolder Organizzazione o persona Consigliato. La parte titolare del copyright di dell'immagine.
keywords Testo Consigliato: parole chiave o tag utilizzati per descrivere questa immagine. È possibile fornire più keywords utilizzando un array. Ad esempio, ["caratteristica, biografia"]
name Testo Consigliato: il nome dell'immagine.

contentAttributes

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

Tipo

  • iconic: un'immagine illustrativa che esemplifica il programma. Spesso un tipo artistico per il rendering delle immagini.
  • sceneStill: un estratto dell'immagine del programma.
  • castInCharacter: la foto di un membro del cast mentre appare nel personaggio. Se questo valore, includi anche character per identificare il carattere specifico nella dell'immagine. Se sono presenti più personaggi, ad esempio in un ensemble del cast, includi più proprietà character come un 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 la validità, utilizzane uno solo di questi tipi.

  • poster: un'immagine poster del programma. Nelle UI dei computer, questi possono essere utilizzati caroselli. Potrebbe contenere o meno il titolo del programma.
  • background: un'immagine adatta a essere utilizzata come sfondo con testo o UI in overlay. Queste immagini non contengono testo.

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

Idoneità per le dimensioni

  • smallFormat: un'immagine adatta agli schermi più piccoli come i dispositivi mobili 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 questi valori.

Idoneità in background

  • forDarkBackground: un'immagine, di solito un logo trasparente, adatta per l'utilizzo su uno sfondo scuro.
  • forLightBackground: un'immagine, di solito un logo trasparente, adatta per l'utilizzo su uno sfondo chiaro.

Per essere valido, utilizza al massimo un valore di idoneità in background.

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'elemento dell'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. Google generalmente non possono utilizzare queste immagini senza modificarle.
  • hasMatte: l'immagine ha un opaco. Può essere orizzontale (letterbox) verticale (pillarbox) o entrambe (windowbox). A volte le immagini sono accoppiate per adattarsi in un formato. Generalmente Google non può utilizzare queste immagini senza modifica.
  • noMatte: l'immagine non ha un opaco.
  • transparentBackground: lo sfondo dell'immagine è trasparente. Questo è in genere per le immagini che sono soltanto un titolo o un logo e nient'altro.

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

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 testo e UI in overlay.
  • leftCentered: la figura predominante è posizionata verso il lato sinistro di l'immagine, lasciando il lato destro relativamente vuoto per testo e UI in overlay.

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

Immagini di esempio con l'uso previsto

UI TV che mostra un'immagine di sfondo con testo e overlay di UI.
.
Un'interfaccia utente TV che mostra caroselli con immagini poster su uno sfondo .
Un'interfaccia utente mobile con un'immagine poster e uno sfondo iconic immagine.
Un'interfaccia utente mobile con un'immagine poster e uno sfondo sceneStill immagine.

Immagini di esempio e i relativi contentAttribute

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

Prodotti e piattaforme Google diversi richiedono tipi di immagine e proporzioni. Per garantire che i contenuti sia visualizzato correttamente su tutti i prodotti Google, chiediamo ai fornitori di fornire dei tipi di immagine della tabella seguente.

Proporzioni e contentAttribute Risoluzione minima (pixel) Film Serie TV Stagione TV Puntata TV Servizio di trasmissione
16:9, iconic poster 3840x2160
02:3, iconic poster 1000x1500
04:3, iconic poster 800x600
1:1, iconic poster 600x600

03: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, 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 ed entrambi forLightBackground e forDarkBackground)

 1800 x 1000

Per l'invio di immagini si applicano le seguenti linee guida:

  1. Le immagini devono essere in formato JPEG, PNG o WebP.
  2. Includere le tue immagini con la massima risoluzione possibile.
  3. Le dimensioni dei file non devono superare i 20 MB.
  4. È preferibile usare centered immagini. rightCentered e leftCentered le immagini di sfondo possono essere utilizzate anche da alcuni prodotti per consentirti di includerle se ne hai.
  5. Preferiamo immagini che funzionino sia per smallFormat sia per largeFormat.
  6. Puoi includere dimensioni delle immagini oltre a quelle elencate nella precedente tabella.
  7. Verifica che le proporzioni di ogni immagine siano uno dei valori comuni elencati in la tabella precedente. In caso contrario, viene visualizzato un avviso.

Immagini di esempio con schema

I seguenti esempi mostrano come formattare lo schema per le immagini associate a film o programmi TV.

Immagine di sfondo di un film con due caratteri

{
  "@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 TVSeries 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 della locandina 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"]
      }
    ]
  }
}

Locandina di film di grandi dimensioni con 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 temporali

{
  "@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"]
        }
      ]
    }]
}