Page Summary
-
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.
- REST Resource: v1alpha.invalidation.partners
- REST Resource: v1alpha.inventory.partners.availability
- REST Resource: v1alpha.inventory.partners.feeds
- REST Resource: v1alpha.inventory.partners.feeds.record
- REST Resource: v1alpha.inventory.partners.feeds.status
- REST Resource: v1alpha.inventory.partners.merchants
- REST Resource: v1alpha.inventory.partners.merchants.services
- REST Resource: v1alpha.inventory.partners.merchants.services.availability
- REST Resource: v1alpha.inventory.partners.merchants.status
- REST Resource: v1alpha.notification.partners.bookings
- REST Resource: v1alpha.notification.partners.orders
- REST Resource: v1alpha.partners.adsAccountLinks
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
. |
REST Resource: v1alpha.partners.adsAccountLinks
| Methods | |
|---|---|
create
|
POST /v1alpha/{parent=partners/*}/adsAccountLinks
Creates Ads account link. |
delete
|
DELETE /v1alpha/{name=partners/*/adsAccountLinks/*}
Deletes Ads account link. |
get
|
GET /v1alpha/{name=partners/*/adsAccountLinks/*}
Gets Ads account link. |
patch
|
PATCH /v1alpha/{adsAccountLink.name=partners/*/adsAccountLinks/*}
Updates Ads account link with inventory items. |

