Referencia de XML de las listas de hoteles

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Las listas de hoteles constan de uno o varios archivos XML en los que figuran los hoteles cuyos precios vas a publicar. En estas listas solo se incluyen los hoteles, no los precios.

El elemento raíz de la lista de hoteles es <listings>, que contiene elementos <listing> que describen tus propiedades.

Puedes crear una lista de hoteles como parte de la implementación inicial y, más adelante, añadir o quitar los que quieras como parte del mantenimiento habitual.

Una vez creada la lista, puedes subirla manualmente a Google mediante Hotel Center o alojarla en tu servidor.

Requisitos de las fichas

Para poder formar parte de Hotel Ads de Google, las propiedades de tu lista de hoteles deben cumplir los siguientes requisitos:

  • Contar con habitaciones en las que se puedan alojar los huéspedes
  • Tener presencia física y una ubicación fija que esté abierta al público
  • Disponer de paredes fijas y fontanería
  • Ofrecer una estancia mínima que no supere los 7 días

Algunos ejemplos de propiedades que no los cumplen y, por tanto, no son aptas son los cruceros y los apartamentos.

Las cabañas rurales y otros establecimientos de acampada con paredes fijas, fontanería y climatizador, como estufas de leña o de propano, sí los cumplen. Estos son los alojamientos al aire libre que no son aptos:

  • Campings en los que los huéspedes se quedan en tiendas de campaña
  • Parques para caravanas donde los huéspedes llevan sus propios vehículos recreacionales

<listings>

<listings> es el elemento raíz de una lista de hoteles y contiene un elemento <language> y al menos un elemento <listing>.

El elemento <listings> ocupa el siguiente lugar de la jerarquía XML de la lista de hoteles:

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

Sintaxis

El elemento <listings> utiliza la siguiente sintaxis:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language>language_code</language>
  <listing>listing</listing>
  ...
</listings>

Atributos

El elemento <listings> tiene los siguientes atributos:

Atributo ¿Es obligatorio? Descripción
xmlns:xsi Obligatorio Especificado en "http://www.w3.org/2001/XMLSchema-instance".
xsi:noNamespaceSchemaLocation Obligatorio Especificado en "https://www.gstatic.com/localfeed/local_feed.xsd".

Elementos secundarios

El elemento <listings> tiene los siguientes elementos secundarios:

Elemento secundario ¿Es obligatorio? Tipo Descripción
<language> Obligatorio String El idioma en el que está escrito el feed. Especifica el valor de este elemento como un código de idioma de dos letras. Por ejemplo, "en" para inglés.
<listing> Obligatorio <listing> Una o varias entradas que describen cada hotel en el feed. Ten en cuenta que todos los hoteles de la lista deben tener un ID exclusivo de tu sitio web, y este ID no debe volver a utilizarse.

Ejemplos

Dirección estructurada

El siguiente ejemplo corresponde a una lista parcial de hoteles con una dirección estructurada:

<?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">666 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>UK</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>

Dirección en formato libre

El siguiente ejemplo corresponde a una lista parcial de hoteles con una dirección de formato libre:

<?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>666 Acacia Ave, Floor 5, 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>

Contenido opcional

El siguiente ejemplo corresponde a una lista parcial de hoteles con una ficha que contiene un atributo <content> opcional:

<?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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</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>

Definición de un hotel en el elemento <listings> de una lista de hoteles.

El elemento <listing> ocupa el siguiente lugar de la jerarquía XML del feed de la lista de hoteles:

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

Sintaxis

El elemento <listing> utiliza la siguiente sintaxis:

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

Atributos

El elemento <listing> no tiene atributos.

Elementos secundarios

El elemento <listing> tiene los siguientes elementos secundarios:

Elemento secundario ¿Es obligatorio? Tipo Descripción
<id> Obligatorio String Identificador único del hotel.
<name> Obligatorio String Nombre del hotel. Por ejemplo:

<name>Belgrave House</name>
<address> Obligatorio Object o String

La ubicación física completa del hotel.

Este elemento admite un único atributo, format, que debes definir como "simple".

