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 alquiler de vacaciones.

La estructura general del XML tiene un formato similar al de los feeds de fichas de hotel. Consulta la referencia de XML de la lista de hoteles.

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

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

<review>

Contiene una opinión de usuario o una opinión editorial. No es necesario que incluyas todas las opiniones de una ficha en tu elemento <listing>. Este elemento está diseñado para que incluyas opiniones seleccionadas que sean indicativas de las características o la calidad de esta ficha.

El elemento <review> aparece en el siguiente lugar de la jerarquía del XML del feed de la lista de hoteles:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

Sintaxis

El elemento <review> usa la siguiente sintaxis:

<?xml version="1.0" encodin>g<="UTF-8&>quo<t;?
lis>tings< ... 
 > listing
    cont<ent
      ..<.
    >  !-- Specify review's child elements in t>he orde<r shown below. --
     > review t<ype=>"edito<rial&>quot;
   <     >linkreview_l<ink/li>n<k
        titlereview_title/title !-- Title is for r>eviews of< type >"editori<al">; only --<
     >   authorrevi<ew_auth>or/author<
   >     rating<revie>w_rating/<rati>ng
        <bodyr>eview_tex<t/body
    >    datereview_dat<e/date
     >   serv<icedate>review_<servicedate/servic>edate
   <   <>/span>/review
    <  review type=<">user"
  <      <>/span>linkreview<_link/link
        authorreview_autho>r/<author
        date month="MM" day=&>quot;DD&q<uot; year="YYYY&quot;/  !-- Date is for> r<eviews of type "user" only --
        servic>edate mon<th=&qu>ot;MM" d<ay=&quo>t;DD"<; ye>ar="YY<YY&qu>ot;/  !<-- Serv>ice D<ate is f>or <reviews >o<f type &q>uot;user" only --
        ratingreview_rating/rating
        bodyreview_text/body
      /review
    /content
  /listing
/listings

Atributos

El elemento <review> tiene los siguientes atributos:

Atributo ¿Es obligatorio? Descripción
type Required Es el tipo de opinión. Configúralo en uno de los siguientes valores:
  • editorial: Es una revisión de un sitio web o de otra autoridad de revisión.
  • user: Es una opinión de un usuario final.

Elementos secundarios

El elemento <review> tiene los siguientes elementos secundarios:

Elemento secundario ¿Obligatorio? Tipo Descripción
<link> Optional string Es un vínculo a la opinión. Incluye "http://" o "https://" en este elemento.
<title> Optional string (Solo para opiniones editoriales) Es el título de la opinión.
<author> Optional string Autor de la opinión; por ejemplo, "Susan von Trapp". También puede ser el nombre de un sitio web o una publicación en la que aparece la opinión si no se atribuye.
<rating> Optional string Es un número de punto flotante del 0 al 10 (inclusive) que representa la puntuación de la opinión. Por ejemplo, "8.9".
<body> Optional string Es el texto de la opinión. Este elemento no debe contener HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Solo para opiniones de usuarios) Fecha de la opinión, que se especifica con los siguientes atributos de este elemento:
  • day: Día del mes; por ejemplo, "7".
  • month: Es el mes, donde 1 = enero… 12 = diciembre.
  • year: Año de cuatro dígitos; por ejemplo, “2023”.

Por ejemplo, el 7 de junio de 2023 se escribe de la siguiente manera:

<date month="6" day=">7" year="2023"/
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Solo opiniones de usuarios) Fecha en la que el usuario que escribió la opinión visitó la ficha sobre la que escribió la opinión. El formato es el mismo que <date>.

Por ejemplo, el 7 de junio de 2023 se escribe de la siguiente manera:

<servicedate month="6" day=">7" year="2023"/

Es posible que no se muestren las opiniones en las que no se completaron, al menos, el mes y el año de <servicedate>. El día no es obligatorio.

Ejemplo

En el siguiente ejemplo, se muestra una lista parcial de hoteles con una ficha que contiene una revisión editorial y una revisión de usuario:

<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
  la<ngu>ageen</lan>guage
  list<ing
 >   id<123456/id
    nameMy Ap>artment</name
    address form>at="simple"<;
      co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
      component name=&q>uot;c<ity"L>os Ange<les/component
      compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
   <   component name<="pr>ovinc<e"CA>/component<
    /addr>ess
 <   country>US/country
    <latitu>de40.<730610/l>atitu<de
    lo>n<gitude-73.935242/longitude
    phone type="main"123>45678</phone
>    cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
>    conte<nt
  >    text type="descrip<tion&q>uot;
    <    >linkhttps://examplelisting.com/listings/12345/link
     <   title3 bedr<ooms with ocean views/title
        >bodySta<y in >this ne<wly renovated 3BR house> with oce<an v>iews./body
        date month=<">;7" <day=&>quot;23" year="<;2023&>quot;/
  <    /text
      r<eview t>ype="<;edito>r<ial&quo>t;
      <  linkhttps://example.com/revi<ews/4>2/link
