Un elenco di hotel è uno o più file XML che elencano tutti gli hotel per i quali fornirai informazioni sui prezzi. Il file dell'elenco di hotel non contiene informazioni sui prezzi.
L'elemento principale di un elenco di hotel è l'elemento <listings>
, che contiene
<listing>
elementi che descrivono le tue proprietà.
Puoi creare un elenco di hotel nell'ambito dell'implementazione iniziale e poi aggiungere o rimuovere hotel dall'elenco nell'ambito della normale manutenzione.
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 di hotel, puoi caricarlo manualmente su Google utilizzando Hotel Center o ospitarlo sul tuo server.
Individuare e risolvere i problemi relativi ai dati
Per trovare e risolvere i problemi relativi ai dati nell'elenco di hotel, consulta i seguenti articoli:
Requisiti delle schede
Per essere idonea per Google Hotel Ads, una proprietà nell'elenco di hotel deve avere quanto segue:
- Camere in cui possono soggiornare gli ospiti paganti
- Presenza fisica e ubicazione fissa aperta al pubblico
- Pareti fisse e impianti idraulici
- Periodo minimo di soggiorno non superiore a 7 giorni
Alcuni esempi di strutture non idonee sono navi da crociera e appartamenti, perché di solito non soddisfano i criteri di Listing requirements
.
Sono idonei bungalow e altre strutture da campeggio con pareti fisse, impianti idraulici e con controllo della climatizzazione (comprese stufe a legna o stufe a propano). Le strutture ricettive all'aperto non idonee includono:
- Campeggi, dove gli ospiti soggiornano in tende
- Aree di sosta per camper, dove gli ospiti portano i propri camper
<listings>
<listings>
è l'elemento principale di un elenco di hotel e contiene un
elemento <language>
e almeno un <listing>
.
L'elemento <listings>
viene visualizzato nella seguente posizione nella gerarchia XML dell'elenco di hotel:
+ <listings>
+ <language>
+ <datum>
+ <listing>
Sintassi
L'elemento <listings>
utilizza la seguente sintassi:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
xsi:noNamespaceSchemaLocation="schema_xsd">
<language> language_code</language>
<datum> datum_code </datum>
<listing> listing</listing>
...
</listings>
Attributi
L'elemento <listings>
ha i seguenti attributi:
Attributo | Campo obbligatorio? | Descrizione |
---|---|---|
xmlns:xsi |
Obbligatorie | Da impostare su http://www.w3.org/2001/XMLSchema-instance . |
xsi:noNamespaceSchemaLocation |
Obbligatorie | Da impostare su http://www.gstatic.com/localfeed/local_feed.xsd . |
Elementi secondari
L'elemento <listings>
ha i seguenti elementi secondari:
Elemento secondario | Campo obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<language> | Required | string | La lingua in cui è scritto il tuo 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 dato geodetico o il modello di riferimento per
le coordinate di latitudine/longitudine fornite nel feed. Se non viene fornito alcun valore del dato, il valore predefinito per questo elemento è WGS84 , utilizzato dai dispositivi GPS più moderni. Il dato Tokyo è applicabile solo agli indirizzi in Giappone.
I valori validi per questo elemento sono:
WGS84 , non includere
l'elemento <datum> nell'elenco di hotel.
|
<listing> | Required | <listing> |
Una o più voci che descrivono ciascun hotel nel feed. Tieni presente che ogni hotel nell'elenco deve avere un ID univoco per il tuo sito e che questo ID non deve mai essere riutilizzato. |
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 una scheda 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>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</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 in un elemento <listings>
elenco hotel.
L'elemento <listing>
viene visualizzato 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" encoding="UTF-8"?>
<listings ... >
<listing>
<!-- Specify <listing>'s child elements in the order shown below. -->
<id>hotel_ID</id>
<name>hotel_name</name>
<address>
<component name="addr1">street_address_1</component>
<component name="addr2">street_address_2</component>
<component name="city">city_name</component>
<component name="province">province_name</component>
<component name="postal_code">postal_code</component>
</address>
<!-- You can also define an address freeform, although this is not recommended: -->
<!-- <address>freeform_address</address> -->
<country>country_code</country>
<latitude>hotel_latitude</latitude>
<longitude>hotel_longitude</longitude>
<phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>content</content>
</listing>
</listings>
Attributi
L'elemento <listing>
non ha attributi.
Elementi secondari
L'elemento <listing>
ha i seguenti elementi secondari:
Elemento secondario | Campo obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<id> | Required | string | Un identificatore univoco dell'hotel.
Nota: questo valore deve essere sempre univoco per il tuo sito. Non riutilizzare gli ID, in quanto ciò potrebbe causare problemi durante il tentativo di risolvere 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 utilizza 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="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> 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 questa scheda. 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 | Precisione della posizione della proprietà inviata in metri quando la latitudine e la longitudine della proprietà sono offuscate. Zero (0) indica 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 dell'hotel. Se la scheda è una filiale dell'attività, fornisci il numero di telefono specifico della sede della filiale (non il numero di telefono della sede centrale). L'attributo
Ad esempio: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+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à, come "business hotel", "resort", "motel" e simili. |
<content> |
Optional | <content> |
Dettagli facoltativi utilizzati per la scheda, ad esempio una descrizione, valutazioni e caratteristiche della proprietà. |
* È obbligatorio specificare un numero di telefono o 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" 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 una scheda 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>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<content>
Aggiunge informazioni su un hotel, come valutazioni e recensioni, comfort e
altri dettagli. L'elemento <content>
è facoltativo. All'interno di <content>
,
tutti gli elementi secondari sono facoltativi.
L'elemento <content>
viene visualizzato 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" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
<!-- Specify <text>'s child elements in the order shown below. -->
<text type="description">
<link>listing_link</link>
<title>listing_title</title>
<author>listing_author</author>
<body>listing_description</body>
<date month="MM" day="DD" year="YYYY"/>
</text>
<!-- 0 or more reviews: -->
<review type="[editorial|user]">
...
</review>
<!-- 0 or more attributes: -->
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
<client_attr name="custom_0">custom_attribute_0</client_attr>
<client_attr name="custom_1">custom_attribute_1</client_attr>
<client_attr name="custom_2">custom_attribute_2</client_attr>
<client_attr name="custom_3">custom_attribute_3</client_attr>
<client_attr name="custom_4">custom_attribute_4</client_attr>
<client_attr name="hotel_brand">hotel_brand</client_attr>
<client_attr name="num_reviews">number_of_reviews</client_attr>
<client_attr name="rating">aggregate_rating</client_attr>
</attributes>
<!-- a picture of the hotel or property-->
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main Hotel Picture</title>
</image>
</content>
</listing>
...
</listings>
Attributi
L'elemento <content>
non ha attributi.
Elementi secondari
L'elemento <content>
ha i seguenti elementi secondari:
Elemento secondario | Campo obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<text |
Optional | Object | La pagina web associata alla scheda del fornitore. Contiene i seguenti elementi secondari:
Nota: questi elementi devono apparire nell'ordine precedente. |
<review |
Optional | <review> |
Contiene una recensione dell'utente o una recensione editoriale della scheda. La tua scheda può avere un numero illimitato di recensioni, di entrambi i tipi. Non è necessario includere tutte le recensioni per una proprietà nell'elemento |
<attributes> | Optional | Object | Contiene 0 o più elementi secondari <client_attr name="attribute_name">attribute_value<client_attr> Per un elenco e una descrizione degli elementi secondari, consulta
Tutti gli elementi Se è presente un elemento secondario |
<image> | Optional | Object | Tag ripetuto, contiene informazioni dettagliate sull'immagine. |
Esempio
L'esempio seguente mostra un elenco parziale di hotel che include
l'elemento <content>
:
<?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>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<review>
Contiene una recensione di un utente o una recensione editoriale. Non è necessario includere tutte le
recensioni di una scheda nell'elemento <listing>
. Questo elemento è destinato
a includere recensioni selezionate che siano indicative delle caratteristiche
o della qualità di questa scheda.
L'elemento <review>
viene visualizzato nella seguente posizione nella gerarchia XML del feed elenco hotel:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
Sintassi
L'elemento <review>
utilizza la seguente sintassi:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
...
<!-- Specify <review>'s child elements in the order shown below. -->
<review type="editorial">
<link>review_link</link>
<title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
<author>review_author</author>
<rating>review_rating</rating>
<body>review_text</body>
<date>review_date</date>
<servicedate>review_servicedate</servicedate>
</review>
<review type="user">
<link>review_link</link>
<author>review_author</author>
<date month="MM" day="DD" year="YYYY"/> <!-- Date is for reviews of type "user" only -->
<servicedate month="MM" day="DD" year="YYYY"/> <!-- Service Date is for reviews of type "user" only -->
<rating>review_rating</rating>
<body>review_text</body>
</review>
</content>
</listing>
</listings>
Attributi
L'elemento <review>
ha i seguenti attributi:
Attributo | Campo obbligatorio? | Descrizione |
---|---|---|
type | Required | Il tipo di recensione. Imposta uno dei seguenti valori:
|
Elementi secondari
L'elemento <review>
ha i seguenti elementi secondari:
Elemento secondario | Campo obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<link> | Optional | string | Un link alla recensione. Includi "http://" o "https://" in questo elemento. |
<title> | Optional | string | (Solo recensioni editoriali) Il titolo della recensione. |
<author> | Optional | string | L'autore della recensione; ad esempio, "Susan von Trapp". Può anche essere il nome di un sito web o di una pubblicazione in cui viene visualizzata la recensione se non è accreditata. |
<rating> | Optional | string | Un numero in virgola mobile compreso tra 0 e 10 (inclusi) che rappresenta il punteggio della recensione. Ad esempio, "8,9". |
<body> | Optional | string | Il testo della recensione. Questo elemento non deve contenere HTML. |
<date month="MM" day="DD" year="YYYY"/> | Optional | Object | (Solo recensioni degli utenti) La data della recensione, specificata con i seguenti
attributi di questo elemento:
Ad esempio, il 7 giugno 2023 è scritto come segue: <date month="6" day="7" year="2023"/> |
<servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (Solo recensioni degli utenti) La data in cui il recensore ha visitato la scheda recensita. Il formato è lo stesso di <data> sopra.
Ad esempio, il 7 giugno 2023 è scritto come segue: <servicedate month="6" day="7" year="2023"/> Le recensioni che non indicano almeno il mese e l'anno <servicedate> compilato potrebbero non essere visualizzate. Il giorno non è obbligatorio. |
Tieni presente che <title>
è un elemento secondario valido di <review>
solo se il valore type
della recensione è editorial
, mentre <date>
è valido solo se type
è user
.
Esempio
L'esempio seguente mostra un elenco parziale di hotel con una scheda che contiene una recensione editoriale e una recensione di un utente:
<?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>
<review type="editorial">
<link>https://example.com/reviews/42</link>
<title>A little piece of heaven</title>
<author>EXAMPLE.COM</author>
<rating>8</rating>
<body>This place is really good.</body>
</review>
<review type="user">
<link>https://exampleperson.org/reviews/82</link>
<author>Susan von Trapp</author>
<rating>6</rating>
<body>Not a bad place, but I prefer to be closer to the beach.</body>
<date day="6" month="7" year="2023"/>
<servicedate day="16" month="6" year="2023"/>
</review>
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="rating">8.2</client_attr>
<client_attr name="num_reviews">14</client_attr>
</attributes>
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main hotel picture</title>
</image>
</content>
</listing>
...
</listings>
<attributes>
Il tag <attributes>
può essere utilizzato per descrivere i comfort della struttura e
classificare valutazioni e recensioni della struttura.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
Elementi secondari
Elemento secondario | Campo 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 o "attributo" aggiuntivo della proprietà, che
può essere specificata utilizzando il valore supportato
attribute_name o
attribute_name per le case vacanze.
|
Valori per il segnapostoattribute_name
La seguente tabella elenca i valori validi per attribute_name nell'elemento <client_attr name="attribute_name">.
Valori per attribute_name |
Descrizione | Valori di contenuti validi |
---|---|---|
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 sistema di prenotazione. | Qualsiasi valore stringa |
custom_[0-4] | Qualsiasi attributo personalizzato di tipo stringa. e non vengono mostrati agli utenti. | Qualsiasi valore stringa |
hotel_brand | Il brand a cui appartiene l'hotel. Ad esempio, "Marriott" o "Hilton". 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
protocollo
Lodging . |
Stringa con codifica Base64 del protocollo Lodging codificato |
num_reviews | Numero di recensioni della scheda. | Qualsiasi numero intero non negativo. |
rating | Un numero con rappresentazione in virgola mobile che rappresenta la valutazione complessiva della proprietà. | In genere 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. |
Valori per il segnapostoattribute_name per case vacanze
Consulta l'articolo sugli attributi specifici per le case vacanze e l'esempio XML.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
Le immagini vengono utilizzate per mostrare la proprietà nell'ID scheda. 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 al 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 di seguito:
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 è una pubblicità"menu"
se l'immagine è il menu di un ristorante"photo"
se l'immagine è una foto dell'attività
Nome attributo | Campo obbligatorio? | Formato | Descrizione |
---|---|---|---|
type | Required | Text | Un'immagine deve essere una delle seguenti: |
url | Required | Text | L'URL dell'immagine a grandezza originale. Utilizza l'attributo url per specificare l'immagine da utilizzare nella pagina. |
width | Required | A non-negative integer | Larghezza dell'immagine, in pixel (sono consigliati più di 720 pixel) |
height | Required | A non-negative integer | Altezza dell'immagine, in pixel (sono consigliati più di 720 pixel) |
Elementi secondari
Elemento secondario | Campo obbligatorio? | Descrizione |
---|---|---|
<link> | Richiesto, ma obbligatorio per le schede 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 stessa.
Esempio:<link><http://www.example.com/magic_pizza/></link> |
<title> | Richiesta | Questo tag contiene il titolo dell'immagine. Esempio:
<title>"Luxury Apartment"</title> |
<author> | Non obbligatorio | Il nome dell'autore dei contenuti. Il valore può essere un nome utente o un nome completo nel formato "Nome Cognome". |
<date> | Obbligatorie | Questo tag identifica la data di creazione dei 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" 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>
<content>
<review>
</review>
<attributes>
</attributes>
<image type="photo" url="https://image_url" width="400" height="300">
<link>https://image_url</link>
<title>Apartment at Sandstone</title>
<author>Jessica Landlord</author>
<date month="6" day="7" year="2023"/>
</image>
</content>
</listing>
...
</listings>
Linee guida per la sintassi
Quando crei un elenco di hotel basato su XML, segui queste linee guida:
Convalida i file XML dell'elenco hotel utilizzando lo schema XSD di Google.
Utilizza la codifica UTF-8. Specifica questo schema di codifica includendo l'attributo
encoding
nel tag XML, come mostrato negli esempi di seguito.Puoi specificare i valori dei dati nel tuo feed con sezioni
CDATA
. Se utilizzi sezioniCDATA
, non inserire caratteri di escape in caratteri speciali.Utilizza i codici di escape per i valori dei dati che non si trovano nelle sezioni
CDATA
, inclusi gli URL. Per rappresentare questi caratteri speciali, puoi utilizzare il codice entità o il codice carattere. Nella tabella seguente sono elencati i codici comuni di entità e caratteri che puoi utilizzare:Basato su caratteri Entità Codice carattere E commerciale (&) & & Virgoletta semplice (') ' ' Virgolette doppie (") " " Maggiore di (>) > > Minore di (<) < < Ometti gli elementi XML che non contengono dati. Ad esempio, se non hai la latitudine e la longitudine di un hotel, non devi includere elementi
<latitude/>
e<longitude/>
vuoti.Non utilizzare in nessun caso il codice HTML negli elementi XML (anche se contiene caratteri di escape).
Per convalidare il feed prima di caricarlo, puoi utilizzare il file XSD del 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 -->
Assicurati di chiudere l'elemento
<date>
in un elemento<review>
dell'utente. Ad esempio:<date day="2" month="12" year="2017"/>