Travel Partner API

  • The Travel Partner API provides a RESTful interface to manage Google Hotel Center data for large or complex accounts.

  • The API utilizes the service endpoint https://travelpartner.googleapis.com.

  • A Discovery Document is available at https://travelpartner.googleapis.com/$discovery/rest?version=v3 to describe and consume the REST API.

  • The API includes REST resources for managing account links, brands, hotel views, hotel updates, icons, listings, and various report views.

The Travel Partner API provides you with a RESTful interface to the Google Hotel Center platform. It enables an app to efficiently retrieve and change Hotel Center data, and is thus suitable for managing large or complex accounts.

Service: travelpartner.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://travelpartner.googleapis.com

REST Resource: v3.accounts.brands

Methods
create POST /v3/{parent=accounts/*}/brands
Creates a new brand.
get GET /v3/{name=accounts/*/brands/*}
Returns the Brand instance associated with the request URI's brand resource name.
list GET /v3/{parent=accounts/*}/brands
Returns the brands for a partner account.
patch PATCH /v3/{brand.name=accounts/*/brands/*}
Updates a brand.

REST Resource: v3.accounts.freeBookingLinksReportViews

Methods
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
DEPRECATED: Use PropertyPerformanceReportService.QueryPropertyPerformanceReport, which also has impression reporting, instead.

REST Resource: v3.accounts.hotelViews

Methods
list GET /v3/{parent=accounts/*}/hotelViews
Returns the list of hotel views.
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
Returns summarized information about hotels.

REST Resource: v3.accounts.hotels

Methods
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
Collection-level custom method to update the Live on Google status for multiple properties.

REST Resource: v3.accounts.icons

Methods
create POST /v3/{parent=accounts/*}/icons
Uploads a new icon and starts its review process.
get GET /v3/{name=accounts/*/icons/*}
Returns the Icon instance associated with an icon resource name specified in the request URI.
list GET /v3/{parent=accounts/*}/icons
Returns the Icons for a partner account.

REST Resource: v3.accounts.listings

Methods
verify POST /v3/{parent=accounts/*}/listings:verify
Returns verified listings with data issues and serving eligibilities for VR partners only.

REST Resource: v3.accounts.participationReportViews

Methods
query GET /v3/{name=accounts/*}/participationReportViews:query
Provides the ability to query (get, filter, and segment) a participation report for a particular account.

REST Resource: v3.accounts.priceAccuracyViews

Methods
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
Returns the requested price accuracy view in full detail.
list GET /v3/{parent=accounts/*}/priceAccuracyViews
Lists the available price accuracy views.
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
Returns the price accuracy summary.

REST Resource: v3.accounts.priceCoverageViews

Methods
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
Returns the latest price coverage view in full detail.
list GET /v3/{parent=accounts/*}/priceCoverageViews
Returns the entire price coverage history.

REST Resource: v3.accounts.priceViews

Methods
get GET /v3/{name=accounts/*/priceViews/*}
Returns the requested price view in full detail.

REST Resource: v3.accounts.propertyPerformanceReportViews

Methods
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
Provides the ability to query (get, filter, and segment) a free booking links report for a specific account.

REST Resource: v3.accounts.reconciliationReports

Methods
create POST /v3/{parent=accounts/*}/reconciliationReports
Creates a reconciliation report and uploads it to Google.
get GET /v3/{name=accounts/*/reconciliationReports/*}
Returns a reconciliation report.
list GET /v3/{parent=accounts/*}/reconciliationReports
Returns a list of the names of created reconciliation reports.
validate POST /v3/{parent=accounts/*}/reconciliationReports:validate
Validates a reconciliation report.