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 |
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).
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).
È 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àcharacterper identificare il carattere specifico nell'immagine. Se sono presenti più personaggi, ad esempio in un cast, includi più proprietàcharactercome 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.
Utilizzo consigliato
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àinLanguageper 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
iconic.
sceneStill.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, |
600x800 | |||||
|
16:9, |
3840x2160 | |||||
|
2:3, |
1000x1500 | |||||
|
3:4, |
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, |
1800 x 1000 |
Quando invii immagini, si applicano le seguenti linee guida:
- Le immagini devono essere in formato JPEG, PNG o WebP.
- Includi le immagini con la massima risoluzione.
- Le dimensioni dei file non devono superare i 20 MB.
- Sono preferibili le immagini
centered. Le immagini di sfondorightCenteredeleftCenteredpossono essere utilizzate anche da alcuni prodotti, quindi puoi includerle se le hai. - Preferiamo le immagini che funzionano sia per
smallFormatche perlargeFormat. - Puoi includere dimensioni delle immagini diverse da 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 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"]
}
]
}]
}