Atributos

En esta página, se incluyen las descripciones, los valores y los requisitos de los atributos y los elementos secundarios. Estos valores solo se aplican a las propiedades de alquileres de vacaciones.

La estructura general del XML tiene un formato similar al de los feeds de fichas de hoteles. Consulta la referencia de XML para las listas de hoteles.

Si no se incluyen los siguientes elementos obligatorios, se inhabilitará automáticamente la ficha:

  • Elementos secundarios XML obligatorios: id, name, latitude, longitude y address.
  • Atributos obligatorios: capacity y website. Consulta los vínculos directos de alquileres de vacaciones en tu feed de fichas. Esto les brinda a los usuarios la oportunidad de visitar el sitio web de la propiedad.

Para obtener detalles sobre los elementos secundarios XML obligatorios, consulta Elementos secundarios XML.

Para obtener más información sobre los alquileres de vacaciones, consulta Atributos únicos de los alquileres de vacaciones.

Por último, cuando Google determina a partir de otras fuentes que el valor de un atributo es diferente del que se especifica en el feed para una ficha de alquiler de vacaciones, Google muestra el valor para la ficha. Por ejemplo, si Google determina a partir de las fotos de una ficha que tiene cocina, pero el atributo kitchen no está presente o se establece en No, Google considera que la ficha tiene cocina. Estos atributos se denominan "atributos inferidos" y solo se muestran cuando hay un alto nivel de confianza en la precisión de la inferencia.

<review>

Contiene una opinión de usuario o una opinión editorial. No es necesario que incluyas todas las opiniones de una ficha en tu elemento <listing>. Este elemento está diseñado para que incluyas opiniones seleccionadas que indiquen las características o la calidad de la ficha.

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

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

Sintaxis

El elemento <review> usa 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 Required Es el tipo de opinión. Se establece en uno de los siguientes valores:
  • editorial: Es una revisión realizada por un sitio web o alguna otra autoridad de revisión.
  • user: Es una opinión de un usuario final.

Elementos secundarios

El elemento <review> tiene los siguientes elementos secundarios:

Elemento secundario ¿Obligatorio? Tipo Descripción
<link> Optional string Es un vínculo a la opinión. Incluye "http://" o "https://" en este elemento.
<title> Optional string (Solo para opiniones editoriales) Es el título de la opinión.
<author> Optional string Autor de la opinión, por ejemplo, "Susan von Trapp". También puede ser el nombre de un sitio web o una publicación en la que aparece la opinión si no se atribuye.
<rating> Optional string Es un número de punto flotante del 0 al 10 (inclusive) que representa la puntuación de la opinión. Por ejemplo, "8.9".
<body> Optional string Es el texto de la opinión. Este elemento no debe contener HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Solo para opiniones de usuarios) Fecha de la opinión, que se especifica con los siguientes atributos de este elemento:
  • day: Día del mes; por ejemplo, "7".
  • month: El mes, donde 1 = enero… 12 = diciembre.
  • year: Año de cuatro dígitos; por ejemplo, “2023”.

Por ejemplo, el 7 de junio de 2023 se escribe de la siguiente manera:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Solo para opiniones de usuarios) Fecha en la que el usuario que escribió la opinión visitó la ficha sobre la que escribió la opinión. El formato es el mismo que <date>.

Por ejemplo, el 7 de junio de 2023 se escribe de la siguiente manera:

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

Es posible que no se muestren las opiniones en las que no se completaron, al menos, el mes y el año de <servicedate>. El día no es obligatorio.

Ejemplo

En el siguiente ejemplo, se muestra una lista parcial de hoteles con una ficha que contiene una revisión editorial y una revisión 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="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>

Valores para el marcador de posición attribute_name

En la siguiente tabla, se proporciona una lista de los valores válidos para attribute_name en el elemento <client_attr name="attribute_name">. Sin embargo, se recomienda que proporciones tu attribute_name adicional si está disponible.