Como mínimo, debes proporcionar la dirección postal, la ciudad, el estado o región, y el código postal del hotel. Utiliza los elementos secundarios <component> para describir cada una de las siguientes partes de la dirección:

  • addr1: la dirección postal principal del hotel.
  • addr2: la dirección postal secundaria, si corresponde.
  • addr3: una tercera parte de la dirección postal, si corresponde.
  • city: el nombre de la ciudad del hotel.
  • province: el nombre del estado, de la región o de la provincia del hotel.
  • postal_code: el código postal del hotel.

Por ejemplo:


<address format="simple">
  <component name="addr1">666 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>

También puedes proporcionar una dirección con formato libre, aunque no es recomendable. Por ejemplo:


<address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>

No se consideran direcciones físicas ni los apartados de correos ni las direcciones que solo reciben correspondencia.

<country> Obligatorio String El país en el que se encuentra esta ficha. El valor debe ser un código ISO 3116 de país de dos letras mayúsculas. Por ejemplo: Estados Unidos es "US" y Canadá es "CA". Por ejemplo:

<country>US</country>
<latitude> Obligatorio* Float Latitud que corresponde a la ubicación de la ficha. Por ejemplo:

<latitude>37.423738</latitude>

Este valor se puede generar con herramientas de geocodificación como la API de Google Maps.

<longitude> Obligatorio* Float Longitud que corresponde a la ubicación de la ficha. Por ejemplo:

<longitude>-122.090101</longitude>

Este valor se puede generar con herramientas de geocodificación como la API de Google Maps.

<location_precision> Opcional Integer Precisión de la ubicación de la propiedad enviada en metros cuando la latitud y la longitud de la propiedad se ofuscan. Cero (0) significa que no hay ofuscación y que es la ubicación exacta. Nota: Este elemento solo se aplica a Alquileres vacacionales.
<phone> Obligatorio* String

Uno o varios números de contacto del hotel. Si la ficha es de una sucursal, indica el número de teléfono del establecimiento en cuestión, no el de la sede central.

El atributo type puede ser uno de los siguientes:

  • fax: número de fax.
  • main: número de teléfono principal.
  • mobile: número de móvil.
  • tdd: número de dispositivo de telecomunicaciones para sordos (TDD).
  • tollfree: número de teléfono gratuito.

Por ejemplo:


<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

Como mínimo, debes indicar un tipo main.

* Es obligatorio indicar un número de teléfono o la latitud/longitud del hotel; preferiblemente, ambos
<category> Opcional String El tipo de propiedad, como un hotel. Los partners pueden utilizar las categorías internas que tengan para describir su propiedad, como "hoteles de negocios", "resorts", "moteles" y similares.
<content> Opcional <content> Información opcional que se utiliza para crear la ficha, como una descripción, valoraciones y características de la propiedad.

Ejemplos

Dirección estructurada

El siguiente ejemplo corresponde a una lista parcial de hoteles con una dirección estructurada:

<?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">666 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>UK</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>

Dirección en formato libre

El siguiente ejemplo corresponde a una lista parcial de hoteles con una dirección de formato libre:

<?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>666 Acacia Ave, Floor 5, 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>

Contenido opcional

El siguiente ejemplo corresponde a una lista parcial de hoteles con una ficha que contiene un atributo <content> opcional:

<?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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</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>

Añade información sobre una ficha, como valoraciones y reseñas, servicios y otros detalles. El elemento <content> es opcional. En <content>, todos los elementos secundarios son opcionales.

El elemento <content> aparece en el siguiente lugar de la jerarquía XML del feed de la lista de hoteles:

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

Sintaxis

El elemento <content> utiliza la siguiente sintaxis:

