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 |
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).
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).
È 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.
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
Immagini di esempio e relativo contentAttributes
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, |
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 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 sfondorightCentered
eleftCentered
possono essere utilizzate da alcuni prodotti, quindi puoi includerle se ne hai.- Preferiamo immagini che funzionino sia per
smallFormat
sia perlargeFormat
. - 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"]
}
]
}]
}