Attributes

This page covers the descriptions, values, and requirements for attributes and child elements. These values are only applicable to Vacation Rentals properties.

The general XML structure has a similar format as Hotel listing feeds. See Hotel list XML reference.

Failure to include the following items automatically disables the listing.

  • Required XML child elements: id, name, latitude, longitude, location_precision (meters), and country.
  • Required attributes: capacity and website.

For details of required XML child elements, see XML child elements.

For more information on Vacation Rentals, see Attributes unique to Vacation Rentals.

Values for the attribute_name placeholder

This table provides a list of valid values for attribute_name in the <client_attr name="attribute_name"> element; however, partners are encouraged to provide any additional attribute_name they may have.

Values for attribute_name Required? Description Valid content values
capacity Required Maximum number of guests the property can accommodate. Non-negative integer
website Required The website URL for the property. Free text
min_days_between_stays Optional (strongly recommended) The minimum number of "buffer days" the rental must be empty after the prior occupants depart. Non-negative integer
enhanced_cleaning_practices Optional (strongly recommended) Whether the property uses enhanced cleaning practices (with a description on the partner site). Yes/No
partner_hygiene_link Optional (strongly recommended) Link to external partner site providing more information about the hygiene details of the listing. Free text (the site's URL)
number_of_bathrooms Optional (strongly recommended) Number of bathrooms. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Optional (strongly recommended) Number of bedrooms. Non-negative integer value
number_of_beds Optional (strongly recommended) Number of beds (in all the rooms). Non-negative integer value
self_checkin_checkout Optional (strongly recommended) Whether the property allows for self check-in and check-out. Yes/No
rating_num Optional (strongly recommended) Number of ratings that the property has. Non-negative integer
ac Optional Whether the property has air conditioning. Yes/No
airport_shuttle Optional Whether the host provides transportation to/from airport or other terminals. Yes/No
balcony Optional Whether the property has a balcony. Yes/No
beach_access Optional Whether the property has access to a public beach close to the property. Yes/No
cancellation_policy Optional Free-text explanation of cancellation policy. Free Text
cancellation_policy_type Optional Partners can provide any type of policy name and Google will work with the partner to map the name to Google's suggested types. (If providing custom types, please limit them to about five categoties and communicate the descriptions of the types to your Account Manager).

Suggested types of cancellation policy accepted by the host:

  • No Refund: No refund offered for any reason or timeframe.
  • Strict: Bookings canceled at least 60 days before the start of the stay will receive a full refund.
  • Firm: Bookings canceled at least 60 days before the start of the stay will receive a full refund. Bookings canceled at least 30 days before the start of the stay will receive a 50% refund.
  • Moderate: Bookings canceled at least 30 days before the start of the stay will receive a full refund. Bookings canceled at least 14 days before the start of the stay will receive a 50% refund.
  • Relaxed: Bookings canceled at least 14 days before the start of the stay will receive a full refund. Bookings canceled at least 7 days before the start of the stay will receive a 50% refund.
Relaxed/Moderate/Firm/Strict/No Refund
check_in_time Optional Time of day for check-in to property. Free text
check_out_time Optional Exact time of day for check-out from the property. Free text
child_friendly Optional Whether the property is suitable for children. Yes/No
crib Optional Whether the property provides a crib. Yes/No
elevator Optional Whether the property has an elevator. Yes/No
fire_place Optional Whether the property has a fireplace. Yes/No
free_breakfast Optional Whether the property has free breakfast included. Yes/No
gym_fitness_equipment Optional Whether the property has a gym or any fitness equipment. Yes/No
heating Optional Whether the property has heating.
hot_tub Optional Whether the property has a hot tub. Yes/No
instant_bookable Optional Whether the property is instantly bookable through checkout process. The alternative is waiting for approval. Yes/No
ironing_board Optional Whether the property has ironing boards available. Yes/No
kitchen Optional Whether the property has a kitchen. Yes/No
license_num Optional License number (tourist or business) required to be shown for properties in certain regions of the world. It could be repeated and, if multiple licenses exist, we suggest adding authority of the license as context (for example: "Paris: 123456ABC"). Free text
microwave Optional Whether the property has a microwave available. Yes/No
minimum_days_advance_purchase Optional Minimum number of days in advance that the property can be booked. Non-negative integer
minimum_night_stay Optional Minimum number of nights a guest can book the property. Positive integer (more than zero)
max_night_stay Optional Maximum number of nights a guest can book the property. Positive integer (more than zero)
number_of_living_rooms Optional Number of living rooms. Non-negative integer value
outdoor_grill Optional Whether the property has a grill. Yes/No
oven_stove Optional Whether the property has a stove. Yes/No
parking_type Optional Type of parking available on the property. Free/Paid/None
patio Optional Whether the property has a patio. Yes/No
pets_allowed Optional Some or all rooms allow guests to bring pets (dogs and/or cats that aren't service animals) with them. Yes/No
pool_type Optional Type of pool (pool access) the property has. Indoors, Outdoors, Indoors/Outdoors, None
private_beach_access Optional Whether the property has dedicated access to a non-public beach. Yes/No
room_type Optional Type of property being shared with Google.

Note: Only accepting entire place for now.

Entire Place, Shared room, Private Room
smoking_free_property Optional Whether the property is smoke-free (no smoking allowed). Yes/No
square_footage Optional The square footage of the property. Non-negative float value
tv Optional Whether the property has a TV. Yes/No
washer_dryer Optional Whether the property has laundry appliances. Yes/No
wheelchair_accessible Optional Whether the property is wheelchair accessible. Yes/No
wifi_type Optional Type of Wi-Fi internet access provided by the property. Free/Paid/None
host_language Optional Languages the host can speak. A comma-separated list of language codes (for example: de, en)

XML child elements

The following XML child elements are required:

Child element Required? Type Description
<country> Required String The country that this listing is located in. The value must be an ISO 3116 uppercase 2-letter country code. For example, the United States is "US" and Canada is "CA":
    <country>US</country>
<id> Required String The unique identifier for the property. Note that each vacation rental must have an ID that is unique to your site, and this ID should never be reused.
<latitude> Required Float The latitude that corresponds to the location of the listing. For example:
<latitude>37.423738</latitude>

This value can be generated with GeoCoding tools like the Google Maps API.

<longitude> Required Float The longitude that corresponds to the location of the listing. For example:
<longitude>-122.090101</longitude>

This value can be generated with GeoCoding tools like the Google Maps API.

<location_precision> Required Integer Precision of the location of the property sent in meters (usually 500 meters or more) when the property latitude and longitude is obfuscated. Zero (0) means there is no obfuscation and that it is the exact location, and less than 100 meters is considered to be exact. Note: This element applies to Vacation Rentals only.
<name> Required String The name of the property.

Vacation Rentals listing example

<?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">Detailed Address</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>
    <location_precision>500<location_precision>
    <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>
      <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">Yes</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="cancellation_policy">50% deposit returnable before 4 weeks of arrival date, 100% refundable before 8 weeks of arrival</client_attr>
        <client_attr name="cancellation_policy_type">Moderate</client_attr>
        <client_attr name="check_in_time">3pm</client_attr>
        <client_attr name="check_out_time">11am</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Yes</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Yes</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">Yes</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">Yes</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Yes</client_attr>
        <client_attr name="refund_policy">Cancellations made after 48 hours but before 24 hours prior to checkin will received a 50% refund</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>