<?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="air_conditioned">[No|Yes]</client_attr>
        <client_attr name="all_inclusive_available">[No|Yes]</client_attr>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="child_friendly">[No|Yes]</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="has_affiliated_golf_course">[No|Yes]</client_attr>
        <client_attr name="has_airport_shuttle">[No|Yes]</client_attr>
        <client_attr name="has_bar_or_lounge">[No|Yes]</client_attr>
        <client_attr name="has_beach_access">[No|Yes]</client_attr>
        <client_attr name="has_business_center">[No|Yes]</client_attr>
        <client_attr name="has_fitness_center">[No|Yes]</client_attr>
        <client_attr name="has_free_breakfast">[No|Yes]</client_attr>
        <client_attr name="has_hot_tub">[No|Yes]</client_attr>
        <client_attr name="has_laundry_service">[No|Yes]</client_attr>
        <client_attr name="has_restaurant">[No|Yes]</client_attr>
        <client_attr name="has_room_service">[No|Yes]</client_attr>
        <client_attr name="has_spa">[No|Yes]</client_attr>
        <client_attr name="hotel_brand">hotel_brand</client_attr>
        <client_attr name="kitchen_availability">[Available in all rooms|Available in some rooms|
          Not available]</client_attr>
        <client_attr name="number_of_rooms">rooms_per_unit</client_attr>
        <client_attr name="num_reviews">number_of_reviews</client_attr>
        <client_attr name="parking_type">[No payment required|Paid|Not available]</client_attr>
        <client_attr name="pets_allowed">[No|Yes]</client_attr>
        <client_attr name="rating">aggregate_rating</client_attr>
        <client_attr name="star_rating">[1|2|3|4|5]</client_attr>
        <client_attr name="smoke_free_property">[No|Yes]</client_attr>
        <client_attr name="swimming_pool_type">[Indoors|Outdoors|Indoors and outdoors|Not available]</client_attr>
        <client_attr name="wheelchair_accessible">[No|Yes]</client_attr>
        <client_attr name="wifi_type">[Not available|No payment required|Paid]</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>

Atributos

El elemento <content> no tiene atributos.

Elementos secundarios

El elemento <content> tiene los siguientes elementos secundarios:

Elemento secundario ¿Es obligatorio? Tipo Descripción
<text 
type=
"description">
Opcional Object

La página web asociada con la ficha del proveedor. Puede contener los siguientes elementos secundarios:

  • <link>: un enlace a la descripción. Incluye "http://" o
    "https://" en este elemento (opcional).
  • <title>: el título de la descripción (opcional).
  • <author>: el autor de la descripción (opcional).
  • <body>: el cuerpo de la descripción (obligatorio).
  • <date>: la fecha de la descripción (opcional).
  • Nota: Estos elementos deben aparecer en el orden anterior.

<review 
type=
"[editorial|user]">
Opcional <review>

Contiene una reseña de usuario o una reseña editorial sobre la ficha. Puedes añadir tantas como quieras y de cualquier tipo.

No es necesario que incluyas todas las reseñas de una propiedad en <listing>. Este elemento está pensado para publicar un grupo de reseñas que ilustren las características o la calidad de tu ficha.

<attributes> Opcional Object

Contiene elementos secundarios <client_attr> (o no) que proporcionan detalles sobre la propiedad. Los elementos secundarios utilizan la siguiente sintaxis:


<client_attr name="attribute_name">attribute_value<client_attr>

Para obtener una lista y una descripción de los elementos secundarios, consulta <attributes>.

Todos los elementos son opcionales <client_attr>.

Si hay un elemento secundario <website>, debe colocarse antes de cualquier elemento <client_attr>.

<image> Opcional Object Etiqueta repetida que contiene información detallada sobre las imágenes.

Ejemplo

El siguiente ejemplo corresponde a una lista parcial de hoteles que incluye el 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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</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 reseña de usuario o una reseña editorial. No es necesario incluir todas las reseñas de una ficha en <listing>. Este elemento está pensado para publicar un grupo de reseñas que ilustren las características o la calidad de tu ficha.

El elemento <review> aparece en el siguiente lugar de la jerarquía XML del feed de la lista de hoteles:

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

Sintaxis

El elemento <review> utiliza la siguiente sintaxis:

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

Atributos

El elemento <review> tiene los siguientes atributos:

Atributo ¿Es obligatorio? Descripción
type Obligatorio El tipo de reseña. Se debe configurar como uno de los siguientes valores:
  • editorial: reseña de un sitio web o de otra autoridad de revisión.
  • user: reseña de un usuario final.

Elementos secundarios

El elemento <review> tiene los siguientes elementos secundarios:

