Un elenco di hotel è uno o più file XML che elencano tutti gli hotel per i quali fornire informazioni sui prezzi. Il file dell'elenco di hotel non contiene i prezzi informazioni.
L'elemento principale di un elenco di hotel è l'elemento <listings>
, che contiene
Elementi <listing>
che descrivono le tue strutture.
Puoi creare un elenco di hotel nell'ambito dell'implementazione iniziale. e poi aggiungere o rimuovere hotel 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 oppure ospitarlo sul tuo .
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 a Google Hotel Ads, una proprietà nell'elenco di hotel deve includono 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
Esempi comuni di proprietà non idonee includono crociere e
appartamenti perché di solito non soddisfano i criteri Listing requirements
.
Baite e altre strutture da campeggio con pareti fisse, impianto idraulico, e il climatizzatore (incluse stufe a legna o stufe a propano) sono idonei. 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
<language>
elemento e almeno un <listing>
.
L'elemento <listings>
compare nella posizione seguente nell'elenco di hotel
Gerarchia XML:
+ <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 | 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>
ha i seguenti elementi secondari:
Elemento secondario | Obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<language> | Required | string | La lingua in cui è scritto il tuo feed. Imposta il valore
in 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 sono presenti valori datum
viene fornito, il valore predefinito per questo elemento è WGS84 , che
è utilizzato dalla maggior parte dei dispositivi GPS moderni. Il dato Tokyo è applicabile solo
in Giappone.
I valori validi per questo elemento sono:
WGS84 , non includere
<datum> nell'elenco di hotel.
|
<listing> | Required | <listing> |
Una o più voci che descrivono ciascun hotel nel feed. Tieni presente che ciascun 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 una struttura indirizzo:
<?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 formato libero indirizzo:
<?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
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>
compare nella posizione seguente nell'elenco di hotel
Gerarchia XML del feed:
+ <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 | Obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<id> | Required | string | Un identificatore univoco dell'hotel.
Nota: questo valore deve essere sempre univoco per il tuo sito. Cosa fare 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 specificare via, città, stato o regione
e il codice postale dell'hotel. Usa
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 file in formato libero anche se si tratta non consigliato. Ad esempio: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Tieni presente che le caselle postali o altri indirizzi solo postali non sono considerati indirizzi fisici completi. |
<country> | Required | string | Il paese in cui si trova questa scheda. Il valore deve corrispondere a 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. Per
esempio:
<latitude>37.423738</latitude> Questo valore può essere generato con strumenti di geocodifica come API di Google Maps. |
<longitude> | Required* | float | La longitudine corrispondente alla posizione dell'hotel. Per
esempio:
<longitude>-122.090101</longitude> Questo valore può essere generato con strumenti di geocodifica come 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 riguarda un'attività commerciale filiale, 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 categorie proprie per descrivere la struttura, ad esempio "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. Me consigliamo di definire entrambi.
Esempi
Indirizzo strutturato
L'esempio seguente mostra un elenco parziale di hotel con una struttura indirizzo:
<?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 formato libero indirizzo:
<?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
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 una scheda, ad esempio valutazioni e recensioni, comfort e
altri dettagli. L'elemento <content>
è facoltativo. Entro <content>
,
tutti gli elementi secondari sono facoltativi.
L'elemento <content>
compare nella posizione seguente nell'elenco di hotel
Gerarchia XML del feed:
+ <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 | 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. Il tuo Ogni scheda può contenere un numero illimitato di recensioni, di entrambi i tipi. Non è necessario includere tutte le recensioni per una proprietà nel
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
<content>
elemento:
<?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 tutti
recensioni di una scheda nell'elemento <listing>
. per questo elemento
di includere recensioni selezionate che indichino le caratteristiche della scheda
o qualità.
L'elemento <review>
compare nella posizione seguente nell'elenco di hotel
Gerarchia XML del feed:
+ <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 | 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 | Obbligatorio? | Tipo | Descrizione |
---|---|---|---|
<link> | Optional | string | Un link alla recensione. Includi "http://" o "https://" in questo . |
<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 con rappresentazione in virgola mobile compreso tra 0 e 10 (inclusi) che rappresenta la 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 in questo modo: <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 del giorno <data> in alto.
Ad esempio, il 7 giugno 2023 è scritto in questo modo: <servicedate month="6" day="7" year="2023"/> Recensioni senza almeno il mese e l'anno di <servicedate> i valori compilati potrebbero non essere visualizzati. 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 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 per
classifica valutazioni e recensioni della struttura.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <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 o "attributo" aggiuntivo della proprietà
può essere specificato utilizzando il modello
attribute_name oppure
attribute_name per le case vacanze.
|
Valori per il segnapostoattribute_name
La seguente tabella elenca i valori validi per attribute_name in <client_attr name="attribute_name"> .
Valori per attribute_name |
Descrizione | Valori di contenuti validi |
---|---|---|
alternate_hotel_id | Un identificatore alternativo per la tua proprietà. Avere ID separati è utile se hai bisogno di un identificatore di proprietà per le informazioni dei feed e 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". Questa informazione non viene mostrata agli utenti, ma può essere utilizzata per il raggruppamento hotel. | Qualsiasi valore stringa |
lodging | Rappresentazione codificata di tutti i campi disponibili nel
Lodging
un protocollo Google Cloud. |
Stringa con codifica Base64 del parametro
codificato
Protocollo Lodging |
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à. | Questo numero è in genere 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 classificazione. |
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 segui 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 originali e immagini o fotografie 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 | 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 sulla pagina. |
width | Required | A non-negative integer | La larghezza dell'immagine, in pixel (maggiore di 720 pixel è consigliato) |
height | Required | A non-negative integer | L'altezza dell'immagine, in pixel (maggiore di 720 pixel è consigliato) |
Elementi secondari
Elemento secondario | 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
che l'immagine pertinente sia attiva. 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> | Obbligatorio | Questo tag identifica la data di creazione dei contenuti. Tu 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
encoding
nel tag XML, come mostrato negli esempi di seguito.Puoi specificare i valori dei dati nel tuo feed con sezioni
CDATA
. Se utilizziCDATA
, non inserire caratteri speciali in caratteri di escape.Utilizza codici di escape per i valori dei dati che non si trovano nelle sezioni
CDATA
, tra cui URL. Puoi utilizzare il codice entità o il codice carattere per rappresentare questi caratteri speciali. Nella tabella seguente sono elencati i codici comuni di entità e caratteri che puoi utilizzare:Carattere 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 disponi la latitudine e la longitudine di un hotel, non devi includere Elementi
<latitude/>
e<longitude/>
.Non utilizzare il codice HTML negli elementi XML in nessuna circostanza (anche se è i caratteri di escape).
Per convalidare il tuo 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 tuo feed, racchiudili tra i tag
<!--
e-->
, come illustrato nell'esempio seguente:<!-- This is a comment -->
Assicurati di chiudere l'elemento
<date>
in un utente<review>
Ad esempio:<date day="2" month="12" year="2017"/>