Atributos

En esta página, se detallan las descripciones, los valores y los requisitos de los atributos y 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 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, address.
  • Atributos obligatorios: capacity y website. Consulta los vínculos directos de los alquileres de vacaciones. en tu feed de ficha. Esto les da a los usuarios la oportunidad de visitar la propiedad sitio web.

Para conocer los detalles de los elementos secundarios XML obligatorios, consulta Archivos secundarios XML. elementos.

Para obtener más información sobre el programa de Alquileres de vacaciones, consulta Atributos únicos del Alquiler de vacaciones

Por último, cuando Google determina a partir de otras fuentes que el valor de un atributo es diferente de lo que se especifica en el feed para una ficha de alquiler de vacaciones, Google muestra de la ficha. Por ejemplo, si Google lo determina a partir de las fotos de una ficha que tiene una cocina, pero el atributo kitchen está ausente o se estableció en No. Google considera que la ficha es como si tuviera una cocina. Estos atributos se denominan “atributos inferidos”, y solo se muestran cuando el nivel de confianza en la exactitud 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, es 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 La cantidad máxima de huéspedes que pueden alojarse en la propiedad. Este valor debe ser igual o mayor que "cantidad_de_habitaciones". 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 que proporciona más información sobre el detalles sobre 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. Esta normalmente es de 0 a 5, de 0 a 10 o de 0 a 100, pero puede usar cualquier rango que representa 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 Si la propiedad tiene acceso a una playa pública cerca de la propiedad. Yes/No/Unknown
check_in_time Recommended Hora exacta del día para hacer el check-in en la propiedad. HHMM, HH:MM o HH:MM:SS formato aceptado; por ejemplo, usa 14:00 en lugar de 2 p.m. o 2:00 p.m. Todo otros formatos no se analizarán ni se mostrarán. Time
check_out_time Recommended Hora exacta del día para registrar la salida de la propiedad. HHMM, HH:MM o HH:MM:SS formato aceptado; por ejemplo, usa 11:00 en lugar de 11 a.m. o 11:00 a.m. Todo otros formatos no se analizarán ni se mostrarán. 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 traigan mascotas, como perros o gatos que no son animales de servicio, con ellos. 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 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 Si el anfitrión ofrece transporte desde o hacia el aeropuerto, o bien otro terminales. 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 separada por comas de idioma código de estado; 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 Se requiere un número de licencia (turista o comercial) para mostrar las propiedades en ciertas regiones del mundo. Podría repetirse y, si hay varios existen licencias, sugerimos agregar 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 ISO 3116 Código de país de 2 letras por ejemplo, el estado de 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 todos los alquileres de vacaciones debe tener un ID que sea exclusivo de tu sitio, y este ID nunca debe reutilizados.
<latitude> Required float La latitud que corresponde a la ubicación de la ficha. Para 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. Para 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 string or Object

Es la ubicación física completa de la propiedad como una cadena. La dirección debe incluir el nombre y número de la calle. Si no existe ninguno, la dirección debe incluir un Plus Code. Si corresponde, también debes incluir el número de departamento o unidad.

De forma alternativa, puedes proporcionar un valor “compuesto” web. Usar <component> hijo o hija elementos 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: Es la ciudad.
  • province: Si es necesario, indica el estado, la región o la provincia.
  • postal_code: Es el código postal.
  • country: Es el país.

Ten en cuenta que los apartados casillas u otras direcciones de correo postal no se como direcciones físicas completas.

Estos son ejemplos de una dirección completa:

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>

<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

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

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>

<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

Evita lo siguiente:

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

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>