Elemento secundario ¿Es obligatorio? Tipo Descripción
<link> Opcional String Enlace a la reseña. Incluye "http://" o "https://" en este elemento.
<title> Opcional String Título de la reseña (exclusivo de las reseñas editoriales).
<author> Opcional String Autor de la reseña; por ejemplo, "Ana Gómez". También puede ser el nombre de un sitio web o de una publicación en los que aparece la reseña si no está acreditada.
<rating> Opcional String Número de punto flotante de 0 a 10 (ambos incluidos) que representan la puntuación de la reseña. Por ejemplo: "8.9".
<body> Opcional String Texto de la reseña. Este elemento no debe contener código HTML.
<date month="MM" day="DD" year="YYYY"/> Opcional Object Fecha de la reseña (exclusivo de las reseñas de usuarios), que debes especificar con los siguientes atributos de este elemento:
  • day: día del mes; por ejemplo, "3".
  • month: mes, donde 1 = enero; por ejemplo, "12".
  • year: año de cuatro dígitos; por ejemplo, "2018".

A modo de ejemplo, el 7 de junio del 2017 se escribe así:


<date month="6" day="7" year="2017"/>
<servicedate month="MM" day="DD" year="YYYY"/> Opcional Object Fecha en que el revisor visitó la ficha (exclusivo de las reseñas de usuarios). El formato es el mismo que el del elemento <date> anterior.

A modo de ejemplo, el 7 de junio del 2017 se escribe así:


<servicedate month="6" day="7" year="2017"/>

Ten en cuenta que <title> es un elemento secundario válido de <review> solo si el type de la reseña es editorial, y <date> solo es válido si type es user.

Ejemplo

El siguiente ejemplo corresponde a una lista parcial de hoteles con una ficha que contiene una reseña editorial y otra de usuario:

<?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="2017"/>
      </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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="star_rating">4</client_attr>
        <client_attr name="num_reviews">14</client_attr>
        <client_attr name="air_conditioned">Yes</client_attr>
        <client_attr name="has_beach_access">No</client_attr>
        <client_attr name="has_free_breakfast">Yes</client_attr>
        <client_attr name="has_spa">No</client_attr>
        <client_attr name="number_of_rooms">5</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
        <client_attr name="kitchen_availability">Available in all rooms</client_attr>
        <client_attr name="parking_type">No payment required</client_attr>
        <client_attr name="swimming_pool_type">Indoors</client_attr>
        <client_attr name="wifi_type">Paid</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>

Con la etiqueta <attributes>, se pueden describir los servicios de la propiedad y clasificar sus valoraciones y reseñas.

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

Nota: Todos los atributos son opcionales.

Elementos secundarios

Elemento secundario ¿Es obligatorio? Descripción
<website> Opcional Sitio web principal del hotel. Si está presente, debe colocarse antes de que aparezca el primer elemento <client_attr>. Ejemplo:

<website>https://hotel.example.com</website>
<client_attr name="attribute_name"> Opcional Otra característica o "atributo" de la propiedad que se puede especificar con un attribute_name compatible o con un attribute_name para alquileres vacacionales.

Valores del marcador de posición attribute_name

En la siguiente tabla se muestran los valores válidos de attribute_name en el elemento <client_attr name="attribute_name">.

