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 hotel non contiene informazioni sui prezzi.

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

L'elenco hotel viene creato da te durante l'implementazione iniziale e successivamente puoi aggiungere o rimuovere hotel nell'ambito della manutenzione ordinaria.

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 hotel, puoi caricarlo manualmente su Google utilizzando https://support.google.com/hotelprices/ o ospitarlo sul tuo server.

Individuare e risolvere i problemi relativi ai dati

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

Requisiti per gli hotel

Ai fini dell'idoneità per Google Hotel Ads, una proprietà nell'elenco hotel deve avere i requisiti seguenti:

  • Camere in cui possono soggiornare gli ospiti paganti
  • Presenza fisica e ubicazione fissa aperta al pubblico
  • Pareti fisse e impianto idraulico
  • Periodo minimo di soggiorno non superiore a 7 giorni

Alcuni esempi di strutture ricettive non idonee sono navi da crociera e appartamenti, poiché di solito non soddisfano i criteri Listing requirements.

Bungalow e altre strutture per campeggio con pareti fisse, impianti idraulici e controllo della temperatura (comprese stufe a legna o stufe a propano) sono idonee. Le strutture ricettive all'aperto non idonee includono:

  • Campeggi, dove gli ospiti soggiornano in tende
  • Area di sosta per camper, dove gli ospiti portano i propri camper

<listings>

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

L'elemento <listings> compare nella seguente posizione nella gerarchia XML dell'elenco 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> prevede 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> prevede i seguenti elementi secondari:

Elemento secondario 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 del datum, il valore predefinito per questo elemento è WGS84, che viene utilizzato dalla maggior parte dei dispositivi GPS moderni. Il datum di 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 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 gli ID non devono mai essere riutilizzati.

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 un elemento <listing> 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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> dell'elenco di hotel.

L'elemento <listing> compare 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> prevede i seguenti elementi secondari:

Elemento secondario Obbligatorio? Tipo Descrizione
<id> Required string Un identificatore univoco dell'hotel.

Nota: questo valore deve rimanere sempre univoco per il tuo sito. Non riutilizzare gli ID, in quanto ciò potrebbe causare problemi quando tenti 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 deve essere impostato 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: via e numero civico dell'hotel.
  • addr2: seconda parte dell'indirizzo, se necessaria.
  • addr3: 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: 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 La precisione in metri della posizione della proprietà, inviata quando la latitudine e la longitudine della proprietà sono offuscate. Zero (0) significa 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 per l'hotel. Se l'attività è una sede secondaria, fornisci il numero di telefono specifico di tale sede (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 con dispositivo telefonico per sordi (DTS).
  • tollfree: numero verde senza costi.

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 categoria interna per descrivere la proprietà, ad esempio "business hotel", "resort", "motel" e simili.
<content> Optional <content> Dettagli facoltativi utilizzati per l'hotel, come una descrizione, le valutazioni e le caratteristiche della proprietà.

* È obbligatorio specificare il 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 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 un elemento <listing> 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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, 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

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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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> prevede i seguenti elementi secondari:

Elemento secondario Obbligatorio? Tipo Descrizione
<text type="description"> Optional Object

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

  • <link>: un link alla descrizione. Includi "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 (facoltativo).

    • Nota: questi elementi devono comparire nell'ordine indicato sopra.
<review type="[editorial|user]"> Optional <review>

Contiene una recensione di un utente o una recensione editoriale della scheda. Puoi aggiungere tutte le recensioni che vuoi, di entrambi i tipi.

Non è necessario includere tutte le recensioni per una proprietà nell'elemento <listing>, destinato piuttosto a recensioni selezionate che illustrino le caratteristiche o la qualità di questa proprietà.

Punto chiave: <review> deve essere inviato solo per gli account di case vacanze. Per saperne di più, contatta il tuo Technical Account Manager (TAM).
<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 la sezione <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 Elemento ripetuto contenente 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 servizi della proprietà e per classificare le valutazioni della proprietà.

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <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 aggiuntiva o "attributo" della proprietà, che può essere specificata utilizzando un valore attribute_name o attribute_name per case vacanze supportato.

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 validi dei contenuti
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 motore di prenotazione. Qualsiasi valore stringa
Ritirato:qualsiasi attributo personalizzato di tipo stringa. Questi dati non vengono mostrati agli utenti.

Importante:contatta il tuo Technical Account Manager (TAM) se vuoi utilizzare le variabili CUSTOM.

 Qualsiasi valore stringa
hotel_brand Il brand a cui appartiene l'hotel. Ad esempio, "Marriott" o "Hilton". Questo attributo 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 Lodging proto. Stringa con codifica Base64 del proto Lodging
num_reviews Numero di recensioni della proprietà.

Punto chiave: "num_reviews" deve essere inviato solo per i feed di case vacanze.

 Qualsiasi numero intero non negativo.
rating Un numero in virgola mobile che rappresenta la valutazione complessiva della proprietà. Generalmente 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. Ad esempio, la valutazione della proprietà deve essere 3 o 4 per una scala di valutazione di 5.

Nota: se non specificata, la scala di valutazione predefinita è 0-10.

Valori per il segnaposto attribute_name per case vacanze

Consulta Attributi specifici per le case vacanze ed esempio XML.

<image>

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

Le immagini vengono utilizzate per mostrare la proprietà identificata dall'ID nell'elemento <listing>. 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 dal 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:

    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.

Attributi

  • "ad" se l'immagine è un annuncio pubblicitario
  • "menu" se l'immagine è un menu di ristorante
  • "photo" se l'immagine è una foto dell'attività
Nome attributo Obbligatorio? Formato Descrizione
type Required Text

Il tipo dell'immagine deve essere uno dei 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 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

Elemento secondario Obbligatorio? Descrizione
<link> Richiesto, ma obbligatorio per le proprietà 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. 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 sia un nome utente che un nome completo nel formato "Nome Cognome".
<date> Obbligatorio

Questo tag identifica la data di creazione dell'elemento di 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 sulla sintassi

Per la creazione di un elenco hotel basato su XML, attieniti alle seguenti linee guida:

  • Convalida i file XML dell'elenco hotel in base allo 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 seguenti.

  • Puoi specificare i valori dei dati nel tuo feed con sezioni CDATA. Se utilizzi sezioni CDATA, non inserire caratteri di escape per i caratteri speciali.

  • Utilizza i codici di escape per i valori di dati non compresi in sezioni CDATA, inclusi gli URL. Per rappresentare questi caratteri speciali, puoi utilizzare il codice entità o il codice carattere. La tabella seguente elenca i codici comuni di entità e caratteri che puoi utilizzare:

    Carattere Entità Codice carattere
    E commerciale (&) &amp; &#38;
    Virgoletta singola (') &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 hai i valori di latitudine e longitudine di un hotel, non includere elementi <latitude/> e <longitude/> vuoti.

  • Non utilizzare mai codice HTML negli elementi XML (neanche delimitato da caratteri di escape).

  • Per convalidare il feed prima del caricamento, puoi utilizzare la definizione XSD per il 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 -->