Atributos

En esta página, se abordan 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 XML general tiene un formato similar al de los feeds de fichas de hoteles. Consulta la Referencia de XML para las listas de hoteles.

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

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

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

Para obtener más información sobre el programa de Alquileres de vacaciones, consulta Atributos únicos del programa de 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 de una ficha de alquiler de vacaciones, muestra el valor de la ficha. Por ejemplo, si, a partir de las fotos de una ficha, Google determina que tiene una cocina, pero el atributo kitchen está ausente o se estableció en No, Google considerará que la ficha tiene una cocina. Estos atributos se denominan "atributos inferidos", y solo se muestran cuando se puede confiar en la precisión de la inferencia.

Punto clave: En el caso de los alquileres de vacaciones, las comodidades se proporcionan a través de los atributos del feed de lista de hoteles.

Valores del marcador de posición attribute_name

En la siguiente tabla, se proporciona una lista de valores válidos para attribute_name en el elemento <client_attr name="attribute_name">. Sin embargo, te recomendamos que proporciones los attribute_name adicionales si están disponibles.

Valores de attribute_name	¿Obligatorio?	Descripción	Valores de contenido válidos
capacity	Required	La cantidad máxima de huéspedes que pueden alojarse en la propiedad. Este valor debe ser igual o mayor que "number_of_rooms".	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 del socio externo con más información sobre los detalles de mantenimiento 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 registrar entrada y salida de autoservicio.	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	La cantidad de calificaciones que tiene la propiedad.	Non-negative integer value
rating_scale	Strongly recommended	Calificación máxima posible para una propiedad	Non-negative integer value
instant_bookable	Strongly recommended	Si la propiedad se puede reservar al instante a través del proceso de confirmación de la compra La alternativa es esperar la aprobación.	Yes/No/Unknown
description	Strongly recommended	Texto en formato libre en el que se describen las cualidades únicas de la propiedad	Free text
category	Strongly recommended	El tipo de propiedad, como casa de recreo, bungaló, cabaña o departamento	Free text
ac	Recommended	Si la propiedad tiene aire acondicionado.	Yes/No/Unknown
beach_access	Recommended	Indica si la propiedad tiene acceso a una playa pública cerca de ella.	Yes/No/Unknown
check_in_time	Recommended	Hora exacta del día para hacer el check-in en la propiedad. Se aceptan los formatos HHMM, HH:MM o HH:MM:SS. Por ejemplo, usa 14:00 en lugar de 2 p.m. o 2:00 p.m. No se analizarán ni se mostrarán los demás formatos.	Time
check_out_time	Recommended	Hora exacta del día para registrar 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:00 a.m. o 11:00 a.m. No se analizarán ni se mostrarán 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 un gimnasio o cualquier equipo de entrenamiento	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	La cantidad mínima de días de anticipación con los 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.	Positive integer (more than zero)
max_night_stay	Recommended	La cantidad máxima de noches que los huéspedes pueden reservar en 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 una 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 son animales de servicio).	Yes/No/Unknown
pool_type	Recommended	Tipo de grupo (acceso al grupo) que tiene la propiedad.	Indoors, Outdoors, Indoors/Outdoors, None
smoking_free_property	Recommended	Si la propiedad es libre de humo o no se permite fumar.	Yes/No/Unknown
special_service_level	Recommended	Si el nivel de servicio de la ficha es especial de alguna manera Por ejemplo, verified, luxury o 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	El tipo de acceso a Internet Wi-Fi que proporciona la propiedad.	Free/Paid/None
airport_shuttle	Optional	Indica si el host proporciona transporte desde o 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 host de alquiler de vacaciones.	Free text
host_language	Optional	Idiomas que habla el anfitrión	Una lista de códigos de idioma separados por comas; por ejemplo: de, en
host_name	Optional	Nombre del host del alquiler de vacaciones.	Free text
host_response_rate	Optional	Tasa de respuesta promedio del host.	Non-negative float value, for example, 1, 0.75, 0.5
host_response_time	Optional	Tiempo de respuesta promedio del host.	Free text
license_num	Optional	Es necesario mostrar el número de licencia (turista o comercial) para las propiedades en ciertas regiones del mundo. Podría repetirse y, si existen varias licencias, te sugerimos que agregues la autoridad 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 XML secundarios

Se requieren los siguientes elementos XML secundarios:

Elemento secundario	¿Obligatorio?	Tipo	Descripción
<country>	Strongly recommended	string	El país en el que se encuentra esta ficha. El valor debe ser un código de país ISO 3116 de 2 letras. 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 que nunca se debe volver a usar.
<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. 300 caracteres como máximo.
<address>	Required	Object or string	Es la ubicación física completa de la propiedad. Este elemento toma un solo atributo, format, que debes configurar como simple. Como mínimo, debes proporcionar la dirección, la ciudad, el estado o la región y el código postal de la propiedad. Usa elementos secundarios <component> para describir cada una de las siguientes partes de la dirección: addr1: Es la dirección principal de la propiedad. addr2: Es la dirección secundaria, incluido el número de unidad, si es necesario. addr3: Es una tercera parte de la dirección. city: Es el nombre de la ciudad de la propiedad. province: Es el nombre del estado, la región o la provincia de la propiedad. postal_code: Es el código postal de la propiedad. Por ejemplo: <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> Como alternativa, puedes proporcionar una dirección en "formato libre", aunque no se recomienda. Por ejemplo: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Ten en cuenta que los apartados postales y otras direcciones que solo se usan para recibir correo no se consideran direcciones físicas completas.

Ejemplo de ficha de alquileres 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>