<       > titleA< little piece of h>eaven/tit<le
 >       authorEXAMPLE.COM/author
    <    <>/span>rating8/ra<ting
 >       bodyThis< place >is really< good.>/<body
  >    /revi<ew
 >     review type="user"
        linkhttps://ex<ample>person.or<g/reviews/82/link
        authorSus>an von Tr<app/author
        rating6/rating
        b>odyNot <a bad p>lace, b<ut I prefe>r to be c<loser t>o the beach./body
       < date da>y="6<" month="7">; y<ear="20>23"/<
        servicedate day=">;1<6" mont>h="<;6" ye>ar=&quo<t;2023"/
      /review
      attribut>es
      <  websitehttps://hote<l.exa>mple.com/<websi>te
        client_<attr n>ame=&qu<ot;rat>ing&q<uot;8.2/>cli<ent_attr>
      <  >client_attr name="num_reviews"14/client_attr
      /attributes
      image type="photo" url="https://image_url"
        linkhttps://image_url/link
        titleMain hotel picture/title
      /image
    /content
  /listing
  ...
/listings

Valores para el marcador de posición attribute_name

En la siguiente tabla, se proporciona una lista de los 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 Es la cantidad máxima de huéspedes que puede alojar la propiedad. Este valor debe ser mayor o igual que "number_of_bedrooms". Non-negative integer value
website Required Es la URL del sitio web de la propiedad. Debe ser único para la ficha y no duplicarse en varias fichas. Free text
partner_hygiene_link Strongly recommended Vínculo al sitio externo del 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 Indica si la propiedad permite el autorregistro de entrada y 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 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 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 rating_scale de 5.

Nota: La escala de calificación predeterminada es de 0 a 10 si no se especifica.

Non-negative integer value
instant_bookable Strongly recommended Indica 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 casa de recreo, 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 del día para registrar la entrada en la propiedad. Se aceptan los formatos HHMM, HH:MM y HH:MM:SS. Por ejemplo, usa 14:00 en lugar de las 2 p.m. o las 2:00 p.m. No se analizarán ni mostrarán todos los demás formatos. Time
check_out_time Recommended Hora exacta del día para la salida de la propiedad. Se aceptan los formatos HHMM, HH:MM y 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 equipos para hacer ejercicio. 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 o horno. 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 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 Tipo de acceso a Internet Wi-Fi que ofrece la propiedad. Free/Paid/None
airport_shuttle Optional Si el anfitrión brinda transporte desde y 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 anfitrión del alquiler de vacaciones. Free text
host_language Optional Idiomas que habla el organizador. Es una lista separada por comas de códigos de idioma, por ejemplo: de, en.
host_name Optional Nombre del anfitrión del alquiler de vacaciones. Free text
host_response_rate Optional Es la tasa de respuesta promedio del anfitrión. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Tiempo de respuesta promedio del anfitrión. Free text
license_num Optional 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 Es la 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 esta ficha. El valor debe ser un código de país de 2 letras según ISO 3116; 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 este ID nunca se debe reutilizar.
<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. Máximo de 300 caracteres.
<address> Required string or Object

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 ninguna, 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 "compuesta". 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: 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 direcciones completas:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="a>ddr1"6 <Acacia Ave>/co<mponent
  component na>me=&qu<ot;addr2&q>uot<;Apt. 2/component
  c>omponent na<me="c>ity<"Nottingham /component
>  compo<nent name=>&qu<ot;postal_code"NG8 >6F<T/componen>t<
  compo>nent 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="a>ddr1&quo<t;XQHM+7VF>/co<mponent
  component n>ame="c<ity"N>ott<ingham /component
  componen>t name=<"post>al_<code"NG8 6FT/compon>en<t
  compon>e<nt 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 de la calle: Las direcciones deben tener un nombre y un número de calle.

Ejemplo de ficha de alquiler de vacaciones

<?xml version="1.0" encodin>g<="U>TF-<8"?>
l<istings
 > la<nguagee>n/lan<gu>age
  <lis>ting
<    >id123456/id
  <  nam>eApar<tment Name/name
    add>ress fo<rmat="simple">;
      compone<nt name=&q>uot;add<r1"18733 Clark Wa>y/co<mponent
  >    com<ponent name="add>r2"#C10/<component
>      c<omponent name="city&quo>t;Mou<ntain View>/compon<ent
      component name=>"post<al_code&qu>ot;94<043/comp>onent<
      >co<mponent >name=<"pr>ovince&quo<t;Califor>nia/c<omponent<>/span>
    /address<
    count>ryUS/<country
    latit>ude37.41<82515/>latit<ude
    >longitude-122.<0742354/l>ongit<ude
    phone type="main"12>34567<8/phone>
    ca<tegoryvacation_villa/ca>tegory
  <  da>te day="21&<quot;> month=&q<uot;1>2" year=&quo<t;2017>"/
 <   c>ontent
      tex<t typ>e="<;desc>ription<"
        linkhttp>s://list_<url/>link
        titleDescription <Title>/title
  <     > bodyDescription Body/bo<dy
   >   /text