Valores de attribute_name ¿Obligatorio? Descripción Valores de contenido válidos
capacity Required Cantidad máxima de huéspedes que puede alojar la propiedad. Este valor debe ser igual o mayor que "number_of_bedrooms". Non-negative integer value
website Required Es la URL del sitio web de la propiedad. Free text
partner_hygiene_link Strongly recommended Vínculo al sitio externo del socio que proporciona más información sobre los detalles de higiene de la ficha. Free text (the site's URL)
number_of_bathrooms Strongly recommended Cantidad de baños Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Cantidad de habitaciones Non-negative integer value
number_of_beds Strongly recommended Cantidad de camas en todas las habitaciones Non-negative integer value
self_checkin_checkout Recommended Indica si la propiedad permite el autorregistro de entrada y salida. Yes/No/Unknown
rating Strongly recommended Es un número de punto flotante que representa la calificación agregada de la propiedad. Este número suele ser de 0 a 5, de 0 a 10 o de 0 a 100, pero puedes usar cualquier rango que represente tu sistema de calificación. Non-negative float value
rating_num Strongly recommended Cantidad de calificaciones que tiene la propiedad. Non-negative integer value
rating_scale Strongly recommended Es la calificación máxima posible para una propiedad. Por ejemplo, la calificación de la propiedad debe ser 3 o 4 para una rating_scale de 5.

Nota: La escala de calificación predeterminada es de 0 a 10 si no se especifica.

Non-negative integer value
instant_bookable Strongly recommended Indica si la propiedad se puede reservar de forma instantánea a través del proceso de confirmación de compra. La alternativa es esperar la aprobación. Yes/No/Unknown
description Strongly recommended Texto de formato libre que describe las cualidades únicas de la propiedad Free text
category Strongly recommended El tipo de propiedad, como una casa de recreo, un bungaló, una cabaña o un departamento Free text
ac Recommended Si la propiedad tiene aire acondicionado. Yes/No/Unknown
beach_access Recommended Si la propiedad tiene acceso a una playa pública cercana. Yes/No/Unknown
check_in_time Recommended Hora exacta del día para registrar la entrada a la propiedad. Se aceptan los formatos HHMM, HH:MM o HH:MM:SS. Por ejemplo, usa 14:00 en lugar de las 2 p.m. o las 2:00 p.m. No se analizarán ni mostrarán todos los demás formatos. Time
check_out_time Recommended Hora exacta del día para la salida de la propiedad. Se aceptan los formatos HHMM, HH:MM o HH:MM:SS. Por ejemplo, usa 11:00 en lugar de 11 a.m. o 11:00 a.m. No se analizarán ni mostrarán todos los demás formatos. Time
child_friendly Recommended Si la propiedad es apta para niños. Yes/No/Unknown
crib Recommended Si la propiedad proporciona una cuna. Yes/No/Unknown
elevator Recommended Si la propiedad tiene ascensor. Yes/No/Unknown
gym_fitness_equipment Recommended Si la propiedad tiene gimnasio o equipos para hacer ejercicio. Yes/No/Unknown
heating Recommended Si la propiedad tiene calefacción. Yes/No/Unknown
hot_tub Recommended Si la propiedad tiene jacuzzi. Yes/No/Unknown
ironing_board Recommended Si la propiedad dispone de tabla de planchar. Yes/No/Unknown
kitchen Recommended Si la propiedad tiene cocina. Yes/No/Unknown
microwave Recommended Si la propiedad dispone de microondas. Yes/No/Unknown
min_days_advance_purchase Recommended Es la cantidad mínima de días de anticipación con la que se puede reservar la propiedad. Non-negative integer value
min_night_stay Recommended Es la cantidad mínima de noches que un huésped puede reservar la propiedad. Positive integer (more than zero)
max_night_stay Recommended Es la cantidad máxima de noches que un huésped puede reservar la propiedad. Positive integer (more than zero)
outdoor_grill Recommended Si la propiedad tiene parrilla. Yes/No/Unknown
oven_stove Recommended Si la propiedad tiene estufa. Yes/No/Unknown
parking_type Recommended Tipo de estacionamiento disponible en la propiedad. Free/Paid/None
patio Recommended Si la propiedad tiene patio. Yes/No/Unknown
pets_allowed Recommended Algunas o todas las habitaciones permiten que los huéspedes lleven mascotas (perros o gatos que no sean animales de servicio). Yes/No/Unknown
pool_type Recommended Tipo de piscina (acceso a la piscina) que tiene la propiedad. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended Es el tipo de habitación. ENTIRE_PLACE es el único valor admitido. ENTIRE_PLACE
smoking_free_property Recommended Si la propiedad es libre de humo o no se permite fumar. Yes/No/Unknown
special_service_level Recommended Indica si el nivel de servicio de la ficha es especial de alguna manera. Por ejemplo, verified, luxury, premium Yes/No/Unknown
square_footage Recommended Es el área de la propiedad en pies cuadrados. Non-negative float value
square_meters Recommended Es el área de la propiedad en metros cuadrados. Non-negative float
tv Recommended Si la propiedad tiene una TV. Yes/No/Unknown
washer_dryer Recommended Si la propiedad tiene electrodomésticos para el cuidado de la ropa. Yes/No/Unknown
wheelchair_accessible Recommended Si la propiedad tiene acceso para personas en silla de ruedas. Yes/No/Unknown
internet_type Recommended Tipo de acceso a Internet Wi-Fi que proporciona la propiedad. Free/Paid/None
airport_shuttle Optional Si el anfitrión brinda transporte desde y hacia el aeropuerto o alguna otra terminal. Yes/No/Unknown
balcony Optional Si la propiedad tiene balcón. Yes/No/Unknown
fire_place Optional Si la propiedad tiene chimenea. Yes/No/Unknown
free_breakfast Optional Indica si la propiedad tiene desayuno incluido. Yes/No/Unknown
host_description Optional Descripción del anfitrión del alquiler de vacaciones. Free text
host_language Optional Idiomas que puede hablar el organizador. Es una lista separada por comas de códigos de idioma, por ejemplo: de, en.
host_name Optional Nombre del anfitrión del alquiler de vacaciones. Free text
host_response_rate Optional Es la tasa de respuesta promedio del anfitrión. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Es el tiempo de respuesta promedio del anfitrión. Free text
license_num Optional Número de licencia (de turista o comercial) que se debe mostrar para alquilar propiedades en determinadas regiones del mundo. Este número puede repetirse por lo que, si dispones de varias licencias, te sugerimos que agregues la autoridad emisora de la licencia como contexto; por ejemplo: "París: 123456ABC". Free text
number_of_half_bathrooms Optional Cantidad de medios baños. Non-negative integer value
number_of_living_rooms Optional Cantidad de salas de estar. Non-negative integer value
private_beach_access Optional Si la propiedad tiene acceso exclusivo a una playa privada. Yes/No/Unknown
refund_policy Optional Es la política de reembolsos de la propiedad. Free text

Elementos secundarios XML

Se requieren los siguientes elementos secundarios XML:

Elemento secundario ¿Obligatorio? Tipo Descripción
<country> Strongly recommended string Es el país en el que se encuentra esta ficha. El valor debe ser un código de país de 2 letras según ISO 3116; por ejemplo, Estados Unidos es US y Canadá es CA: 
    <country>US</country>
<id> Required string Es el identificador único de la propiedad. Ten en cuenta que cada alquiler de vacaciones debe tener un ID único para tu sitio, y este ID nunca se debe reutilizar.
<latitude> Required float La 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> Required float La 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.
<name> Required string Es el nombre de la propiedad. Se admiten 300 caracteres como máximo.
<address> Required string or Object

Ubicación física completa de la propiedad como una cadena. La dirección debe incluir el nombre y el número de la calle. Si no existe ninguna, la dirección debe incluir un código plus. Si corresponde, también se deben incluir los números de departamento o unidad.

Como alternativa, puedes proporcionar una dirección "compuesta". Usa elementos secundarios <component> para describir cada una de las siguientes partes de la dirección:

  • addr1: Es la dirección principal.
  • addr2: Si es necesario, la dirección secundaria, incluido el número de unidad.
  • city: La ciudad.
  • province: Si es necesario, el estado, la región o la provincia.
  • postal_code: Código postal.
  • country: Es el país.

Ten en cuenta que los apartados postales y otras direcciones que solo se usan para recibir correo no se consideran direcciones físicas completas.

Estos son ejemplos de una dirección completa:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Estos son ejemplos de una dirección completa con un código plus:

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Evita lo siguiente:

  • Información redundante: No incluyas información irrelevante ni repitas los componentes de la dirección.
  • Falta la dirección de la calle: Las direcciones deben tener un nombre y un número de calle.

Ejemplo de ficha de alquiler de vacaciones

<?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">18733 Clark Way</component>
      <component name="addr2">#C10</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>
    <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>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</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/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="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</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="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</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">No</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="max_night_stay">7</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">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</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>