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 |
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).
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).
È 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 anchecharacter
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.
Utilizzo consigliato
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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-1.png?authuser=7&hl=it)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-2.png?authuser=7&hl=it)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-3.png?authuser=7&hl=it)
iconic
immagine.![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-4.png?authuser=7&hl=it)
sceneStill
immagine.Immagini di esempio e i relativi contentAttribute
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-5.png?authuser=7&hl=it)
contentAttributes: ["iconic", "poster", "centered",
"hasTitle", "hasLogo", "noCopyright", "noMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-6.png?authuser=7&hl=it)
contentAttributes: ["iconic", "background", "centered",
"smallFormat", "largeFormat", "noTitle", "noLogo", "noCopyright",
"noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-7.png?authuser=7&hl=it)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=7&hl=it)
contentAttributes: ["iconic", "background",
"rightCentered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"noCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=7&hl=it)
contentAttributes: ["iconic", "poster", "smallFormat",
"largeFormat", "hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-10.png?authuser=7&hl=it)
contentAttributes: ["iconic", "poster", "largeFormat",
"hasTitle", "hasLogo", "noCopyright", "noMatte",
"centered"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-11.png?authuser=7&hl=it)
contentAttributes: ["castInCharacter", "hasTitle",
"hasLogo", "noCopyright", "noMatte", "centered", "largeFormat"] character:
{name: "Captain Pulsar"}
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-12.png?authuser=7&hl=it)
contentAttributes: ["logo", "hasTitle", "hasLogo",
"noCopyright", "noMatte", "centered", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-13.png?authuser=7&hl=it)
contentAttributes: ["logo", "hasTitle", "hasLogo"
"noCopyright", "noMatte", "centered", "transparentBackground",
"forLightBackground", "forDarkBackground", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-14.png?authuser=7&hl=it)
contentAttributes: ["sceneStill", "background",
"centered", "smallFormat", "largeFormat", "noTitle", "noLogo",
"hasCopyright", "noMatte"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-15.png?authuser=7&hl=it)
contentAttributes: ["iconic", "poster", "centered",
"noTitle", "noLogo", "hasCopyright", "hasMatte", "smallFormat",
"largeFormat"]
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-16.png?authuser=7&hl=it)
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, |
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 |
Per l'invio di immagini si applicano le seguenti linee guida:
- Le immagini devono essere in formato JPEG, PNG o WebP.
- Includere le tue immagini con la massima risoluzione possibile.
- Le dimensioni dei file non devono superare i 20 MB.
- È preferibile usare
centered
immagini.rightCentered
eleftCentered
le immagini di sfondo possono essere utilizzate anche da alcuni prodotti per consentirti di includerle se ne hai. - Preferiamo immagini che funzionino sia per
smallFormat
sia perlargeFormat
. - Puoi includere dimensioni delle immagini oltre a quelle elencate nella precedente tabella.
- 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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=7&hl=it)
{
"@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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-8.png?authuser=7&hl=it)
{
"@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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-9.png?authuser=7&hl=it)
{
"@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
![](https://developers-dot-devsite-v2-prod.appspot.com/static/actions/media/images/image-properties-17.png?authuser=7&hl=it)
{
"@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"]
}
]
}]
}