Reserve with Google

Additional Object Requirements

Reserve with Google adds additional required fields to Supplier and Product objects.

Documentation on each specific Supplier or Product field can be found in the API reference.

Supplier.BusinessType

A list of keywords that identify the type of business. These keywords are used to restrict results within Google to places matched by a specific business type.

We recommend selecting a type from Google's list of Place types, but any keyword value is supported.

JSON
    
 
{    "supplier": {        "businessType": ["tourist_attraction"],    }}
Copy

Supplier.Contacts

A list of contact information for the supplier.

Please note:

If there is more than one Contact, one must be specified as the Primary (have primary set to true).
A telephone number is required on the Primary Contact.

JSON
    
 
{    "supplier": {        "contacts": [            {                "email": "example@domain.com",                "name": "John Doe",                "primary": true,                "phone": "+1 (999) 999-9999"            }        ]    }}
Copy

Supplier.Hours, Product.Hours

RwG Suppliers and Products must have defined Open Hours.

The example below shows a Supplier, but the Hours format is consistent between Suppliers and Products.

JSON
    
 
{    "supplier": {        "hours": [            {                "times": [                    {                        "open": "08:00",                        "close": "18:00"                    }                ],                "timezone": "America/New_York"            }        ]    }}
Copy

Supplier.MainLocation, Product.Location

The location of the service is required for Google Maps to locate and verify the address.

If location is not specified on the Product, Reserve With Google will use the Supplier's mainLocation instead.

The latitude & longitude coordinates (longLat) are optional, but can be used to help matching or call out a specific product location on Google Maps.

Please note: the mainLocation and location objects are very similar; please check the Channel API reference for more information.

JSON
    
 
{    "supplier": {        "mainLocation": {            "address": {                "countryCode": "USA",                "locality": "Denver",                "postalCode": "80203",                "region": "CO",                "streetAddress": "200 E Colfax Ave"            },            "longLat": {                "latitude": 39.739465,                "longitude": -104.984775            },            "name": "Colorado State Capital",            "website": "https://www.colorado.gov/capitol"        }    }}
Copy

Product.Description

Google highly encourages very detailed descriptions of the operator and service that is being displayed to users. Google strongly recommends this information is included in the product description.

Below is a brief outline with some examples on writing a detailed product description.

Detail	Example
General Description: a detailed text description of the product.	Large-scale state-of-the-art interactive & multimedia exhibits & educational programs for all ages. This amazing experience will explore new wonders and teach things not previously known. It will be a memory to last a lifetime. Buy tickets now!
What's Included: What is included in the product.	_What's Included: Entry/Admission Priority access Professional Guide_
When: What time the product takes place, and/or the frequency at which the product takes place.	Runs daily at various times.
Where: Address or location	200 E Colfax Ave, Denver, CO 80203, USA
Additional Info: Any additional details the user should know before buying the product.	_- SENIOR ages: 65 - 120 ADULT ages: 11 - 64 CHILD ages: 0 - 10_
Cancellation and Refund Policy: Details regarding who to contact for product cancellation and refunds.	Tickets are cancellable and nonrefundable. Please call +1 (999) 999-9999 for any questions regarding cancels or refunds.

Rate.Hours

Open Hours (rate.hours[].times[]) are required on all Reserve with Google Rates. Each hour object must have a valid timezone associated with it.

JSON
    
 
{    "rate": {        "hours": [            {                "times": [                    {                        "open": "08:00",                        "close": "18:00"                    }                ],                "timezone": "America/Denver",                "valid": {                    "from": "2020-01-01T00:00:00Z",                    "until": "2030-01-01T00:00:00Z"                }            }        ]    }}
Copy

Rate.Prices

All Reserve with Google Rate Prices must include a Retail price.

The Rate Title should be a short, concise description of the Rate itself ("General Admission", "Summer Special", etc.). If more than one Rate exists for a Reserve with Google product, the Rate Title will be shown along side the Traveler's type when looking at the Schedule tab.