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 en formato 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 incluyes los siguientes elementos obligatorios, la ficha se inhabilita automáticamente:

  • 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 exclusivos 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 de una ficha de alquiler de vacaciones, muestra el valor de la ficha. Por ejemplo, si Google determina a partir de las fotos de una ficha que tiene una cocina, pero el atributo kitchen no está presente o está configurado como No, Google considera que la ficha tiene una cocina. Estos atributos se denominan "atributos inferidos" y solo se muestran cuando hay una alta confianza en la precisión de la inferencia.

Valores para el 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 para attribute_name ¿Obligatorio? Descripción Valores de contenido válidos
capacity Required Es la 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 Es un vínculo al sitio externo de un 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 Si la propiedad permite el autorregistro de entrada y de salida. 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 está entre 0 y 5, 0 y 10, o 0 y 100, pero puedes usar cualquier rango que represente tu sistema de calificación. Non-negative float value
rating_num Strongly recommended Es la 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 escala de calificación de 5.

Nota: Si no se especifica, la escala de calificación predeterminada es de 0 a 10.

Non-negative integer value
instant_bookable Strongly recommended 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 villa, 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 de entrada a la propiedad Se acepta el formato 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 mostrarán todos los demás formatos. Time
check_out_time Recommended Hora exacta de salida de la propiedad Se acepta el formato 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 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 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 traigan mascotas, como 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 Es el tipo de acceso a Internet por Wi-Fi que ofrece la propiedad. Free/Paid/None
airport_shuttle Optional Si el anfitrión brinda 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 gratuito incluido. Yes/No/Unknown
host_description Optional Descripción del anfitrión del alquiler de vacaciones. Free text
host_language Optional Idiomas que habla el anfitrión. Es una lista separada por comas de códigos de idioma, 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 Es el tiempo de respuesta promedio del host. Free text
license_num Optional El 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 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 la ficha. El valor debe ser un código de país de 2 letras según ISO 3166. 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 este ID nunca debe reutilizarse.
<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 string or Object

Es la 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, 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 "compleja". 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: Es la ciudad.
  • province: Si es necesario, 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 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: 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>