Un elenco hotel è costituito da uno o più file XML che elencano tutti gli hotel per i quali fornirai informazioni sui prezzi. Il file dell'elenco hotel non contiene informazioni sui prezzi.
L'elemento principale di un elenco hotel è <listings>, che contiene
gli elementi <listing> che descrivono le tue proprietà.
L'elenco hotel viene creato da te durante l'implementazione iniziale e successivamente puoi aggiungere o rimuovere hotel nell'ambito della manutenzione ordinaria.
Assicurati che i file siano conformi alle linee guida sulla sintassi.
Ad esempio, utilizza la codifica UTF-8 e specifica questo schema di codifica includendo
l'attributo encoding nel tag XML.
Dopo aver creato un elenco hotel, puoi caricarlo manualmente su Google utilizzando https://support.google.com/hotelprices/ o ospitarlo sul tuo server.
Individuare e risolvere i problemi relativi ai dati
Per individuare e risolvere i problemi relativi ai dati dell'elenco di hotel, consulta i seguenti articoli:
Requisiti per gli hotel
Per poter essere presente in Google Hotel Ads, una proprietà nell'elenco di hotel deve avere i requisiti seguenti:
- Camere in cui possono soggiornare gli ospiti paganti
- Presenza fisica e ubicazione fissa aperta al pubblico
- Pareti fisse e impianto idraulico
- Periodo minimo di soggiorno non superiore a 7 giorni
Alcuni esempi di strutture ricettive non idonee sono navi da crociera
e appartamenti, poiché di solito non soddisfano i criteri Listing requirements.
Bungalow e altre strutture per campeggio con pareti fisse, impianti idraulici e controllo della temperatura (comprese stufe a legna o stufe a propano) sono idonee. Le strutture ricettive all'aperto non idonee includono:
- Campeggi, dove gli ospiti soggiornano in tende
- Area di sosta per camper, dove gli ospiti portano i propri camper
<listings>
<listings> è l'elemento principale di un elenco hotel e contiene
un elemento <language> e almeno un elemento <listing>.
L'elemento <listings> compare nella seguente posizione nella gerarchia XML
dell'elenco hotel:
+ <listings>
+ <language>
+ <datum>
+ <listing>
Sintassi
L'elemento <listings> utilizza la seguente sintassi:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="xsi"
xsi:noNamesp>ace<SchemaLo>cation="s<chema_xsd>&qu<ot;
> language la<nguage>_co<de/lang>uage
d<atum dat>um_code< /datum
> listing listing/listing
...
/listings
Attributi
L'elemento <listings> prevede i seguenti attributi:
| Attributo | Obbligatorio? | Descrizione |
|---|---|---|
xmlns:xsi |
Obbligatorio | Da impostare su http://www.w3.org/2001/XMLSchema-instance. |
xsi:noNamespaceSchemaLocation |
Obbligatorio | Da impostare su http://www.gstatic.com/localfeed/local_feed.xsd. |
Elementi secondari
L'elemento <listings> prevede i seguenti elementi secondari:
| Elemento secondario | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
| <language> | Required | string | La lingua in cui è scritto il feed. Imposta il valore di questo
elemento su un
codice lingua di due lettere. Ad esempio, en per l'inglese. |
| <datum> | Optional | enum | Questo elemento specifica il datum geodetico o il modello di riferimento per
le coordinate di latitudine/longitudine fornite nel feed. Se non viene fornito alcun valore del datum, il valore predefinito per questo elemento è WGS84, che
viene utilizzato dalla maggior parte dei dispositivi GPS moderni. Il datum di Tokyo è applicabile solo agli indirizzi in Giappone.
I valori validi per questo elemento sono:
WGS84, non includere
l'elemento <datum> nell'elenco hotel.
|
| <listing> | Required | <listing> |
Una o più voci che descrivono ogni hotel nel feed. Tieni presente che ogni hotel nell'elenco deve avere un ID univoco per il tuo sito e che gli ID non devono mai essere riutilizzati. |
Esempi
Indirizzo strutturato
L'esempio seguente mostra un elenco parziale di hotel con un indirizzo strutturato:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address format="simple">
<component name="addr1">6 Acacia Ave</component>
<component name="addr2">Floor 5</component>
<component name="city">London</component>
<component name="province">Greater London</component>
<component name="postal_code">SW1W 9TQ</component>
</address>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
Indirizzo in formato libero
L'esempio seguente mostra un elenco parziale di hotel con un indirizzo in formato libero:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
Contenuti facoltativi
L'esempio seguente mostra un elenco parziale di hotel con un elemento <listing> che contiene
un elemento <content> facoltativo:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
<language>en</language>
<listing>
<id>123456</id>
<name>My Apartment</name>
<address format="simple">
<component name="addr1">1 Sandstone Building</component>
<component name="city">Los Angeles</component>
<component name="postal_code">90210</component>
<component name="province">CA</component>
</address>
<country>US</country>
<latitude>40.730610</latitude>
<longitude>-73.935242</longitude>
<phone type="main">12345678</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>
<text type="description">
<link>https://examplelisting.com/listings/12345</link>
<title>3 bedrooms with ocean views</title>
<body>Stay in this newly renovated 3BR house with ocean views.</body>
<date month="7" day="23" year="2023"/>
</text>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<listing>
Una definizione di hotel all'interno di un elemento <listings> dell'elenco di hotel.
L'elemento <listing> compare nella seguente posizione nella gerarchia XML del
feed elenco hotel:
+ <listings>
+ <language>
+ <listing>
Sintassi
L'elemento <listing> utilizza la seguente sintassi:
<?xml version="1.0" encodin>g<="UTF-8&>quo<t;?
lis>tings< ...
list<ing
> !-- Specify listing's child elements in t>he or<de>r shown <bel>ow. -<-
> idhotel_<ID/id>
<namehot>el_name</name
address
> component name<="add>r1"<;street_address_1/comp>onent
comp<onent name>="<addr2"street_add>ress_2/co<mponent
> com<ponent name="city&qu>ot;city_name/<component
> c<omponent name="province>"provi<nce_name/c>ompon<ent
> com<ponent name="postal_code"postal_code/component
/address
!-- You> can <also< define> an address free<form, al>tho>ugh th<is is n>ot recommend<ed: --
> !-<- addres>sfreeform_addr<ess/addre>ss --<
cou>ntrycountry_cod<e/country
> l<atitudehotel_latitude/latitude
longitud>ehotel_longi<tude/l>ongit<ude
>phone< type=&qu>o<t;[fax|main|mobile|tdd|tollfree]"phone_number/phone
>categ<oryhote>l/categ<ory !-- >You< can use> <whatever >property type categories you wish --
contentcontent/content
/listing
/listings
Attributi
L'elemento <listing> non ha attributi.
Elementi secondari
L'elemento <listing> prevede i seguenti elementi secondari:
| Elemento secondario | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
| <id> | Required | string | Un identificatore univoco dell'hotel.
Nota: questo valore deve rimanere sempre univoco per il tuo sito. Non riutilizzare gli ID, in quanto ciò potrebbe causare problemi quando tenti di risolvere i problemi di corrispondenza delle proprietà. |
| <name> | Required | string | Il nome dell'hotel. Ad esempio:
<name>Belgrave House</name> |
| <address> | Required | Object or string | La posizione fisica completa dell'hotel. Questo elemento prevede un singolo attributo, Come minimo, devi fornire via, città, stato o regione
e codice postale dell'hotel. Utilizza gli elementi secondari
Ad esempio: <address format="si>mpl<e" component na>me="add<r1"6 >Aca<cia Ave/component co>mponent< name=&quo>t;a<ddr2"Floor 5/com>ponent< compone>nt <name="city"Lond>on/component < component> na<me="province"Great>er Londo<n/componen>t< compo>nent name="postal_code"SW1W 9TQ/component /address In alternativa, puoi fornire un indirizzo in "formato libero", anche se non è consigliabile. Ad esempio: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Caselle postali e altri indirizzi solo postali non sono considerati indirizzi fisici completi. |
| <country> | Required | string | Il paese in cui si trova l'annuncio. Il valore deve essere un
codice paese di due lettere.
Ad esempio "US" per gli Stati Uniti e "IT" per l'Italia. Ad esempio:
<country>US</country> |
| <latitude> | Required* | float | La latitudine corrispondente alla posizione dell'hotel. Ad esempio:
<latitude>37.423738</latitude> Questo valore può essere generato con strumenti di geocodifica come l'API di Google Maps. |
| <longitude> | Required* | float | La longitudine corrispondente alla posizione dell'hotel. Ad esempio:
<longitude>-122.090101</longitude> Questo valore può essere generato con strumenti di geocodifica come l'API di Google Maps. |
| <location_precision> | Optional | integer | La precisione in metri della posizione della proprietà, inviata quando la latitudine e la longitudine della proprietà sono offuscate. Zero (0) significa che non c'è offuscamento e che si tratta della posizione esatta. Nota: questo elemento si applica solo alle case vacanze. |
| <phone> | Required* | string | Uno o più numeri di contatto per l'hotel. Se la scheda è una sede secondaria dell'attività, fornisci il numero di telefono specifico di tale sede (non il numero di telefono della sede centrale). L'attributo
Ad esempio: <!-- Singapore (country code +65) --&g<t; phone type=&qu>ot;main"<+65 67>2<2-2323/phone !-- U.S. (country <code +1) --> >phone type=&quo<t;fax&>quot;+1 408-555-1111/phone Come minimo, devi fornire un tipo |
| <category> | Optional | string | Il tipo di proprietà, ad esempio un hotel. I partner possono utilizzare qualsiasi categoria interna per descrivere la proprietà, ad esempio "business hotel", "resort", "motel" e simili. |
<content> |
Optional | <content> |
Dettagli facoltativi utilizzati per l'hotel, come una descrizione, le valutazioni e le caratteristiche della proprietà. |
* È obbligatorio specificare il numero di telefono o la latitudine/longitudine. Ti consigliamo di definire entrambi.
Esempi
Indirizzo strutturato
L'esempio seguente mostra un elenco parziale di hotel con un indirizzo strutturato:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot;
languageen/<la>nguage
listing
!-- The value of id must be unique to your> site< f>or all< ti>me. D<o NO>T reuse IDs. -<-
> id12<3abc/id
nameBelgrav>e House</name
address form>at="sim<ple"
> c<omponent name="ad>dr1&quo<t;6 Acacia> Ave/co<mponent
compone>nt nam<e="ad>dr2&quo<t;Floor 5/component
> component nam<e="ci>ty"<;London/component
comp>onent na<me="p>rovin<ce">Great<er Lond>on</compone>nt
< component nam<e="p>ostal<_code&quo>t;SW1W 9TQ/<component
> /<address
count>ryGB/country<
l>atitu<de35.070>374/l<atitude
> < longitude-106.213648/longitude
phone type="main&qu>ot;<123-456->7890/ph<one
c>ategoryhotel/category !-- You can use whatever property type categories you wish --
/listing
...
/listings
Indirizzo in formato libero
L'esempio seguente mostra un elenco parziale di hotel con un indirizzo in formato libero:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot;
languageen/<la>nguage
listing
!-- The value of id must be unique to your> site< f>or all< ti>me. D<o NO>T reuse IDs. -<-
> id12<3abc/id>
nameBelgrave House/name
ad<dress6 E>lm Av<e Unit >3,< Boston,> MA, <02472/ad>dress
< c>ountryUS/cou<ntry
>latitude35.<070374/lat>itude<
longitude-10>6.213648/lon<gitude>
<phone ty>pe=&q<uot;main&>q<uot;123-456-7890/phone
categoryhotel/category !-- You can> us<e whatev>er prop<erty type> categories you wish --
/listing
...
/listings
Contenuti facoltativi
L'esempio seguente mostra un elenco parziale di hotel con un elemento <listing> che contiene
un elemento <content> facoltativo:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
la<ngu>ageen</lan>guage
list<ing
> id<123456/id
nameMy Ap>artment</name
address form>at="simple"<;
co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
component name=&q>uot;c<ity"L>os Ange<les/component
compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
< component name<="pr>ovinc<e"CA>/component<
/addr>ess
< country>US/country
<latitu>de40.<730610/l>atitu<de
lo>n<gitude-73.935242/longitude
phone type="main"123>45678</phone
> cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
> conte<nt
> text type="descrip<tion&q>uot;
< >linkhttps://examplelisting.com/listings/12345/link
< title3 bedr<ooms with ocean views/title
>bodySta<y in >this ne<wly renova>ted 3BR h<ouse wi>th ocean views./body
< date month=&q<uot;7" day="23&>quo<t; year=&quo>t;2023&<quot;/
> /text<
attributes
websitehttps://h>otel.exam<ple.>com/website
< client_attr< name>="rating"<;8.2/c>lient_a<ttr
> /<attribut>es
< im>age typ<e="p>hoto" url="https://image_url"
linkhttps://image_url/link
titleMain hotel picture/title
/image
/content
/listing
...
/listings
<content>
Aggiunge informazioni su un hotel, come valutazioni, comfort
e altri dettagli. L'elemento <content> è facoltativo. All'interno di <content>,
tutti gli elementi secondari sono facoltativi.
L'elemento <content> compare nella seguente posizione nella gerarchia XML del
feed elenco hotel:
+ <listings>
+ <language>
+ <listing>
+ <content>
Sintassi
L'elemento <content> utilizza la seguente sintassi:
<?xml version="1.0" encodin>g<="UTF-8&>quo<t;?
lis>tings< ...
> listin<g
conten<t
> !-- Specify text's child elements in t>he orde<r shown below. --
> text typ<e=&q>uot;descript<ion&q>uot;
< <>/span>linklisting_li<nk/lin>k
< titlelisting_title/<title
> au<thor>listing_author/auth<or
> bod<ylisting_description/body
dat>e month<=&quo>t;MM&qu<ot; day="DD" year=>"Y<YYY"/>
/t<ext
> !-- 0 or more attribut<es: --
> attr<ibutes
websitehttps://hotel.e>xample.com/website<
cli>ent_attr <name="alternate_hotel_id&>quot;altern<ate_hotel_id>/client_a<ttr
client_attr n>ame="hotel_<brand"h>otel_br<and/client_>attr
< client_attr name="rating">;aggreg<ate_rating/client_attr
/attributes
> !-- <a pi>cture of the hote<l or >property-<-
> image type=&quo<t;phot>o"< url=&>quot;<https://>ima<ge_url&q>uot;
< linkhttps://image_url/link
titleMain Hotel Picture/title
/image
/content
/listing
...
/listings
Attributi
L'elemento <content> non ha attributi.
Elementi secondari
L'elemento <content> prevede i seguenti elementi secondari:
| Elemento secondario | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
| <text |
Optional | Object | La pagina web associata alla scheda dal fornitore. Contiene i seguenti elementi secondari:
Nota: questi elementi devono comparire nell'ordine indicato sopra. |
| <review |
Optional | <review> | Contiene una recensione di un utente o una recensione editoriale della scheda. Puoi aggiungere tutte le recensioni che vuoi, di entrambi i tipi. Non è necessario includere tutte le recensioni per una proprietà
nell'elemento Nota importante: <review> deve essere inviato solo per gli account di case vacanze. Per ulteriori informazioni, contatta il tuo Technical Account Manager (TAM). |
| <attributes> | Optional | Object | Contiene 0 o più elementi secondari <client_attr name="attribute_>name"attri<bute_valuec>lient_attr Per un elenco e una descrizione degli elementi secondari, consulta la sezione
Tutti gli elementi Se è presente un elemento secondario |
| <image> | Optional | Object | Elemento ripetuto contenente informazioni dettagliate sull'immagine. |
Esempio
L'esempio seguente mostra un elenco parziale di hotel che include
l'elemento <content>:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
la<ngu>ageen</lan>guage
list<ing
> id<123456/id
nameMy Ap>artment</name
address form>at="simple"<;
co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
component name=&q>uot;c<ity"L>os Ange<les/component
compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
< component name<="pr>ovinc<e"CA>/component<
/addr>ess
< country>US/country
<latitu>de40.<730610/l>atitu<de
lo>n<gitude-73.935242/longitude
phone type="main"123>45678</phone
> cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
> conte<nt
> text type="descrip<tion&q>uot;
< >linkhttps://examplelisting.com/listings/12345/link
< title3 bedr<ooms with ocean views/title
>bodySta<y in >this ne<wly renova>ted 3BR h<ouse wi>th ocean views./body
< date month=&q<uot;7" day="23&>quo<t; year=&quo>t;2023&<quot;/
> /text<
attributes
websitehttps://h>otel.exam<ple.>com/website
< client_attr< name>="rating"<;8.2/c>lient_a<ttr
> /<attribut>es
< im>age typ<e="p>hoto" url="https://image_url"
linkhttps://image_url/link
titleMain hotel picture/title
/image
/content
/listing
...
/listings
<attributes>
Il tag <attributes> può essere utilizzato per descrivere i servizi della proprietà e per
classificare le valutazioni della proprietà.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <attributes>
Elementi secondari
| Elemento secondario | Obbligatorio? | Descrizione | |
|---|---|---|---|
| <website> | Optional | Il sito web principale dell'hotel. Se presente, deve essere posizionato
prima del primo elemento <client_attr>. Esempio:
<website>https://hotel.example.com</website> |
|
| <client_attr name="attribute_name"> | Optional | Una caratteristica aggiuntiva o "attributo" della proprietà, che può essere
specificata utilizzando il valore
attribute_name o
attribute_name per case vacanze supportato.
|
|
Valori per il segnaposto attribute_name
La seguente tabella elenca i valori validi per attribute_name nell'elemento <client_attr name="attribute_name">.
Valori per attribute_name |
Descrizione | Valori validi dei contenuti |
|---|---|---|
| alternate_hotel_id | Un identificatore alternativo per la tua proprietà. La presenza di ID separati è utile se hai bisogno di un identificatore di proprietà per le informazioni del feed e di un altro identificatore di proprietà per il motore di prenotazione. | Qualsiasi valore stringa |
| Ritirato:qualsiasi attributo personalizzato di tipo stringa. Questi dati non vengono mostrati agli utenti.
Importante:contatta il tuo Technical Account Manager (TAM) se vuoi
utilizzare le variabili |
Qualsiasi valore stringa | |
| hotel_brand | Il brand a cui appartiene l'hotel. Ad esempio, "Marriott" o "Hilton". Questo attributo non viene mostrato agli utenti, ma può essere utilizzato per raggruppare gli hotel. | Qualsiasi valore stringa |
| lodging | Rappresentazione codificata di tutti i campi disponibili nel
Lodging
proto. |
Stringa con codifica Base64 del proto encoded
Lodging |
| num_reviews | Numero di recensioni della proprietà.
Punto chiave: "num_reviews" deve essere inviato solo per i feed di case vacanze. |
Qualsiasi numero intero non negativo. |
| rating | Un numero in virgola mobile che rappresenta la valutazione complessiva della proprietà. | Generalmente questo numero è compreso tra 0 e 5, tra 0 e 10 o tra 0 e 100, ma
puoi utilizzare qualsiasi intervallo che rappresenti il tuo sistema di valutazione. Ad esempio,
la valutazione della proprietà deve essere 3 o 4 per una scala di valutazione di 5.
Nota: se non specificata, la scala di valutazione predefinita è 0-10. |
Valori per il segnaposto attribute_name per case vacanze
Consulta Attributi specifici per le case vacanze ed esempio XML.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
<!-- <review> is allowed in Vacation Rentals only -->
+ <review>
+ <attributes>
+ <image>
Le immagini vengono utilizzate per mostrare la proprietà identificata dall'ID nell'elemento <listing>. Tutte le immagini utilizzate devono seguire queste linee guida:
- Le proporzioni consigliate per le immagini sono 4:3.
- L'URL dell'immagine deve essere accessibile dal crawler Googlebot Image.
Se il tuo sito include un file robots.txt a livello della directory principale, verifica che contenga una delle due opzioni mostrate:
Consente al crawler Googlebot di eseguire la scansione dei contenuti del tuo sito, immagini incluse.
- User-agent: Googlebot
- Allow: /
Consente al crawler Googlebot Image di eseguire la scansione delle immagini sul tuo sito.
- User-agent: Googlebot-Image
- Allow: /
Non sono consentiti screenshot di immagini o siti web. Le immagini devono essere immagini o fotografie originali e reali.
Attributi
"ad"se l'immagine è un annuncio pubblicitario"menu"se l'immagine è un menu di ristorante"photo"se l'immagine è una foto dell'attività
| Nome attributo | Obbligatorio? | Formato | Descrizione |
|---|---|---|---|
| type | Required | Text | Il tipo dell'immagine deve essere uno dei seguenti: |
url |
Required | Text | L'URL dell'immagine a grandezza originale. Utilizza l'attributo url per specificare l'immagine da utilizzare sulla pagina. |
| width | Required | A non-negative integer | Larghezza dell'immagine, in pixel (consigliamo almeno 720 pixel). |
| height | Required | A non-negative integer | Altezza dell'immagine, in pixel (consigliamo almeno 720 pixel). |
Elementi secondari
| Elemento secondario | Obbligatorio? | Descrizione |
|---|---|---|
| <link> | Richiesto, ma obbligatorio per le proprietà con foto locali. | Questo tag contiene l'URL valido e aggiornato della pagina del tuo sito
su cui si trova l'immagine pertinente. Non contiene l'URL dell'immagine.
Esempio:<link><http://www.example.com/magic_pizza/></link> |
| <title> | Richiesta | Questo tag contiene il titolo dell'immagine. Esempio:
<title>"Luxury Apart<ment&q>uot;/title |
| <author> | Non obbligatoria | Il nome dell'autore dei contenuti. Il valore può essere sia un nome utente che un nome completo nel formato "Nome Cognome". |
| <date> | Obbligatorio | Questo tag identifica la data di creazione dell'elemento di contenuti. Devi inserire un anno, un mese e un giorno, come nell'esempio seguente: <date month="6" day=">7" year="2023"/ |
Esempio
L'esempio seguente mostra un elenco parziale di hotel con tag immagine:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot;
l>anguage<en/language
listing
content
image type="photo">; url=&qu<ot;h>ttps://image_url&<quot;> width=&q<uot;4>00" height="<300&qu>ot;
< linkhttps://image_u<rl/link>
<titleApartment at Sandstone/title
> <author>Jessi<ca Landl>ord</author
> < date mon>th="6" day="7" year="2023"/
/image
/content
/listing
...
/listings
Linee guida sulla sintassi
Per la creazione di un elenco hotel basato su XML, attieniti alle seguenti linee guida:
Convalida i file XML dell'elenco hotel in base allo schema XSD di Google.
Utilizza la codifica UTF-8. Specifica questo schema di codifica includendo l'attributo
encodingnel tag XML, come mostrato negli esempi.Puoi specificare i valori dei dati nel tuo feed con sezioni
CDATA. Se utilizzi sezioniCDATA, non inserire caratteri di escape per i caratteri speciali.Utilizza i codici di escape per i valori di dati non compresi in sezioni
CDATA, tra cui gli URL. Per rappresentare questi caratteri speciali, puoi utilizzare il codice entità o il codice carattere. La tabella seguente elenca i codici comuni di entità e caratteri che puoi utilizzare:Carattere Entità Codice carattere E commerciale (&) & & Virgoletta singola (') ' ' Virgolette doppie (") " " Maggiore di (>) > > Minore di (<) < < Ometti gli elementi XML che non contengono dati. Ad esempio, se non hai i valori di latitudine e longitudine di un hotel, non includere elementi
<latitude/>e<longitude/>vuoti.Non utilizzare mai codice HTML negli elementi XML (neanche delimitato da caratteri di escape).
Per convalidare il feed prima del caricamento, puoi utilizzare la definizione XSD per il feed locale http://www.gstatic.com/localfeed/local_feed.xsd.
Per utilizzare i commenti nel feed, racchiudili tra i tag
<!--e-->, come illustrato nell'esempio seguente:<!-- This is a comment -->