Valores de attribute_name Descripción Valores de contenido válidos
air_conditioned Todas las habitaciones de esta propiedad disponen de aire acondicionado. Sí/No
all_inclusive_available Hay una tarifa que, aparte de la habitación, incluye comida y bebidas ilimitadas (incluidas las alcohólicas) durante la estancia del huésped. Sí/No
alternate_hotel_id Identificador alternativo de la propiedad. Es útil tener distintos ID si necesitas un identificador de propiedad para la información de tu feed y otro para tu motor de reservas. Cualquier valor de cadena
child_friendly La empresa dispone de una o varias funciones especiales para familias con niños, como tarifas reducidas, cunas o camas de tamaño infantil, club infantil, servicio de canguro o centro de entretenimiento para los más pequeños. Sí/No
custom_[0-4] Cualquier atributo personalizado de tipo cadena. No se mostrarán a los usuarios, pero se pueden utilizar para agrupar hoteles en campañas de Google Ads. Hay cinco campos de este tipo que se pueden utilizar de esta forma, pero no son intercambiables. Por ejemplo, un hotel con custom_0 = "Centro de la ciudad" no se agrupará con un hotel con custom_4 = "City Center". Cualquier valor de cadena
has_affiliated_golf_course Este hotel cuenta con un campo en sus instalaciones o en las inmediaciones, en el que se ofrecen reservas iniciales y transporte de entrada y salida de huéspedes. A menudo, se aplica una tarifa por utilizar el campo de golf. Sí/No
has_airport_shuttle El hotel ofrece servicio de traslado al aeropuerto gratuito o de pago. Puede ser un servicio de transporte con parada en varios hoteles siempre que tenga una parada explícita en el hotel. Sí/No
has_bar_or_lounge El hotel cuenta con un bar o salón interior o exterior donde se sirven bebidas alcohólicas. Los huéspedes no tienen que salir de las instalaciones para llegar a él. Sí/No
has_beach_access Esta propiedad tiene una playa a la que se puede acceder directamente sin tener que cruzar una carretera pública. Sí/No
has_business_center El hotel dispone de una sala con ordenador, acceso a Internet y una impresora disponible para los huéspedes que necesitan un espacio de trabajo gratuito o de pago para desarrollar sus negocios. Sí/No
has_fitness_center El hotel dispone de un gimnasio al que los huéspedes pueden acceder sin salir de las instalaciones. Sí/No
has_free_breakfast El hotel ofrece desayuno gratuito a todos los huéspedes todos los días de la semana, independientemente del precio de las habitaciones. Si el hotel tiene una tarifa que incluye el desayuno y otra que no lo incluye, debes indicar el valor de false para este atributo. Sí/No
has_hot_tub Algunas o todas las habitaciones de los huéspedes cuentan con bañera de hidromasaje, o el hotel tiene bañera de hidromasaje en las instalaciones. Se puede aplicar un suplemento por la bañera de hidromasaje. Sí/No
has_laundry_service Los huéspedes pueden dejar su ropa para lavar en la recepción o en las habitaciones y se dejará limpia en sus habitaciones. Este servicio puede suponer un cargo adicional. Las lavanderías de autoservicio no cuentan. Sí/No
has_restaurant El hotel dispone de un restaurante interior o uno exterior en las instalaciones. Los huéspedes no tienen que salir de las instalaciones para llegar a él. Sí/No
has_room_service La comida se cocina en las instalaciones y se entrega directamente a las habitaciones. El servicio de habitaciones puede tener un horario limitado y conllevar un cargo adicional. Sí/No
has_spa El hotel cuenta con un spa que ofrece uno o varios de los siguientes servicios gratuitos o de pago: masajes, sauna y tratamientos faciales. Los huéspedes no tienen que salir de las instalaciones para acceder al spa. Sí/No
hotel_brand Marca a la que pertenece el hotel; por ejemplo, "Mariott" o "Hilton". Aunque no se mostrará a los usuarios, podrás utilizarlo para agrupar hoteles y configurar iconos de hoteles en las campañas de Google Ads. Cualquier valor de cadena
kitchen_availability Hay cocinas disponibles para que los huéspedes puedan preparar comidas calientes y guardar los alimentos en la nevera de sus habitaciones.
  • Disponible en todas las habitaciones
  • Disponible en algunas habitaciones
  • No disponible
number_of_rooms Este campo indica el número total de unidades asociadas con el ID de ficha. Nota: Este número no representa el precio por unidad de reserva en función de los datos del feed de precios y de inventario. Cualquier número entero no negativo.
num_reviews Número de reseñas de la ficha. Cualquier número entero no negativo.
parking_type Indica si hay aparcamiento disponible y si es gratuito o de pago.
  • No se requiere ningún pago
  • De pago
  • No disponible
pets_allowed Algunas o todas las habitaciones admiten mascotas (perros o gatos que no sean animales de servicio). Sí/No
rating Número de punto flotante que representa la valoración total de la propiedad. Este número suele estar entre 0 y 5, 0 y 10 o 0 y 100, pero puedes usar cualquier sistema de puntuación.
smoke_free_property No está permitido fumar en toda la propiedad. Sí/No
star_rating Número de estrellas que se han dado a la ficha a través de una organización de valoración. 1, 2, 3, 4, 5.
swimming_pool_type Indica si hay una piscina disponible en la propiedad y, de ser así, el tipo de piscina.
  • Cubierta
  • Exterior
  • Cubierta y exterior
  • No disponible
