Riferimento XML per l'elenco hotel

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 di hotel in sé non contiene informazioni sui prezzi.

L'elemento principale di un elenco di hotel è l'elemento <listings> che contiene gli elementi <listing> che descrivono le tue proprietà.

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 o ospitarlo sul tuo server.

Individuare e risolvere i problemi relativi ai dati

Per trovare e risolvere problemi relativi ai dati nell'elenco di hotel, consulta i seguenti articoli:

• Come configurare l'inventario degli hotel
• Risolvere i problemi di corrispondenza delle proprietà

Requisiti della scheda

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 ricettive non idonee sono crociere e appartamenti, perché di solito non soddisfano i criteri Listing requirements.

Bungalow e altri campeggi con pareti fisse, impianti idraulici e climatizzazione (tra cui stufe a legna o stufe a propano) sono idonei. Le strutture ricettive all'aperto non idonee includono:

• Campeggi, dove gli ospiti soggiornano in tende
• Area di sosta per camper, con il proprio camper

<listings>

<listings> è l'elemento principale di un elenco di hotel e contiene un elemento <language> e almeno un <listing>.

L'elemento <listings> compare nella seguente posizione nella gerarchia XML dell'elenco di hotel:

+ <listings>
    + <language>
    + <datum>
    + <listing>

Sintassi

La sintassi dell'elemento <listings> è la seguente:

<?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	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	Campo 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 datum, il valore predefinito per questo elemento è WGS84, che è utilizzato dalla maggior parte dei dispositivi GPS moderni. Il dato di Tokyo si applica solo agli indirizzi in Giappone. I valori validi per questo elemento sono: WGS84 wgs84 TOKYO tokyo Nota: per utilizzare il valore predefinito di WGS84, non includere l'elemento <datum> nell'elenco di 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 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, 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 all'interno di un elemento <listings> di un elenco di hotel.

L'elemento <listing> compare nella seguente posizione nella gerarchia XML del feed elenco hotel:

+ <listings>
    + <language>
    + <listing>

Sintassi

La sintassi dell'elemento <listing> è la seguente:

<?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:

Punto chiave: specifica gli elementi secondari nell'ordine mostrato di seguito.

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, perché ciò potrebbe causare problemi quando cerchi 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, format, che devi impostare su simple. Come minimo, devi fornire via, città, stato o regione e codice postale dell'hotel. Utilizza gli elementi secondari <component> per descrivere ciascuna delle seguenti parti dell'indirizzo: addr1: l'indirizzo principale dell'hotel. addr2: l'indirizzo secondario, se necessario. addr3: terza parte dell'indirizzo, se necessario. city: il nome della città dell'hotel. province: nome dello stato, della regione o della provincia dell'hotel. postal_code: il codice postale dell'hotel. 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, 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 in metri della posizione della proprietà inviata 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 vale solo per le case vacanze.
<phone>	Required*	string	Uno o più numeri di contatto dell'hotel. Se la scheda è una filiale dell'attività commerciale, fornisci il numero di telefono della sede specifica (non il numero di telefono della sede centrale). L'attributo type può essere uno dei seguenti: fax: numero di fax. main: numero di telefono vocale principale. mobile: numero di cellulare. tdd: numero di telefono per dispositivo di telecomunicazione per sordi (TDD). tollfree: numero verde. Ad esempio: <!-- Singapore (country code +65) --> <phone type="main">[phone]</phone> <!-- U.S. (country code +1) --> <phone type="fax">[phone]</phone> Come minimo, devi fornire un tipo main.
<category>	Optional	string	Il tipo di proprietà, ad esempio un hotel. I partner possono utilizzare qualsiasi categoria interna per descrivere la loro proprietà, ad esempio "business hotel", "resort", "motel" e simili.
<content>	Optional	<content>	Dettagli facoltativi utilizzati per la scheda, come una descrizione, le valutazioni e le funzionalità della proprietà.

* È necessario specificare un 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" 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, 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 una scheda, 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> compare nella seguente posizione nella gerarchia XML del feed elenco hotel:

+ <listings>
    + <language>
    + <listing>
        + <content>

Sintassi

La sintassi dell'elemento <content> è la seguente:

