Riferimento XML per l'elenco hotel

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:

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

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

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, 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, 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 ognuna delle seguenti parti dell'indirizzo: addr1: la via principale dell'hotel. addr2: la via secondaria, se necessario. addr3: una terza parte dell'indirizzo, se necessaria. 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 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 type può essere uno dei seguenti: fax: numero di fax. main: numero di telefono vocale principale. mobile: numero di cellulare. tdd: numero di telefono del 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 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 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 (facoltativa). Nota: questi elementi devono apparire nell'ordine precedente.
<review type="[editorial|user]">	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 <listing>, che è destinato a te per 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, 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>

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 l'articolo Come inviare recensioni di terze parti a Google e contatta il tuo Sales Account Manager per ulteriori informazioni.

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: editorial: una recensione di un sito web o di un'altra autorità competente. 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 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: day: il giorno del mese, ad esempio "7". month: il mese, dove 1 = gennaio ... 12 = dicembre. year: l'anno a quattro cifre; ad esempio,"2023". 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>

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

  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 delle immagini.

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

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 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 sezioni CDATA, 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 (<)	&lt;	&#60;

• 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"/>