wheelchair_accessible Las personas que se desplazan en silla de ruedas pueden acceder a esta propiedad. Sí/No
wifi_type Indica si la propiedad ofrece un servicio de Internet inalámbrico (Wi‑Fi) en todas las secciones de la propiedad, no solo en una zona concreta. Puede ser gratuito o conllevar un cargo adicional.
  • No se requiere ningún pago
  • De pago
  • No disponible

Valores del marcador de posición attribute_name para alquileres vacacionales

A continuación se muestra una lista de valores válidos para attribute_name en el elemento <client_attr name="attribute_name">, aunque se recomienda que los partners proporcionen cualquier attribute_name adicional que tengan. Estos valores solo se aplican a las propiedades de alquileres vacacionales.

Valores de attribute_name ¿Es obligatorio? Descripción Valores de contenido válidos
capacity Obligatorio Número máximo de huéspedes que puede alojar la propiedad. Entero no negativo
min_days_between_stays Opcional (muy recomendable) El número mínimo de "días de margen" que debe estar vacío el alojamiento tras la salida de los huéspedes anteriores. Entero no negativo
enhanced_cleaning_practices Opcional (muy recomendable) Indica si la propiedad adopta prácticas de limpieza mejoradas (con una descripción en el sitio web del partner). Sí/No
partner_hygiene_link Opcional (muy recomendable) Enlace al sitio web de un partner externo que facilita más información sobre las medidas de higiene de la ficha de empresa. Texto libre (la URL del sitio web)
number_of_bathrooms Opcional (muy recomendable) Número de baños. Valor flotante no negativo; por ejemplo, 1, 1,5 o 2
number_of_bedrooms Opcional (muy recomendable) Número de habitaciones. Entero no negativo
number_of_beds Opcional (muy recomendable) Número de camas (en todas las habitaciones). Entero no negativo
self_checkin_checkout Opcional (muy recomendable) Indica si la propiedad permite registrarse en la propiedad de forma autónoma y salir de ella del mismo modo el último día Sí/No
rating_num Opcional (muy recomendable) Número de valoraciones que tiene la propiedad. Entero no negativo
ac Opcional Indica si la propiedad tiene aire acondicionado. Sí/No
airport_shuttle Opcional Indica si el alojamiento ofrece transporte del/al aeropuerto u otras terminales. Sí/No
balcony Opcional Indica si la propiedad incluye balcón. Sí/No
beach_access Opcional Indica si la propiedad tiene acceso a una playa pública cercana. Sí/No
cancellation_policy Opcional Texto libre con detalles sobre la política de cancelación. Texto libre
cancellation_policy_type Opcional

Facilita cualquier tipo de nombres de políticas y nosotros te ayudaremos a asociarlos con los sugeridos por Google. Si proporcionas tipos personalizados, limítate a unas cinco categorías y manda las descripciones correspondientes a tu gestor de cuentas.

Tipos de política de cancelación sugeridos que aceptan los alojamientos:

  • Sin reembolso: no se ofrecen reembolsos por ningún motivo ni dentro de ningún plazo.
  • Estricto: las reservas canceladas al menos 60 días antes del inicio de la estancia recibirán un reembolso completo.
  • Firme: las reservas canceladas al menos 60 días antes del inicio de la estancia recibirán un reembolso completo, y las canceladas al menos 30 días antes, un 50 % de reembolso.
  • Moderado: las reservas canceladas al menos 30 días antes del inicio de la estancia recibirán un reembolso completo, y las canceladas al menos 14 días antes, un 50 % de reembolso.
  • Relajado: las reservas canceladas al menos 14 días antes del inicio de la estancia recibirán un reembolso completo, y las canceladas al menos 7 días antes, un 50 % de reembolso.
