Questa pagina è stata tradotta dall'API Cloud Translation.

Proprietà immagine

In questa sezione vengono descritte in dettaglio le proprietà del markup dei contenuti di image per film e programmi TV. Questo markup consente ai provider di descrivere il tipo di immagine, ad esempio se è un titolo, uno sfondo o un'immagine iconica e il suo utilizzo suggerito.

Tabella delle specifiche

La proprietà image può essere fornita per 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à personalizzato 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: sempre impostato su `"http://schema.org"`.
`@type`	Testo	Obbligatorio: sempre impostato su `ImageObject`.
`contentUrl`	URL	Obbligatorio: l'URL dell'immagine.
`additionalProperty`	PropertyValue	Obbligatorio: definisce la proprietà `contentAttributes`, che descrive il tipo di immagine e il suo utilizzo previsto. Per maggiori dettagli, leggi `contentAttributes`.
`character`	Person	Obbligatorio se applicabile: un carattere fittizio 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. Usa uno dei codici lingua dello standard IETF BCP 47. Se l'immagine include un elemento `contentAttribute` di `hasTitle`, questa proprietà è obbligatoria.
`regionsAllowed`	Luogo	Consigliato: le regioni in cui è consentita l'immagine. Se non 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 sono previste limitazioni in base all'uso dell'immagine in base al tempo, questa proprietà è obbligatoria se l'immagine non deve essere visualizzata prima della data specificata. Se non esiste questa limitazione, può essere omessa. È necessario che l'immagine corrispondente sia fornita nel feed almeno 7 giorni prima della data del lancio. In questo modo, è più probabile che i contenuti vengano visualizzati puntualmente sulle piattaforme Google.
`expires`	Data	Obbligatorio se applicabile: la data dopo la quale l'immagine non è più disponibile, in 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 siano specificati nel feed almeno sette giorni prima della data di scadenza. In questo modo, aumentano le probabilità che i contenuti cessino di essere visualizzati sulle piattaforme Google alla data di scadenza.
`audience`	Pubblico	Consigliato: il pubblico di destinazione o preferito per questa immagine.
`audience.geographicArea`	Area amministrativa	Consigliato: le regioni previste o preferite per questa immagine. Utilizza invece `regionsAllowed` per specificare limitazioni limitate. Se `audience.geographicArea` non è specificato, si presume che sia destinato a essere utilizzato ovunque. Specifica i paesi in formato ISO 3166.
`copyrightHolder`	Organizzazione o Persona	Consigliato: la parte che detiene il copyright dell'immagine.
`keywords`	Testo	Consigliato: le parole chiave o i tag utilizzati per descrivere questa immagine. È possibile fornire più `keywords` utilizzando un array. Ad esempio, ["funzionalità, biografia"]
`name`	Testo	Consigliato: il nome dell'immagine.

AttributiContent

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

Tipo

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

Per essere validi, utilizza uno solo di questi tipi.

Uso consigliato

poster: un'immagine poster del programma. Nelle UI dei computer, possono essere utilizzate nei caroselli. Questi contenuti potrebbero includere o meno il titolo del programma.
background: un'immagine da utilizzare 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à per le taglie

smallFormat: un'immagine adatta a schermi più piccoli come i telefoni cellulari. Qualsiasi testo o logo presente nell'immagine è leggibile su uno schermo piccolo.
largeFormat: un'immagine adatta a schermi più grandi o poster stampati.

Nota: in genere, la maggior parte delle immagini è adatta per i formati di grandi dimensioni. Fanno eccezione le immagini a bassa risoluzione, che sembrerebbero pixelate se ridimensionate a una dimensione maggiore.

Un'immagine può utilizzare entrambi i valori.

Idoneità per i precedenti

forDarkBackground: un'immagine, in genere un logo trasparente, adatta per l'uso su sfondo scuro.
forLightBackground: un'immagine, in genere un logo trasparente, adatta per l'utilizzo su 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 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. Generalmente Google non può utilizzare tali immagini senza modifiche.
hasMatte: l'immagine è opaca. Potrebbe essere orizzontale (letterbox), verticale (pillarbox) o entrambi (box finestra). A volte le immagini vengono opacizzate per adattarle alle proporzioni. Generalmente Google non può utilizzare tali immagini senza modifiche.
noMatte: l'immagine non è opaca.
transparentBackground: lo sfondo dell'immagine è trasparente. Questa proprietà di solito viene utilizzata per le immagini che sono solo un titolo o un logo e nient'altro.

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

Posizione di una figura predominante

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

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

Immagini di esempio con l'uso previsto

Un'interfaccia utente TV che mostra un'immagine di sfondo con testo e overlay di interfaccia.

Un'interfaccia utente TV che mostra caroselli con immagini poster su un'immagine di sfondo.

Un'interfaccia utente per dispositivi mobili con un'immagine poster e un'immagine `iconic` di sfondo.

Un'interfaccia utente per dispositivi mobili con un'immagine poster e un'immagine `sceneStill` di sfondo.

Immagini di esempio e relativo 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 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 nella tabella seguente.

Proporzioni e contentAttributes	Risoluzione minima (pixel)	Film	Serie TV	Stagione TV	Puntata TV	Servizio di trasmissione
16:9 e ore `iconic` `poster`	3840x2160
02:3, `poster` `iconic`	1000x1500
04:3, `poster` `iconic`	800x600
1:1 e `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` [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 `forLightBackground` e `forDarkBackground`)	1800 x 1000

Quando invii le immagini, segui queste linee guida:

Le immagini devono essere in formato JPEG, PNG o WebP.
Includi le immagini con la risoluzione più elevata che possiedi.
Le dimensioni del file non devono essere superiori a 20 MB.
centered immagini preferite. Anche le immagini di sfondo rightCentered e leftCentered possono essere utilizzate da alcuni prodotti, quindi puoi includerle se ne hai.
Preferiamo immagini che funzionino sia per smallFormat sia per largeFormat.
Puoi includere altre dimensioni oltre a quelle elencate nella tabella precedente.
Verifica che le proporzioni di ogni immagine siano uno dei valori comuni elencati nella tabella precedente. In caso contrario, viene inviato 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 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 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 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"]
      }
    ]
  }
}

Manifesto di film di grande formato 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 a tempo limitato

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