Method: accounts.hotels.setLiveOnGoogle

  • The setLiveOnGoogle method is a collection-level custom method to update the Live on Google status for multiple hotel properties.

  • The HTTP request uses a POST method to the specified travel partner API endpoint.

  • The request body requires the account path parameter and can include liveOnGoogle (deprecated), partnerHotelIds, and liveOnGoogleStatus fields to control the update.

  • The response body indicates the updatedHotelIds and failedHotelIds resulting from the update operation.

  • This method requires the https://www.googleapis.com/auth/travelpartner OAuth scope for authorization.

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.