Relajado, moderado, firme, estricto o sin reembolso
check_in_time Opcional Horas de registro en la propiedad. Texto libre
check_out_time Opcional Horas exactas de salida de la propiedad. Texto libre
child_friendly Opcional Indica si la propiedad es adecuada para niños. Sí/No
crib Opcional Indica si la propiedad dispone de cunas. Sí/No
elevator Opcional Indica si la propiedad tiene ascensor. Sí/No
fire_place Opcional Indica si la propiedad incluye chimenea. Sí/No
free_breakfast Opcional Indica si la propiedad ofrece desayuno gratuito. Sí/No
gym_fitness_equipment Opcional Indica si la propiedad cuenta con gimnasio o material deportivo. Sí/No
heating Opcional Indica si la propiedad dispone de calefacción.
hot_tub Opcional Indica si la propiedad cuenta con bañera de hidromasaje. Sí/No
instant_bookable Opcional Indica si la propiedad se reserva nada más hacer el pago o si hay que esperar a que se apruebe la solicitud. Sí/No
ironing_board Opcional Indica si la propiedad tiene tablas de planchar disponibles. Sí/No
kitchen Opcional Indica si la propiedad dispone de cocina. Sí/No
license_num Opcional Número de licencia (de turista o empresa) que debe estar visible en las propiedades de determinadas regiones del mundo. Puede estar repetido y, si hay varios, recomendamos añadir los datos de expedición para dar contexto (por ejemplo, "París: 123456ABC"). Texto libre
microwave Opcional Indica si la propiedad dispone de microondas. Sí/No
minimum_days_advance_purchase Opcional Número mínimo de días de antelación durante los que se puede reservar la propiedad. Entero no negativo
minimum_night_stay Opcional Número mínimo de noches que se puede reservar la propiedad. Entero positivo (más de cero)
max_night_stay Opcional Número máximo de noches que se puede reservar la propiedad. Entero positivo (más de cero)
number_of_living_rooms Opcional Número de salas de estar. Entero no negativo
outdoor_grill Opcional Indica si la propiedad cuenta con asador. Sí/No
oven_stove Opcional Indica si la propiedad dispone de estufa. Sí/No
parking_type Opcional Tipo de aparcamiento disponible en la propiedad. Gratis, de pago o ninguno
patio Opcional Indica si la propiedad incluye patio. Sí/No
pets_allowed Opcional Algunas o todas las habitaciones admiten mascotas (perros o gatos que no sean animales de servicio). Sí/No
pool_type Opcional Tipo de piscina (o de acceso a la piscina) de la propiedad. Cubierta, exterior, cubierta y exterior, o ninguna
private_beach_access Opcional Indica si la propiedad ofrece acceso exclusivo a una playa no pública. Sí/No
room_type Opcional Tipo de propiedad que se comparte con Google.
Nota: Por el momento, solo se acepta todo el sitio.
Todo el sitio, habitación compartida o habitación privada
smoking_free_property Opcional Indica si está prohibido fumar en la propiedad. Sí/No
square_footage Opcional Superficie de la propiedad en metros cuadrados. Valor flotante no negativo
tv Opcional Indica si la propiedad tiene televisión. Sí/No
washer_dryer Opcional Indica si la propiedad dispone de electrodomésticos de lavandería. Sí/No
wheelchair_accessible Opcional Indica si la propiedad es accesible para personas en sillas de ruedas. Sí/No
wifi_type Opcional Tipo de acceso a Internet con Wi‑Fi de la propiedad Gratis, de pago o ninguno
host_language Opcional Idiomas que se hablan en el alojamiento. Una lista de códigos de idioma separados por comas (por ejemplo, de,en)

Ejemplo de alquiler vacacional

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">Detailed Address</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <location_precision>500<location_precision>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">Yes</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="cancellation_policy">50% deposit returnable before 4 weeks of arrival date, 100% refundable before 8 weeks of arrival</client_attr>
        <client_attr name="cancellation_policy_type">Moderate</client_attr>
        <client_attr name="check_in_time">3pm</client_attr>
        <client_attr name="check_out_time">11am</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Yes</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Yes</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">Yes</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">Yes</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Yes</client_attr>
        <client_attr name="refund_policy">Cancellations made after 48 hours but before 24 hours prior to checkin will received a 50% refund</client_attr>
        <client_attr name="room_type">Entire Place</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>

<image>

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

Las imágenes se utilizan para mostrar cómo es la propiedad en el ID de la ficha. Deben cumplir los siguientes requisitos:

  • La relación de aspecto recomendada es de 4:3.
  • El rastreador de imágenes del robot de Google debe poder acceder a las URL de las imágenes.
  • Si tu sitio web incluye un archivo robots.txt a nivel de raíz, comprueba que permita una de estas dos acciones:
    1. Que el rastreador del robot de Google rastree el contenido de tu sitio web, incluidas las imágenes.
      • User‑agent: Googlebot
      • Permitir: /
    2. Que el rastreador de imágenes del robot de Google rastree las imágenes de tu sitio web.
      • User‑agent: Googlebot‑Image
      • Permitir: /
  • No se permite hacer capturas de pantalla de imágenes ni de sitios web. Las imágenes o fotografías que se usen deben ser originales y reales.