<?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 type="description">	Optional	Object	La pagina web associata alla scheda del fornitore. Contiene i seguenti elementi secondari: <link>: un link alla descrizione. (Facoltativo) Includi "http://" o "https://" in questo elemento. <title>: il titolo della descrizione (facoltativo). <author>: l'autore della descrizione (facoltativo). <body>: il corpo della descrizione (obbligatorio). <date>: la data della descrizione (facoltativo). Nota: questi elementi devono apparire nell'ordine indicato sopra.
<review type="[editorial|user]">	Optional	<review>	Contiene una recensione di un utente o una recensione editoriale della scheda. La tua scheda può contenere un numero illimitato di recensioni, di entrambi i tipi. Non è necessario includere tutte le recensioni di una proprietà nell'elemento <listing>; questo elemento ti consente di includere recensioni selezionate che illustrino le caratteristiche o la qualità di questa scheda.
<attributes>	Optional	Object	Contiene 0 o più elementi secondari <client_attr> che forniscono dettagli sulla proprietà. Gli elementi secondari utilizzano la seguente sintassi: <client_attr name="attribute_name">attribute_value<client_attr> Per un elenco e una descrizione degli elementi secondari, consulta <attributes>. Tutti gli elementi <client_attr> sono facoltativi. Se è presente un elemento secondario <website>, deve essere posizionato prima di qualsiasi elemento <client_attr>.
<image>	Optional	Object	Tag ripetuto che 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 consente di includere recensioni selezionate che siano indicative delle caratteristiche o della qualità della scheda.

L'elemento <review> compare nella seguente posizione nella gerarchia XML del feed elenco hotel:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

Punto chiave: prima che le recensioni di terze parti possano essere integrate su Google, devi configurare un Contratto di licenza per i contenuti (CLA). Consulta la pagina Come inviare recensioni di terze parti a Google e contatta il tuo Sales Account Manager per ulteriori informazioni.

Sintassi

La sintassi dell'elemento <review> è la seguente:

<?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: editorial: una recensione di un sito web o di un'altra autorità di revisione. user: una recensione di un utente finale.

Elementi secondari

L'elemento <review> ha i seguenti elementi secondari:

Punto chiave: specifica gli elementi secondari nell'ordine mostrato di seguito.

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 da 0 a 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: day: il giorno del mese; ad esempio, "7". month: il mese, dove 1 = gennaio ... 12 = dicembre. year: l'anno di quattro cifre, ad esempio "2023". Ad esempio, il 7 giugno 2023 è scritto come: <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 è uguale a quello del campo <date> riportato sopra. Ad esempio, il 7 giugno 2023 è scritto come: <servicedate month="6" day="7" year="2023"/> Le recensioni senza compilare almeno il mese e l'anno in data <servicedate> potrebbero non essere visualizzate. Il giorno non è obbligatorio.

Tieni presente che <title> è un elemento secondario valido di <review> solo se il 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 degli utenti:

<?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.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>

Punto chiave: tutti gli attributi sono facoltativi.

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" aggiuntiva della proprietà che può essere specificata utilizzando l'elemento attribute_name o attribute_name supportato per le case vacanze.

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 dei contenuti validi
alternate_hotel_id	Un identificatore alternativo per la tua proprietà. La presenza di ID separati è utile se ti serve un identificatore di proprietà per le informazioni del feed e un altro identificatore di proprietà per il tuo sistema di prenotazione.	Qualsiasi valore stringa
custom_[0-4]	Qualsiasi attributo personalizzato di tipo stringa. Questi dati 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-5, 0-10 o 0-100, ma puoi utilizzare qualsiasi intervallo che rappresenti il tuo sistema di classificazione.

Valori per il segnaposto attribute_name per case vacanze

Consulta l'esempio di codice XML e degli attributi specifici di Case vacanze.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>
            + <attributes>
            + <image>

Le immagini vengono utilizzate per mostrare la proprietà nell'ID scheda. Tutte le immagini utilizzate devono rispettare 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 indicate di seguito:

  1. Consente al crawler Googlebot di eseguire la scansione dei contenuti del tuo sito, immagini incluse.

     • User-agent: Googlebot
     • Allow: /

  2. 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.

Punto chiave: solo i partner configurati per mostrare le proprie immagini agli utenti finali possono mostrare le proprie immagini sulle piattaforme Google. Contatta il tuo Technical Account Manager (TAM) per aggiornare le impostazioni dell'immagine.

Attributi

• "ad" se l'immagine è una pubblicità.
• "menu" se l'immagine riguarda 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. Usa l'attributo url per specificare l'immagine da utilizzare nella 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

Punto chiave: specifica gli elementi secondari nell'ordine mostrato di seguito.

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 in 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 obbligatoria	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. 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 riportati di seguito.

• Puoi specificare i valori dei dati nel tuo feed con sezioni CDATA. Se utilizzi le sezioni CDATA, non inserire caratteri di escape per i 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. La tabella riportata di seguito elenca i codici comuni di entità e caratteri che puoi utilizzare:

  Basato su caratteri	Entità	Codice carattere
  E commerciale (&)	&	&
  Virgoletta singola (')	'	'
  Virgolette doppie (")	"	"
  Maggiore di (>)	>	>
  Minore di (<)	&lt;	&#60;

• Ometti gli elementi XML che non contengono dati. Ad esempio, se non conosci la latitudine e la longitudine di un hotel, non devi includere elementi <latitude/> e <longitude/> vuoti.

• Non utilizzare in alcun caso il codice HTML negli elementi XML (anche se è preceduto da una sequenza di escape).

• Per convalidare il feed prima di caricarlo, puoi utilizzare lo 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"/>