Guides

Google Vacation Rentals (VR)

Integrate Google VR with your Booking Engine API.

Suggest Edits

Follow the guidelines below to effectively integrate Google with your website or app powered by the Booking Engine API.

  1. Ensure you have an active Booking Engine API instance via the Guesty platform. Please verify your configuration for the Booking Engine API.
  2. Ensure you are using the Reservation quote flow endpoints.
    1. Using the Reservations V1 flow is unsupported and may cause issues, such as invalid price accuracy.
  3. To build your integration, go to the Upsert metasearch config endpoint. You will need to create a URL that meets Google's requirements. You can find their official instructions and examples here.
    1. Note the value for the pointofsale path parameter must be google.

Supported Variables

Only the following Google variables are supported by Guesty. Any other variables will cause the integration to fail.

(PARTNER-HOTEL-ID)
(NUM-GUESTS)
(CHECKINYEAR)
(CHECKINMONTH)
(CHECKINDAY)
(CHECKOUTYEAR)
(CHECKOUTMONTH)
(CHECKOUTDAY)

Request Example

curl --request PUT \
     --url https://booking.guesty.com/api/metasearch/pointofsale/google/config \
     --header 'accept: application/json; charset=utf-8' \
     --header 'content-type: application/json' \
     --data '
{
  "url": "https://www.getaway.com/properties/(PARTNER-HOTEL-ID)?minOccupancy=(NUM-GUESTS)&checkIn=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&checkOut=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&pointofsale=google"
}
'

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://booking.guesty.com/api/metasearch/pointofsale/google/config', [
  'body' => '{"url":"https://getaway.com/properties/(PARTNER-HOTEL-ID)?minOccupancy=(NUM-GUESTS)&amp;checkIn=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkOut=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;pointofsale=google"}',
  'headers' => [
    'accept' => 'application/json; charset=utf-8',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();

import requests

url = "https://booking.guesty.com/api/metasearch/pointofsale/google/config"

payload = {"url": "https://www.getaway.com/properties/(PARTNER-HOTEL-ID)?minOccupancy=(NUM-GUESTS)&amp;checkIn=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkOut=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;pointofsale=google"}
headers = {
    "accept": "application/json; charset=utf-8",
    "content-type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

🚧

Body URL Parameters

Make sure the URL in the body contains Google's parameters, not Guesty's, else the integration will fail.

  1. Go to the Guesty platform and click on Integration, then Distribution. Finally, click the Google Integration tile and continue with the integration flow.

Updated 8 months ago