Atributos

Nombre del atributo ¿Es obligatorio? Formato Descripción
type Obligatorio Texto

Clasificación de las imágenes:

  • "anuncio", si son anuncios
  • "carta", si son cartas de restaurante
  • "foto", si son fotos del establecimiento
url Obligatorio Texto URL de la imagen a tamaño completo. Utiliza el atributo de URL para especificar la imagen que se utilizará en esa página.
width Obligatorio Entero no negativo Anchura de la imagen, en píxeles (se recomienda una resolución superior a 720 píxeles)
height Obligatorio Entero no negativo Altura de la imagen en píxeles (se recomienda una resolución superior a 720 píxeles).

Elementos secundarios

Elemento secundario ¿Es obligatorio? Descripción
<link> Solicitado, pero obligatorio en las fichas de fotos locales. Esta etiqueta contiene la URL válida y actualizada de la página en la que se encuentra la imagen correspondiente de tu sitio web. No incluye la URL de la propia imagen. Ejemplo:

<link><http://www.example.com/magic_pizza/></link>
<title> Solicitado Esta etiqueta contiene el título de la imagen. Ejemplo:

<title>"Luxury Apartment"</title>
<author> No obligatorio Esta etiqueta contiene el nombre del autor del contenido. Dicho valor puede ser un nombre de usuario o un nombre completo con el formato "Nombre Apellidos".
<date> Obligatorio

Esta etiqueta identifica la fecha en la que se creó el elemento de contenido. Debes introducir un año, un mes y un día, como en el siguiente ejemplo:


<date month="6" day="7" year="2017"/>

Ejemplo

El siguiente ejemplo corresponde a una lista parcial de hoteles con etiquetas de imagen:

<?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="2017"/>
      </image>
    </content>
  </listing>
  ...
</listings>

Directrices de sintaxis

Cuando crees una lista de hoteles basada en XML, sigue estas directrices:

  • Valida los archivos XML de tu lista de hoteles con el esquema XSD de Google.
  • Utiliza la codificación UTF‑8. Especifica este esquema de codificación incluyendo el atributo encoding en la etiqueta XML, como se muestra en los ejemplos que aparecen más abajo.
  • Los datos de los feeds se pueden especificar con secciones CDATA. Si utilizas secciones CDATA, no apliques caracteres de escape a los caracteres especiales.
  • Usa códigos de escape para los valores de datos que no estén en las secciones CDATA, incluidas las URL. Puedes usar tanto el código de entidad como el de caracteres para representar estos caracteres especiales.

    En la siguiente tabla se enumeran los códigos de entidades y de caracteres habituales que puedes utilizar:

    Carácter Entidad Código de carácter
    Signo et (&) &amp; &#38;
    comillas simples (') &apos; &#39;
    Comillas dobles (") &quot; &#34;
    Mayor que (>) &gt; &#62;
    Menor que (<) &lt; &#60;
  • Omite elementos XML que no contengan datos. Por ejemplo, si no tienes la latitud y la longitud de un hotel, no incluyas los elementos <latitude/> y <longitude/> vacíos.
  • No utilices código HTML en los elementos XML bajo ninguna circunstancia (aunque sea con escape).
  • Para validar tu feed antes de subirlo, puedes utilizar el feed local XSD "https://www.gstatic.com/localfeed/local_feed.xsd".
  • Para utilizar los comentarios en el feed, envuélvelos con las etiquetas <!-- y -->, tal como se muestra en el siguiente ejemplo:

    <!-- This is a comment -->
  • Asegúrate de cerrar el elemento <date> en un usuario <review>. Por ejemplo:

    <date day="2" month="12" year="2017"/>

Identificar y corregir problemas con los datos

Para detectar y solucionar los problemas que puedan surgir con los datos de tu lista de hoteles, puedes utilizar las siguientes herramientas:

Hotel Center: