Riferimento XML per l'elenco hotel

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
  • wgs84
  • TOKYO
  • tokyo
di Gemini Advanced. Nota: per utilizzare il valore predefinito di 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, format, che hai deve essere impostato su simple.

Come minimo, devi specificare via, città, stato o regione e il codice postale dell'hotel. Usa <component> bambino 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: il nome dello stato, della regione o provincia.
  • 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 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 type può essere uno dei seguenti:

  • fax: numero di fax.
  • main: numero di telefono vocale principale.
  • mobile: numero di cellulare.
  • tdd: dispositivo di telecomunicazione per sordi (TDD) numero di telefono.
  • tollfree: numero verde.

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 main.
<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 type="description"> Optional Object

La pagina web associata alla scheda del fornitore. Contiene i seguenti elementi secondari:

  • <link>: un link alla descrizione. Includi il parametro "http://" o
    "https://" in questo elemento (facoltativo).
  • <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. 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 <listing>; questo elemento è pensato per includere recensioni selezionate che illustrano le caratteristiche o le caratteristiche di questa scheda qualità.
<attributes> Optional Object

Contiene 0 o più elementi secondari <client_attr> che forniscono i dettagli sulla proprietà. Gli elementi secondari utilizzano 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 <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:
  • editorial: una recensione di un sito web o di un'altra recensione l'autorità competente.
  • user: una recensione di un utente finale.

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

    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 originali e immagini o fotografie reali.

di Gemini Advanced.

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 utilizzi CDATA, 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 (&) &amp; &#38;
    Virgoletta semplice (') &apos; &#39;
    Virgolette doppie (") &quot; &#34;
    Maggiore di (>) &gt; &#62;
    Minore di (<) &lt; &#60;

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