REST Resource: accounts.hotelViews

  • Hotel Views represent a hotel within Google's system and contain various identifiers and status information.

  • The JSON representation outlines the data structure for a Hotel View, including partner and Google specific IDs and display names.

  • MatchStatus indicates if a partner's hotel has been matched to a property on Google Maps.

  • LiveOnGoogleStatus shows whether a hotel property will be displayed on Google.

  • The available methods for Hotel Views are list to retrieve views and summarize to get summarized hotel information.

Resource: HotelView

A hotel view.

JSON representation 
{
  "partnerHotelId": string,
  "googleHotelId": string,
  "googleClusterId": string,
  "partnerHotelDisplayName": string,
  "googleHotelDisplayName": string,
  "overclusteredPartnerHotelIds": [
    string
  ],
  "primaryOverclusteredPartnerHotelId": string,
  "matchStatus": enum (MatchStatus),
  "dataIssueDetail": [
    {
      object (DataIssueDetail)
    }
  ],
  "matchFailureReasons": [
    string
  ],
  "dataIssues": [
    enum (FeedDataIssue)
  ],
  "liveOnGoogle": boolean,
  "liveOnGoogleStatus": enum (LiveOnGoogleStatus),
  "propertyDetails": string
}
Fields
partnerHotelId

string

The unique ID of the hotel that the partner provides in their Hotel List Feed.
googleHotelId

string

Google's canonical ID for the hotel.
googleClusterId

string

The Google Maps identifier for the hotel.
partnerHotelDisplayName

string

Partner's hotel name.
googleHotelDisplayName

string

Google's hotel name.
overclusteredPartnerHotelIds[]

string

Other hotels with which the hotel is overclustered.

If your feed contains overclustered hotels, update the feed and resubmit it. To do this, you can use the manual match tool.
primaryOverclusteredPartnerHotelId

string

The primary hotel in the overclustered set.
matchStatus

enum (MatchStatus)

Current matching status of the hotel.
dataIssueDetail[]

object (DataIssueDetail)

The type and severity of each data quality issue in the feed.

If your feed contains data issues, update the feed and resubmit it. For more information, refer to this article.
matchFailureReasons[]

string

The reasons why a hotel failed to match to a property on Maps.
dataIssues[]

enum (FeedDataIssue)

DEPRECATED. Indicates that the hotel has data quality issues. The value of this field indicates the type of error. This has been replaced with the dataIssueDetail field.

If your feed contains data issues, update the feed and resubmit it. For more information, refer to this article.
liveOnGoogle
(deprecated)

boolean

Optional. DEPRECATED. Prefer liveOnGoogleStatus. Whether the hotel appears in Google's hotel booking links. Declaration & behavior to get detection of presence/absence in JSON conversion.
liveOnGoogleStatus

enum (LiveOnGoogleStatus)

Optional. Whether the hotel appears in Google's hotel booking links. Declaration & behavior to get detection of presence/absence in JSON conversion.
propertyDetails

string

Optional. A URL to the property on Google. Only available for properties that are listed.

MatchStatus

Enumerates matching status of a hotel.

Enums
MATCH_STATUS_UNSPECIFIED Not specified.
MATCH_STATUS_UNKNOWN The value is unknown in this version.
NOT_MATCHED This hotel does not correspond to a hotel on Google Maps.
MATCHED This hotel corresponds to a hotel on Google Maps.
MAP_OVERLAP More than one of your hotels match this hotel on Google Maps.

LiveOnGoogleStatus

Enumerates supported Live-on-Google statuses indicating whether a property will show on Google.

Enums
LIVE_ON_GOOGLE_STATUS_UNSPECIFIED Not specified.
LIVE_ON_GOOGLE_STATUS_ACTIVE The property will show on Google unconditionally.
LIVE_ON_GOOGLE_STATUS_INACTIVE The property will not show on Google.
LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION The property will show on Google for users outside of DSA regions. Current regions include: EU.

Methods

list

 Returns the list of hotel views.

summarize

 Returns summarized information about hotels.