Method: accounts.hotels.setLiveOnGoogle

  • This method allows you to update the "Live on Google" status for multiple hotel properties, enabling or disabling their visibility on Google.

  • You can specify whether to show or hide properties on Google using the liveOnGoogle boolean field in the request body.

  • The request body also requires a list of partnerHotelIds to identify the specific properties to update.

  • The response includes lists of successfully updated (updatedHotelIds) and failed (failedHotelIds) hotel properties.

  • Authorization requires the https://www.googleapis.com/auth/travelpartner OAuth scope.

Collection-level custom method to update the Live on Google status for multiple properties. Each call can turn on or off multiple hotels. To turn some hotels on and turn some hotels off, you will have to make multiple calls.

HTTP request

POST https://travelpartner.googleapis.com/v3/{account=accounts/*}/hotels:setLiveOnGoogle

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
account

string

Required. The resource name of the account. The format is accounts/{account_id}.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "liveOnGoogle": boolean,
  "partnerHotelIds": [
    string
  ],
  "liveOnGoogleStatus": enum (LiveOnGoogleStatus)
}
Fields
liveOnGoogle
(deprecated)

boolean

Optional. DEPRECATED. Whether the property will show on Google. When true, Google will show the properties if their integration is complete and the property is available. When false, Google will never show the properties.

Superseded by liveOnGoogleStatus.

Only one of liveOnGoogle or liveOnGoogleStatus should be set; if both are set, liveOnGoogleStatus will be used.
partnerHotelIds[]

string

Required. Identifies the properties to update with the liveOnGoogle setting.
liveOnGoogleStatus

enum (LiveOnGoogleStatus)

Optional. Whether the property will show on Google, with more granular controls than the original liveOnGoogle boolean field.

Only one of liveOnGoogle or liveOnGoogleStatus should be set; if both are set, liveOnGoogleStatus will be used.

Note: This field should be enclosed in quotes. For example, "LIVE_ON_GOOGLE_STATUS_INACTIVE".

Response body

Response message for HotelService.SetLiveOnGoogle.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "updatedHotelIds": [
    string
  ],
  "failedHotelIds": [
    string
  ]
}
Fields
updatedHotelIds[]

string

Identifies the updated properties.
failedHotelIds[]

string

Identifies properties that Google could not update.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/travelpartner

For more information, see the OAuth 2.0 Overview.