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
ywebsite
. 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.
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, 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
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>