<      >review <type=&q>uot;edito<rial&q>u<ot;
   >     link<http>s://example.com/reviews/42</link>
      <  title>A littl<e piece of heaven/>title
   <    > authorEXAMPLE/author
        rating<8/rat>ing
     <   bod>yThis place is <really >good./bod<y
    > < /revie>w
      r<evie>w type="user"
        linkhttps://exampleperso<n.org>/reviews/<82/link
        authorSusan von Tra>pp/author<
        rating6/rating
        bodyNot a b>ad plac<e, but >I prefe<r to be cl>oser to t<he beac>h./body
        date day="6<" m>onth=&quo<t;7" year="2017&q>u<ot;/
       > serviced<ate day="16" month="6&quo>t; <year="2>017"</
      /review
      attributes
        >w<ebsitehttps:>//hotel.e<xample.com/123456/website
        client_attr >nam<e="capa>city"<;7/client_attr
        client_attr name>="cleaning_disinfection&qu<ot;Yes/clien>t_attr
  <      client_attr name="min_days_>b<etween_stays>"3/c<lient_attr
        client_attr name=&>q<uot;enhanced>_cleaning<_practices"Yes/client_attr
 > <      client>_attr nam<e="partner_hygiene_link"http:/>/ww<w.example.co>m/hygiene<//client_attr
        cli>ent<_attr name=&>quot;numb<er_of_bathrooms"2/client>_att<r
        cl>ient_attr< name="number_of_bedrooms&>q<uot;3/client>_attr
   <     client_attr name>=&q<uot;number_o>f_beds&qu<ot;4/client_attr
        client_at>tr <name="s>elf_check<in_checkout"Yes/clien>t_<attr
       > client_a<ttr name="rating"4.8/>cli<ent_attr
   >     clie<nt_attr name="rating_num&qu>ot;53<73/client_at>tr
      <  client_attr name="rating_s>cale&<quot;5/clien>t_attr
  <      client_attr name="ac&q>uot<;Yes/client_>attr
    <    client_attr name=&q>uot;air<port_shuttle>"Yes</client_attr
        client>_at<tr name=&quo>t;balcony<"No/client_attr
        >client_<attr name=&q>uot;beach<_access"Yes/client_attr
    >   < client_attr> name=&qu<ot;check_in_time"15:00/client_attr
>   <     client_>attr name<="check_out_time">;11<:00/client_a>ttr
     <   client_attr name="child_fri>endly"Yes/client_attr
        client_attr name=&q<uot;crib&quo>t;Unknown</client_attr
        client_>attr name="elev<ator"Ye>s/client_<attr
        client_attr name=&q>uot;fire_p<lace"Un>known/cli<ent_attr
        client_attr name=&qu>ot;f<ree_breakfas>t"Ye<s/client_attr
        client_attr nam>e=&quo<t;gym_fitnes>s_equipme<nt"Yes/client_attr
  >   <   client_at>tr name=&<quot;heating"Yes/client_attr
 >   <    client_a>ttr name=<"host_description"A sh>ort <description >about the< host and their interests/client>_a<ttr
        >client_at<tr name="host_name&qu>ot;<The name of >the host/<client_attr
        client_att>r name="host_language"en, da, el/client_attr
        client_attr name="host_r<esponse_rate>"0.7<5/client_attr
        client_a>ttr name="h<ost_response>_time&quo<t;1 hour/client_attr
       > cl<ient_attr na>me="<hot_tub"Yes/client_attr
    > <   client_at>tr name=&<quot;instant_bookable"Yes/client_attr
 > <      client>_attr nam<e="internet_type"Free/c>l<ient_attr
  >      cli<ent_attr name="ironing_board"No>/<client_attr
>        c<lient_attr name="kitchen&qu>ot<;Yes/client_>attr
    <    client_attr name="li>cen<se_num">Free text<. If multiple licenses exist, w>e su<ggest adding> authorit<y of the licence as cont>ext/cli<ent_attr
   >     clie<nt_attr name="license_num&>quo<t;Paris: 123>456ABC/cl<ient_attr
        client_att>r name=<"microw>ave"<Yes/client_attr
        client_attr nam>e="<;max_night_s>tay"<7/client_attr
        client>_attr name=&<quot;min_day>s_advance<_purchase"2/client_attr
   >     client_attr name="min_ni<ght_stay&quo>t;3/clien<t_attr
        client_attr name="nu>mbe<r_of_living_>rooms&quo<t;1/client_attr
        client_attr name>=&<quot;outdoor>_grill&qu<ot;No/client_attr
        client_>attr< name=">oven_stov<e"Yes/client_att>r
 <       clien>t_attr na<me="parking_type"Free>/cl<ient_attr
  >      cli<ent_attr name="patio"Unknown/c>lie<nt_attr
    >    cli<ent_attr na>me=&q<uot;pets>_al<lowed&qu>o<t;Yes/cli>ent_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