Atributos

En esta página, se describen 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.

Para obtener información sobre los elementos secundarios XML obligatorios, consulta Elementos secundarios XML.

Para obtener más información sobre el programa de Alquileres de vacaciones, consulta Atributos exclusivos del programa.

Por último, cuando Google determine, 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, mostraremos el valor de la ficha. Por ejemplo, si a partir de las fotos de una ficha determinamos que tiene una cocina, pero el atributo kitchen no está presente o se estableció en No, la trataremos como si tuviera cocina. Estos atributos se denominan "atributos inferidos" y solo se mostrarán cuando tengamos certeza de 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, te recomendamos 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 la propiedad puede albergar. 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 externo del socio en el que se proporciona 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 el registro de entrada y salida automáticos. Yes/No/Unknown
rating Strongly recommended Es un número de punto flotante que representa la calificación agregada de la propiedad. Por lo general, este número va del 0 al 5, del 0 al 10 o del 0 al 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 Calificación máxima posible para una propiedad Non-negative integer value
instant_bookable Strongly recommended Si la propiedad se puede reservar instantáneamente a través del proceso de confirmación de la compra. La alternativa es esperar a que se apruebe. Yes/No/Unknown
description Strongly recommended Texto en formato libre que describe las cualidades únicas de la propiedad Free text
category Strongly recommended El tipo de propiedad, como una 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 La hora exacta del día para el registro de entrada a la propiedad. Se aceptan los formatos HHMM, HH:MM o HH:MM:SS. Por ejemplo, usa el formato 14:00 en lugar de 2 p.m. o 2:00 p.m. Los demás formatos no se analizarán ni se mostrarán. Time
check_out_time Recommended Hora exacta del día para registrar la salida en 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. Los demás 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
minimum_days_advance_purchase Recommended Es la cantidad mínima de días de anticipación con los que se puede reservar la propiedad. Non-negative integer value
minimum_night_stay Recommended Cantidad mínima de noches que un huésped puede reservar la propiedad. Positive integer (more than zero)
max_night_stay Recommended 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 traigan mascotas (como perros o gatos que no sean animales de servicio). Yes/No/Unknown
pool_type Recommended El 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 y premium. Yes/No/Unknown
square_footage Recommended El área de la propiedad en pies cuadrados. Non-negative float value
square_meters Recommended 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 Es el tipo de acceso a Internet Wi-Fi que proporciona la propiedad. Free/Paid/None
airport_shuttle Optional 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 Si la propiedad tiene desayuno incluido Yes/No/Unknown
host_description Optional Descripción del anfitrión de alquileres 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 Es el nombre del anfitrión 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 el número de licencia (turista o empresarial) que debe mostrarse para las propiedades en determinadas regiones del mundo. Podría repetirse y, si existen varias 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 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 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 exclusivo de 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

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: Indica 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, región o provincia de la propiedad.
  • postal_code: 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 solo 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="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="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="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="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="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>