Google Maps Booking API

  • The Maps Booking API allows scheduling aggregators to manage appointment and inventory data.

  • Aggregators can update merchant, service, and availability information through dedicated REST resources.

  • Appointment updates are communicated via the API using booking and order notifications.

  • The API supports functionalities like resource invalidation, feed management, and Ads account linking.

  • Developers can utilize Google-provided client libraries or the Discovery Document to interact with the API.

Scheduling aggregators call this API to notify us of appointment updates, and update their inventories including merchants, services, and availability.

Service: mapsbooking.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://mapsbooking.googleapis.com

REST Resource: v1alpha.invalidation.partners

Methods
invalidateResource POST /v1alpha/invalidation/{resourceId=partners/**}:invalidateResource
Invalidates an existing resource.

REST Resource: v1alpha.inventory.partners.availability

Methods
replace POST /v1alpha/inventory/{parent=partners/*}/availability:replace
Replaces the Availability of existing Services.

REST Resource: v1alpha.inventory.partners.feeds

Methods
getStatus GET /v1alpha/inventory/{name=partners/*/feeds/*/*}/status
Retrieves the Status of a previously uploaded feed by the specified aggregator, and returns it.

REST Resource: v1alpha.inventory.partners.feeds.record

Methods
batchDelete POST /v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchDelete
Deletes records of specified feed type.
batchPush POST /v1alpha/inventory/{parent=partners/*/feeds/*}/record:batchPush
Inserts and/or updates records of specified feed type.

REST Resource: v1alpha.inventory.partners.feeds.status

Methods
list GET /v1alpha/inventory/{name=partners/*/feeds/*}/status
Retrieves the Status of multiple previously uploaded merchant, service, or availability feeds by the specified aggregator, and returns them.

REST Resource: v1alpha.inventory.partners.merchants

Methods
create POST /v1alpha/inventory/{parent=partners/*}/merchants
Creates a new Merchant managed by the specified aggregator, and returns it.
delete DELETE /v1alpha/inventory/{name=partners/*/merchants/*}
Deletes an existing Merchant managed by the specified aggregator.
getStatus GET /v1alpha/inventory/{name=partners/*/merchants/*/status}
Get the MerchantStatus of a Merchant.
patch PATCH /v1alpha/inventory/{merchant.name=partners/*/merchants/*}
Updates an existing Merchant managed by the specified aggregator, and returns it.

REST Resource: v1alpha.inventory.partners.merchants.services

Methods
create POST /v1alpha/inventory/{parent=partners/*/merchants/*}/services
Creates a new Service of a merchant managed by the specified aggregator, and returns it.
delete DELETE /v1alpha/inventory/{name=partners/*/merchants/*/services/*}
Deletes an existing Service of a merchant managed by the specified aggregator.
patch PATCH /v1alpha/inventory/{service.name=partners/*/merchants/*/services/*}
Updates an existing Service of a merchant managed by the specified aggregator, and returns it.

REST Resource: v1alpha.inventory.partners.merchants.services.availability

Methods
replace POST /v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
Replaces the Availability of an existing Service of a merchant managed by the specified aggregator, and returns it.

REST Resource: v1alpha.inventory.partners.merchants.status

Methods
list GET /v1alpha/inventory/{parent=partners/*/merchants}/status
List all MerchantStatus of a partner that satisfy the filter conditions.

REST Resource: v1alpha.notification.partners.bookings

Methods
patch PATCH /v1alpha/notification/{booking.name=partners/*/bookings/*}
Updates an existing Booking.

REST Resource: v1alpha.notification.partners.orders

Methods
patch PATCH /v1alpha/notification/{order.name=partners/*/orders/*}
Updates an existing Order.