Ontology for the Travel Partner API v3 schema surface across hotel property matching, per-itinerary prices, price accuracy and coverage, participation reporting, brands, icons, listings and reconciliation reports.

This generated publication specification records the reviewed service-local TypeSpec declarations, source field names, types, constraints, and enum wire values represented by the published RDF and SHACL artifacts.

This is an independently reviewed generated API ontology publication. It is regenerated from a clean Relay source commit; do not edit the imported specification or RDF artifacts by hand.

Publication contract

Service: googlehotels; TypeSpec namespace: Googlehotels; source revision: ada4be7cf8aae611e6709c4df8e975f06b19b557; versions: 3.

The TypeSpec source defines the API declaration. The RDFS/OWL graphs publish vocabulary semantics, SHACL publishes validation constraints, and the JSON-LD context publishes JSON term mappings. The source introspection is retained as independent replay evidence.

Reviewed surface

The service-local namespace contains 53 models with 245 declared fields, 35 enums with 339 wire values, 2 scalar aliases, and 0 named unions in compiler introspection. Shared framework declarations are available in the RDF artifacts but are excluded from these service-local counts.

Known representation boundaries

These are deliberate limits of the RDF representation, not silently inferred semantics:

Models and fields

AccountLinkTarget

Defines whether all properties or a subset of properties in the Hotel Center account can be managed with the linked Google Ads account. If a subset, the specific properties are specified.

TypeSpec name: Googlehotels.AccountLinkTarget

Wire fieldSource typePresenceSource constraintsDescription
allHotels boolean optional True if all properties under the Hotel Center account are made available to the account link. The default is `false`.
hotelList Googlehotels.HotelList optional List of properties that is made available to the account link.

Brand

Brand-level icon and display name configuration. Once approved, the icon and display name appear in the search results for properties that the partner has assigned to this brand.

TypeSpec name: Googlehotels.Brand

Wire fieldSource typePresenceSource constraintsDescription
activeDisplayNames Array<Googlehotels.LocalizedText> optional Output only. The brand's active display names in all provided languages, only present if the display name is approved for all provided languages.
activeIcon string optional Output only. The brand's active [accounts.icon](/hotels/hotel-prices/api-reference/rest/v3/accounts.icons#resource:-iconresource). The value refers to the icons's resource name in the format `accounts/{account_id}/icons/{icon_id}`. An active icon is one that has been approved.
activeIconUri string optional Output only. URL of the active icon, only present when the icon has been approved.
displayNameDisapprovalReason Array<Googlehotels.DisplayNameDisapprovalReason> optional Output only. Display name's disapproval reason. Only applies to display names with the review state 'REJECTED'.
displayNames Array<Googlehotels.LocalizedText> optional Input only. The name Google displays for the brand's properties. Setting the display names is only necessary if you want to override the landing page display name or account-level display name for the brand. Google reviews the display names for appropriate content. When there are multiple languages, Google will only show the display names once Google approves all the languages.
displayNameState Googlehotels.BrandDisplayNameState optional Output only. The brand's display names review state, which applies to all display name language entries. If there are both submitted and active display names, this refers to the submitted display names.
icon string optional Input only. The brand's [accounts.icon](/hotels/hotel-prices/api-reference/rest/v3/accounts.icons#resource:-iconresource) identifying the brand's icon. The value refers to the icons's resource name in the format `accounts/{account_id}/icons/{icon_id}`.
iconDisapprovalReasons Array<Googlehotels.BrandIconDisapprovalReasons> optional Output only. The icon's disapproval reason(s). Only applies to submitted icons with `REJECTED` state.
iconState Googlehotels.BrandIconState optional Output only. The brand's icon's review state. If there are both submitted and active icons, this refers to the submitted icon.
name string optional Output only. The resource name for the brand in the format `accounts/{account_id}/brands/{brand_id}`. The `brand_id` corresponds to the partner's brand identifier used for landing page matching and the property-level brand identifier. A default brand is applied to properties that do not have a brand. The `brand_id` of the default brand is `NO_BRAND_ID`. It can be fetched and updated like any configured brand.
propertyCount Googlehotels.Int64AsString optional Output only. The number of properties with the corresponding brand ID.
submittedDisplayNames Array<Googlehotels.LocalizedText> optional Output only. The brand's submitted display names in all provided languages, only present if the display name is new or rejected for any language.
submittedIcon string optional Output only. The brand's submitted [accounts.icon](/hotels/hotel-prices/api-reference/rest/v3/accounts.icons#resource:-iconresource). The value refers to the icons's resource name in the format `accounts/{account_id}/icons/{icon_id}`. A submitted icon is one that is new or rejected.

CreateReconciliationReportResponse

Response message for ReconciliationReportService.CreateReconciliationReport.

TypeSpec name: Googlehotels.CreateReconciliationReportResponse

Wire fieldSource typePresenceSource constraintsDescription
issues Array<Googlehotels.ReconciliationReportValidationIssue> optional Issues that were encountered when validating the file.
reconciliationReport Googlehotels.ReconciliationReport optional Resource name of the new reconciliation report. The format is `accounts/{account_id}`.
successfulRecordCount int32 optional The number of commission records that were successfully saved.

DataIssueDetail

Details on a data issue in the listing.

TypeSpec name: Googlehotels.DataIssueDetail

Wire fieldSource typePresenceSource constraintsDescription
dataIssueSeverity Googlehotels.DataIssueDetailDataIssueSeverity optional The severity of the data issue.
dataIssueType Googlehotels.DataIssueDetailDataIssueType optional The type of the data issue.
isSelfResolving boolean optional Whether or not the issue is self-resolving. If true, the issue is expected to resolve itself. If false or not set, action is needed to resolve the issue. Refer to documentation on the data issue’s type for further information.

Date

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

TypeSpec name: Googlehotels.Date

Wire fieldSource typePresenceSource constraintsDescription
day int32 optional Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
month int32 optional Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
year int32 optional Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

DisplayNameDisapprovalReason

Disapproval reason of the display name in a specific language.

TypeSpec name: Googlehotels.DisplayNameDisapprovalReason

Wire fieldSource typePresenceSource constraintsDescription
disapprovalReason Googlehotels.DisplayNameDisapprovalReasonDisapprovalReason optional Disapproval reason.
languageCode string optional Language of the disapproved display name.

Empty

A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

TypeSpec name: Googlehotels.Empty

Wire fieldSource typePresenceSource constraintsDescription
No declared fields.

FreeBookingLinksResult

**DEPRECATED:** Use `PropertyPerformanceResult` with `PropertyPerformanceReportService` instead. Represents a result from querying for free booking link stats for an account.

TypeSpec name: Googlehotels.FreeBookingLinksResult

Wire fieldSource typePresenceSource constraintsDescription
clickCount Googlehotels.Int64AsString optional The total number of clicks that were recorded for this result.
date Googlehotels.Date optional A date within the requested date range. Only present if `date` is specified in `aggregateBy` in the request.
deviceType Googlehotels.FreeBookingLinksResultDeviceType optional The user’s device type. Only present if `deviceType` is specified in `aggregateBy` in the request.
partnerHotelDisplayName string optional Partner's hotel name. Only present if `partnerHotelDisplayName` is specified in `aggregateBy` in the request.
partnerHotelId string optional Partner's hotel ID. Only present if `partnerHotelId` is specified in `aggregateBy` in the request.
userRegionCode string optional ISO 3116 region code of the country/region of the user. Only present if `userRegionCode` is specified in `aggregateBy` in the request

GooglehotelsAuth

Travel Partner OAuth 2.0 bearer authentication. Callers set `Authorization: Bearer <oauth2-access-token>` against a Hotel Center account the credential is authorised for. The account is named in the request path rather than by a header. No operation is declared in this ontology-only contract.

TypeSpec name: Googlehotels.GooglehotelsAuth

Wire fieldSource typePresenceSource constraintsDescription
scheme "Bearer" required in source bearer auth scheme
type unknown required in source Http authentication

HotelList

The properties in the Hotel Center account that can be managed with the Google Ads account.

TypeSpec name: Googlehotels.HotelList

Wire fieldSource typePresenceSource constraintsDescription
partnerHotelIds Array<string> optional Hotel IDs.

HotelPricePerItinerary

Hotel price for a given itinerary.

TypeSpec name: Googlehotels.HotelPricePerItinerary

Wire fieldSource typePresenceSource constraintsDescription
checkinDate Googlehotels.Date optional Check-in date.
currencyCode string optional Currency for `price`, `taxes`, and `fees`.
fees float32 optional Fees for this itinerary.
lengthOfStayDays int32 optional Number of nights for the itinerary.
price float32 optional Hotel price for this itinerary.
taxes float32 optional Taxes for this itinerary.
updateTime utcDateTime optional Update timestamp for this hotel price.

HotelView

A hotel view.

TypeSpec name: Googlehotels.HotelView

Wire fieldSource typePresenceSource constraintsDescription
dataIssueDetail Array<Googlehotels.DataIssueDetail> optional 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.
dataIssues Array<Googlehotels.HotelViewDataIssues> optional 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 data_issue_detail field. If your feed contains data issues, update the feed and resubmit it. For more information, refer to this article.
googleClusterId Googlehotels.Uint64AsString optional The Google Maps identifier for the hotel.
googleHotelDisplayName string optional Google's hotel name.
googleHotelId Googlehotels.Uint64AsString optional Google's canonical ID for the hotel.
liveOnGoogle boolean optional Optional. DEPRECATED. Prefer live_on_google_status. Whether the hotel appears in Google's hotel booking links. Declaration & behavior to get detection of presence/absence in JSON conversion.
liveOnGoogleStatus Googlehotels.HotelViewLiveOnGoogleStatus optional Optional. Whether the hotel appears in Google's hotel booking links. Declaration & behavior to get detection of presence/absence in JSON conversion.
matchFailureReasons Array<string> optional The reasons why a hotel failed to match to a property on Maps.
matchStatus Googlehotels.HotelViewMatchStatus optional Current matching status of the hotel.
overclusteredPartnerHotelIds Array<string> optional 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.
partnerHotelDisplayName string optional Partner's hotel name.
partnerHotelId string optional The unique ID of the hotel that the partner provides in their Hotel List Feed.
primaryOverclusteredPartnerHotelId string optional The primary hotel in the overclustered set.
propertyDetails string optional Optional. A URL to the property on Google. Only available for properties that are listed.

Icon

Information about a partner's icon.

TypeSpec name: Googlehotels.Icon

Wire fieldSource typePresenceSource constraintsDescription
disapprovalReasons Array<Googlehotels.IconDisapprovalReasons> optional Output only. The icon's disapproval reason(s). Only applies to icons with `REJECTED` state.
iconUri string optional Output only. The approved icon's Google-hosted URI. Only applies to icons with `APPROVED` state.
imageData bytes optional Required. Input only. The icon contents, which must be in PNG format, or convertible to PNG.
name string optional Required. Output only. The resource name for the icon in the format `accounts/{account_id}/icons/{icon_id}`. Google generates the `icon_id` during the `create` operation. Use the `icon_id` to associate the icon with a brand using the [accounts.brands](/hotels/hotel-prices/api-reference/rest/v3/accounts.brands#resource:-brand) API.
reference string optional Optional. Value for tracking the icon. It could be the primary key to your icon in your system, or the icon's filename. Google does not use this value.
state Googlehotels.IconState optional Output only. The icon's current state.

Image

A single image in a VR Listing. Title and gallery URL are stored per locale. NEXT ID: 4

TypeSpec name: Googlehotels.Image

Wire fieldSource typePresenceSource constraintsDescription
galleryUri Array<Googlehotels.LocalizedText> optional URL that is deeplink to the image in a gallery (or a webpage).
title Array<Googlehotels.LocalizedText> optional Title of the image.
uri string optional URL that points to the binary image content directly.

Key

Key of a result.

TypeSpec name: Googlehotels.Key

Wire fieldSource typePresenceSource constraintsDescription
advanceBookingWindow int32 optional The number of days in advance the user wants to book the itinerary. If `advanceBookingWindow` is not a value of the `aggregateBy` parameter in the request call, then the `advanceBookingWindow` field is not returned in the `Key`.
checkinDate Googlehotels.Date optional The check-in date of the itinerary. If `checkinDate` is not a value of the `aggregateBy` parameter in the request call, then the `checkinDate` field is not returned in the `Key`.
date Googlehotels.Date optional The date for which you are requesting metrics. If `date` is not a value of the `aggregateBy` parameter in the request call, then the `date` field is not returned in the `Key`.
deviceType Googlehotels.KeyDeviceType optional The user’s device type. If `deviceType` is not a value of the `aggregateBy` parameter in the request call, then the `deviceType` field is not returned in the `Key`.
hotelRegionCode string optional CLDR region code of the country/region of the hotel. If `hotelRegionCode` is not a value of the `aggregateBy` parameter in the request call, then the `hotelRegionCode` field is not returned in the `Key`.
lengthOfStayDays int32 optional The number of nights for the itinerary. If `lengthOfStayDays` is not a value of the `aggregateBy` parameter in the request call, then the `lengthOfStayDays` field is not returned in the `Key`.
occupancy int32 optional The total occupancy of the itinerary. If `occupancy` is not a value of the `aggregateBy` parameter in the request call, then the `occupancy` field is not returned in the `Key`.
partnerHotelId string optional Partner's hotel ID. If `partnerHotelId` is not a value of the `aggregateBy` parameter in the request call, then the `partnerHotelId` field is not returned in the `Key`.
userRegionCode string optional ISO 3116 region code of the country/region of the user. If `userRegionCode` is not a value of the `aggregateBy` parameter in the request call, then the `userRegionCode` field is not returned in the `Key`.

LatLng

An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges.

TypeSpec name: Googlehotels.LatLng

Wire fieldSource typePresenceSource constraintsDescription
latitude float64 optional The latitude in degrees. It must be in the range [-90.0, +90.0].
longitude float64 optional The longitude in degrees. It must be in the range [-180.0, +180.0].

ListAccountLinksResponse

Response message for AccountLinkService.ListAccountLinks.

TypeSpec name: Googlehotels.ListAccountLinksResponse

Wire fieldSource typePresenceSource constraintsDescription
accountLinks Array<Googlehotels.AccountLink> optional A list of all account links associated with the Hotel Center account being queried.

ListBrandsResponse

Response message for BrandService.ListBrands.

TypeSpec name: Googlehotels.ListBrandsResponse

Wire fieldSource typePresenceSource constraintsDescription
brands Array<Googlehotels.Brand> optional A list of brands for the current page associated with the Hotel Center account being queried.
nextPageToken string optional Token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListHotelViewsResponse

Response message for HotelViewService.ListHotelViews.

TypeSpec name: Googlehotels.ListHotelViewsResponse

Wire fieldSource typePresenceSource constraintsDescription
hotelViews Array<Googlehotels.HotelView> optional The list of rows that match the query.
nextPageToken string optional Pagination token used to retrieve the next page of results.

ListIconsResponse

Response message for IconService.ListIcons.

TypeSpec name: Googlehotels.ListIconsResponse

Wire fieldSource typePresenceSource constraintsDescription
icons Array<Googlehotels.Icon> optional A list of all icons associated with the queried partner account.

ListPriceAccuracyViewsResponse

Response message for PriceAccuracyViewService.ListPriceAccuracyViews.

TypeSpec name: Googlehotels.ListPriceAccuracyViewsResponse

Wire fieldSource typePresenceSource constraintsDescription
priceAccuracyViews Array<Googlehotels.PriceAccuracyView> optional The list of rows that match the query.

ListPriceCoverageViewsResponse

Response message for PriceCoverageViewService.ListPriceCoverageViews.

TypeSpec name: Googlehotels.ListPriceCoverageViewsResponse

Wire fieldSource typePresenceSource constraintsDescription
priceCoverageViews Array<Googlehotels.PriceCoverageView> optional Hotel price coverage stats.

ListReconciliationReportsResponse

Response message for ReconciliationReportService.ListReconciliationReports.

TypeSpec name: Googlehotels.ListReconciliationReportsResponse

Wire fieldSource typePresenceSource constraintsDescription
reconciliationReports Array<Googlehotels.ReconciliationReport> optional The list of names of reconciliation reports. Note that the `contents` and `fileName` fields of each `ReconciliationReport` object are not returned by this call.

LocalizedText

Localized variant of a text in a particular language.

TypeSpec name: Googlehotels.LocalizedText

Wire fieldSource typePresenceSource constraintsDescription
languageCode string optional The text's BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
text string optional Localized string in the language corresponding to language_code below.

MissedParticipationCountDetails

Missed participation count broken down by reason.

TypeSpec name: Googlehotels.MissedParticipationCountDetails

Wire fieldSource typePresenceSource constraintsDescription
hotelSuspendedCount Googlehotels.Int64AsString optional The total number of missed participations due to one or more of your hotels being suspended due to price accuracy violations.
noAvailabilityCount Googlehotels.Int64AsString optional The total number of missed participation due to the hotel/itinerary combination being unavailable, or the traveler was ineligible for the rates. To participate in these auctions, you may need to provide more pricing information.
noLandingPageCount Googlehotels.Int64AsString optional No landing page matched the user.
noPriceCount Googlehotels.Int64AsString optional The total number of missed participations due to a price not being offered for the requested itinerary.
noPriceCountDetails Googlehotels.NoPriceCountDetails optional The reasons that contributed to the no price count (for example, live pricing not available) and the total count for each reason.
noTaxBreakdownCount Googlehotels.Int64AsString optional The total number of missed participation due to one or more of your hotels not specifying taxes and fees separately.
otherReasonCount Googlehotels.Int64AsString optional Hotel did not participate for an unknown reason.
priceMissingCount Googlehotels.Int64AsString optional The total number of missed participations due to either a price not being present in Google's cache or failing to successfully respond to live pricing. Comprised of the following: * Bandwidth depleted * Cache rate missing * Itinerary blocked * Live pricing not set up * Live pricing timeout * Live pricing error
priceMissingCountDetails Googlehotels.PriceMissingCountDetails optional The reasons that contributed to the price missing count.
priceProblemCount Googlehotels.Int64AsString optional The total number of missed participation due to an issue with the accuracy of the price provided for the itinerary. Comprised of the following: * Hotel suspended * Price unusually high * Price unusually low * Taxes and feeds missing
priceProblemCountDetails Googlehotels.PriceProblemCountDetails optional The reasons that contributed to the price problem count.
priceUnavailableCount Googlehotels.Int64AsString optional The total number of missed participation due to price listed as unavailable (-1) for the requested itinerary. Comprised of the following: * Price unavailable * Participation not likely * Other
priceUnavailableCountDetails Googlehotels.PriceUnavailableCountDetails optional The reasons that contributed to the price unavailable count.

NoPriceCountDetails

The reasons that contributed to the no price count and the total count for each reason.

TypeSpec name: Googlehotels.NoPriceCountDetails

Wire fieldSource typePresenceSource constraintsDescription
livePricingConfigIssueCount Googlehotels.Int64AsString optional The total number of missed participation due to live pricing not being triggered for any of the following reasons: * You didn't have live pricing configured for these searches. * You restricted Google from accessing the hotel itinerary in question.
livePricingNotAvailableCount Googlehotels.Int64AsString optional The total number of missed participation due to live pricing being unavailable. Live pricing will not be triggered for certain default itineraries or UIs. In this scenario, partners will need a cached price to participate.
livePricingNotTriggeredCount Googlehotels.Int64AsString optional The total number of missed participation due to live pricing not being triggered for any of the following reasons: * You didn't set a bid. * You didn't have a valid landing page. * There weren't enough prices in the cache.
livePricingOtherReasonCount Googlehotels.Int64AsString optional The number of missed participations due to other issues with live pricing.
livePricingTechnicalIssueCount Googlehotels.Int64AsString optional The total number of missed participation due to technical issues with live pricing for any of the following reasons: * You didn’t respond quickly enough and exceeded the response deadline (around 4000 milliseconds). * You returned an error. * Your response was malformed.

ParsedListing

A parsed listing

TypeSpec name: Googlehotels.ParsedListing

Wire fieldSource typePresenceSource constraintsDescription
brand string optional If not empty, it indicates that this listing belongs to a brand of the feed.
category Array<Googlehotels.LocalizedText> optional The partner provided category (accommodation type) of the property.
dataIssueDetail Array<Googlehotels.DataIssueDetail> optional Data issues about this listing
description Array<Googlehotels.LocalizedText> optional Description of the property.
image Array<Googlehotels.Image> optional Images associated with this listing, localized.
imprecisionRadiusMeters int32 optional Represents the accuracy of the location. The listing can be anywhere within the defined circular area.
isServed boolean optional Whether the listing can be served based on non image data alone.
listingName Array<Googlehotels.LocalizedText> optional List of localized names.
location Googlehotels.LatLng optional Location of listing using latitude and longitude (degrees).
partnerListId string optional The list ID on partner LEC feed, provided by partner.
regionCode string optional The country code where the listing is located.
review Array<Googlehotels.Review> optional Reviews associated with this listing. Each review has a single language attached to it.
unitAttributes Record<string, string> optional VR List attribute.

ParticipationResult

Represents a result from querying for participation stats for an account.

TypeSpec name: Googlehotels.ParticipationResult

Wire fieldSource typePresenceSource constraintsDescription
key Googlehotels.Key optional Key of the result.
missedParticipationCount Googlehotels.Int64AsString optional The total number of opportunities **not** eligible for the Google Ads auction process. Comprised of the following: * Landing page missing * Price missing * Price problem * Price unavailable * Other
missedParticipationCountDetails Googlehotels.MissedParticipationCountDetails optional The reasons that contributed to the missed participation count (for example, no availability) and a total count for each reason.
opportunityCount Googlehotels.Int64AsString optional For a specific hotel, the total number of opportunities that were available. Opportunities are the total number of instances when a hotel ad could have been displayed to a user.
participationCount Googlehotels.Int64AsString optional The total number of opportunities for which you were eligible to enter in the Google Ads auction process.
participationPercent float64 optional The percentage rate of participation where the number of successfully participated opportunities is divided by the total number of opportunities. For example, if a property was eligible to enter the Google Ads auction 90 times out of 100 opportunities, the participation rate is 90%.
partnerHotelDisplayName string optional Partner's hotel display name. This field is only populated when the result is aggregated by `partnerHotelId`.

PriceAccuracyRow

A price accuracy row.

TypeSpec name: Googlehotels.PriceAccuracyRow

Wire fieldSource typePresenceSource constraintsDescription
adultOccupancy int32 optional The number of adults in the occupancy details of the validation query. Note: This field may not be consistently populated due to technical constraints. If missing, partners should assume a default of 2 adults.
affectsScore boolean optional True if this row affects the overall price accuracy score.
cachedPriceRecord Googlehotels.PriceRecord optional Price as advertised.
checkinDate Googlehotels.Date optional Check-in date.
childOccupancy int32 optional The number of children in the occupancy details of the validation query. Note: This field may not be consistently populated. If missing, partners should assume a default of 0 children.
correctionTime utcDateTime optional Time at which an incorrect price is updated to a correct price.
deviceType Googlehotels.PriceAccuracyRowDeviceType optional The user's device type.
fetchedPriceRecord Googlehotels.PriceRecord optional Price as read from the partner website.
finalDomain string optional The domain of the final page from which prices are read.
hotel string optional Partner-defined hotel ID.
hotelCountryCode string optional The country of the hotel (based on address).
lengthOfStayDays int32 optional Length of stay.
mismatchReason Googlehotels.PriceAccuracyRowMismatchReason optional The reason why the fetched price didn't match the cached price.
rateRuleId string optional The rate rule of the advertised price for non-public rates.
signalSource Googlehotels.PriceAccuracyRowSignalSource optional Source of the price accuracy signal.
url string optional Initial URL visited on the partner website.
userRegionCode string optional The user's region.

PriceAccuracyView

A price accuracy view. Covers the price accuracy reports functionality in pre-v3.0 API versions. For more information, refer to [Price Accuracy report](https://support.google.com/hotelprices/answer/6318506).

TypeSpec name: Googlehotels.PriceAccuracyView

Wire fieldSource typePresenceSource constraintsDescription
name string optional Resource name should be in the format `accounts/{account_id}/priceAccuracyViews/{report_date}`.
results Array<Googlehotels.PriceAccuracyRow> optional The list of rows that match the query.

PriceCoverageBucket

Coverage stats for one combination of advance booking window and length of stay.

TypeSpec name: Googlehotels.PriceCoverageBucket

Wire fieldSource typePresenceSource constraintsDescription
advanceBookingWindowRange Googlehotels.PriceCoverageBucketAdvanceBookingWindowRange optional Advance booking window range.
availablePriceCount Googlehotels.Int64AsString optional Number of prices for this advance booking window bucket and length of stay bucket.
lengthOfStayRange Googlehotels.PriceCoverageBucketLengthOfStayRange optional Length of stay range.
priceCoveragePercent float64 optional The percent of itineraries for which you have coverage for this advance booking window bucket and length of stay bucket.

PriceCoverageView

A price coverage view. Covers the `price_coverage_stats` Scorecard functionality in pre-v3.0 API versions. For more information, refer to Price Coverage for Push and Hint partners.

TypeSpec name: Googlehotels.PriceCoverageView

Wire fieldSource typePresenceSource constraintsDescription
calculationDate Googlehotels.Date optional The date on which the calculations were made.
matchedPropertyCount int32 optional The total number of properties that have prices for the given itineraries.
priceCoverageBinaryPercent float64 optional The ratio between the number of hotels which have at least one price for the calculation period and `matched_property_count`.
priceCoverageBuckets Array<Googlehotels.PriceCoverageBucket> optional Price coverage stats for combinations of advance booking window and length of stay ranges.
priceCoveragePercent float64 optional The overall price coverage for an account. This value is the ratio between the number of hotel prices for the calculation booking window and length of stay range divided by the number of all possible prices, which is `matched_property_count` times 330 (for advance book window) times 30 (for length of stay).

PriceMissingCountDetails

The reasons that contributed to the price missing count and the total count for each reason.

TypeSpec name: Googlehotels.PriceMissingCountDetails

Wire fieldSource typePresenceSource constraintsDescription
bandwidthDepletedCount Googlehotels.Int64AsString optional No price was cached for this itinerary, and there was no live query quota remaining.
cacheRateMissingCount Googlehotels.Int64AsString optional No price exists in the cache for this itinerary. A live query was not done due to page constraints.
itineraryBlockedCount Googlehotels.Int64AsString optional The itinerary was outside of your basic parameters, so no price was pulled for the itinerary from either live query or cache fill.
livePricingErrorCount Googlehotels.Int64AsString optional No price was cached for this itinerary. A live query did not time out, but your system returned an error.
livePricingNotSetupCount Googlehotels.Int64AsString optional No price was cached for this itinerary, and live query was not configured for this account.
livePricingTimeoutCount Googlehotels.Int64AsString optional No price was cached for this itinerary, and a live query sent to your system timed out.

PriceProblemCountDetails

The reasons that contributed to the price problem count and the total count for each reason.

TypeSpec name: Googlehotels.PriceProblemCountDetails

Wire fieldSource typePresenceSource constraintsDescription
basePriceViolationsCount Googlehotels.Int64AsString optional Base price too low relative to total price.
hotelSuspendedCount Googlehotels.Int64AsString optional The hotel was suspended. This may be due to persistent problems in areas such as incorrect taxes and fees.
priceAccuracyIssueCount Googlehotels.Int64AsString optional Price accuracy issue.
priceUnusuallyHighCount Googlehotels.Int64AsString optional The price given for this itinerary seemed oddly high compared to regional trends.
priceUnusuallyLowCount Googlehotels.Int64AsString optional The price given for this itinerary seemed oddly low compared to regional trends.
taxesAndFeesMissingCount Googlehotels.Int64AsString optional Taxes and fees were missing from pricing.

PriceRecord

A price record.

TypeSpec name: Googlehotels.PriceRecord

Wire fieldSource typePresenceSource constraintsDescription
basePrice float32 optional Base price.
currencyCode string optional ISO 4217 currency code.
taxesAndFees float32 optional Taxes and fees.
time utcDateTime optional Timestamp of this price record.

PriceUnavailableCountDetails

The reasons that contributed to the price unavailable count and the total count for each reason.

TypeSpec name: Googlehotels.PriceUnavailableCountDetails

Wire fieldSource typePresenceSource constraintsDescription
participationNotLikelyCount Googlehotels.Int64AsString optional No price was cached for this itinerary, and no live query was done because your server usually tells us the hotel is unavailable or sold out.
priceUnavailableCount Googlehotels.Int64AsString optional Hotel did not participate because it wasn't available for the itinerary dates.

PriceView

A price view. Covers the Prices functionality in pre-v3.0 API versions.

TypeSpec name: Googlehotels.PriceView

Wire fieldSource typePresenceSource constraintsDescription
name string optional Resource name in the format `accounts/{account_id}/priceViews/{partner_hotel_id}`.
perItineraryPrices Array<Googlehotels.HotelPricePerItinerary> optional Price for each itinerary.

PropertyPerformanceResult

Represents a result from querying for the property performance report for an account.

TypeSpec name: Googlehotels.PropertyPerformanceResult

Wire fieldSource typePresenceSource constraintsDescription
adsClickCount Googlehotels.Int64AsString optional The total number of ad clicks that were recorded for this result.
adsClickthroughRate float64 optional Equal to `ads_click_count` divided by `ads_impression_count`.
adsImpressionCount Googlehotels.Int64AsString optional The total number of ad impressions that were recorded for this result.
advanceBookingWindow Googlehotels.PropertyPerformanceResultAdvanceBookingWindow optional Difference in days between query date and check-in date in property's local timezone. Only present if `advanceBookingWindow` is specified in `aggregateBy` in the request.
brand string optional Partner-specified brand for the property. Only present if `brand` is specified in `aggregateBy` in the request.
clickCount Googlehotels.Int64AsString optional The total number of free booking link clicks that were recorded for this result.
clickthroughRate float64 optional Equal to `click_count` divided by `impression_count`.
date Googlehotels.Date optional A date within the requested date range. Only present if `date` is specified in `aggregateBy` in the request.
deviceType Googlehotels.PropertyPerformanceResultDeviceType optional The user’s device type. Only present if `deviceType` is specified in `aggregateBy` in the request.
highIntentUsers boolean optional Whether the user’s query indicated a strong interest in booking. Only present if `highIntentUsers` is specified in `aggregateBy` in the request.
impressionCount Googlehotels.Int64AsString optional The total number of free booking link impressions that were recorded for this result. This value is rounded to preserve user privacy.
lengthOfStay Googlehotels.PropertyPerformanceResultLengthOfStay optional Number of nights between check-in and check-out dates specified by user. Only present if `lengthOfStay` is specified in `aggregateBy` in the request.
occupancy Googlehotels.PropertyPerformanceResultOccupancy optional Requested number of people staying at the property. Only present if `partnerPropertyId` is specified in `aggregateBy` in the request.
partnerPropertyDisplayName string optional Partner's property name. Only present if `partnerPropertyDisplayName` is specified in `aggregateBy` in the request.
partnerPropertyId string optional Partner's property ID. Only present if `partnerPropertyId` is specified in `aggregateBy` in the request.
propertyRegionCode string optional ISO 3116 region code of the country/region of the property. Only present if `propertyRegionCode` is specified in `aggregateBy` in the request
userRegionCode string optional ISO 3116 region code of the country/region of the user. Only present if `userRegionCode` is specified in `aggregateBy` in the request
vrWebsiteButtonClicks Googlehotels.Int64AsString optional The total number of clicks on the "Website" button on Google for vacation rentals.

QueryFreeBookingLinksReportResponse

**DEPRECATED:** Use `QueryPropertyPerformanceReportResponse` with `PropertyPerformanceReportService` instead. Response message for FreeBookingLinksReportService.QueryFreeBookingLinksReport.

TypeSpec name: Googlehotels.QueryFreeBookingLinksReportResponse

Wire fieldSource typePresenceSource constraintsDescription
nextPageToken string optional Pagination token used to retrieve the next page of results. If this field is omitted, there are no subsequent pages.
results Array<Googlehotels.FreeBookingLinksResult> optional The list of results that match the query.

QueryParticipationReportResponse

Response message for ParticipationReportService.QueryParticipationReport.

TypeSpec name: Googlehotels.QueryParticipationReportResponse

Wire fieldSource typePresenceSource constraintsDescription
nextPageToken string optional Pagination token used to retrieve the next page of results.
results Array<Googlehotels.ParticipationResult> optional The list of results that matches the query.

QueryPropertyPerformanceReportResponse

Response message for PropertyPerformanceReportService.QueryPropertyPerformanceReport.

TypeSpec name: Googlehotels.QueryPropertyPerformanceReportResponse

Wire fieldSource typePresenceSource constraintsDescription
nextPageToken string optional Pagination token used to retrieve the next page of results. If this field is omitted, there are no subsequent pages.
results Array<Googlehotels.PropertyPerformanceResult> optional The list of results that match the query.

Rating

A rating for a vacation rentals listing. NEXT ID: 4

TypeSpec name: Googlehotels.Rating

Wire fieldSource typePresenceSource constraintsDescription
ratingScale int32 optional Maximum rating possible.
score float32 optional The rating score. (e.g. 8.5)
type Googlehotels.RatingType optional The type of the rating.

ReconciliationReport

Reconciliation report (Hotel Ads only). Covers the Reconciliation Reports functionality in pre-v3.0 API versions. Lets you see the status, validate, and upload your Commissions reconciliation reports. This only applies if you are in the Google Hotel Ads Commissions Program (GHACP). For more information about working with reconciliation reports in Hotel Center, refer to [Reconciliation reports](//support.google.com/hotelprices/answer/7019060#sending).

TypeSpec name: Googlehotels.ReconciliationReport

Wire fieldSource typePresenceSource constraintsDescription
contents string optional Required. The contents of the commission report. Report contents must conform to the requirements specified in [Reconciliation reports] (//support.google.com/hotelprices/answer/7019060#creating).
fileName string optional Required. Desired filename of the reconciliation report.
name string optional Resource name in the format `accounts/{account_id}/reconciliationReports/{datetime}~{filename}`. The value for `{datetime}` must be from 0001-01-01T00:00:00 to 9999-12-31T23:59:59 inclusive.

ReconciliationReportValidationIssue

Represents an issue encountered when validating a reconciliation report.

TypeSpec name: Googlehotels.ReconciliationReportValidationIssue

Wire fieldSource typePresenceSource constraintsDescription
description string optional Text description of the issue, typically including what was seen and why it was invalid.
fieldName string optional Name of the invalid field. If no field name is given, this issue applies to the whole line (or file).
lineNum int32 optional The line number on which the issue was detected. If this field is 0, the issue applies to the whole file.

Review

A single review in a VR Listing. NEXT ID: 10

TypeSpec name: Googlehotels.Review

Wire fieldSource typePresenceSource constraintsDescription
author string optional The author of the review.
body string optional The body of the review.
languageCode string optional Language of the review in ISO639 format, such as "en", "de", etc.
link string optional The url of the review.
rating Array<Googlehotels.Rating> optional Any ratings associated with this review. This is repeated because reviews can include ratings on different aspects of a listing, e.g. location, cleanliness, etc.
reviewTime utcDateTime optional Unix timestamp (in seconds) of the review, in UTC+0.
title string optional The title of the review, for example: Great three bedrooms.
type Googlehotels.ReviewType optional The type of the review.
visitTime utcDateTime optional Unix timestamp (in seconds) of when the stay was, in UTC+0.

SetLiveOnGoogleRequest

Request message for HotelService.SetLiveOnGoogle.

TypeSpec name: Googlehotels.SetLiveOnGoogleRequest

Wire fieldSource typePresenceSource constraintsDescription
liveOnGoogle boolean optional 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 `live_on_google_status`. Only one of `live_on_google` or `live_on_google_status` should be set; if both are set, `live_on_google_status` will be used.
liveOnGoogleStatus Googlehotels.SetLiveOnGoogleRequestLiveOnGoogleStatus optional Optional. Whether the property will show on Google, with more granular controls than the original `live_on_google` boolean field. Only one of `live_on_google` or `live_on_google_status` should be set; if both are set, `live_on_google_status` will be used. **Note:** This field should be enclosed in quotes. For example, `"LIVE_ON_GOOGLE_STATUS_INACTIVE"`.
partnerHotelIds Array<string> optional Required. Identifies the properties to update with the liveOnGoogle setting.

SetLiveOnGoogleResponse

Response message for HotelService.SetLiveOnGoogle.

TypeSpec name: Googlehotels.SetLiveOnGoogleResponse

Wire fieldSource typePresenceSource constraintsDescription
failedHotelIds Array<string> optional Identifies properties that Google could not update.
updatedHotelIds Array<string> optional Identifies the updated properties.

SummarizeHotelViewsResponse

Response message for HotelViewService.SummarizeHotelViews.

TypeSpec name: Googlehotels.SummarizeHotelViewsResponse

Wire fieldSource typePresenceSource constraintsDescription
lastFeedSubmissionTime utcDateTime optional Timestamp of the last hotel feed submission.
lastManifestUpdateTime utcDateTime optional Timestamp of the last hotel manifest update.
liveOnGooglePropertyCount Googlehotels.Int64AsString optional The number of properties that are Live on Google. This includes properties that are conditionally active, e.g. LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION.
matchedPropertyCount Googlehotels.Int64AsString optional The number of properties that match Google's manifest.
overclusteredPropertyCount Googlehotels.Int64AsString optional The number of hotels that are considered overclustered.
overclusteredPropertyWithErrorsCount Googlehotels.Int64AsString optional The number of overclustered properties that have data-related errors.
unmatchedPropertyCount Googlehotels.Int64AsString optional The number of properties that are considered unmatched.
unmatchedPropertyWithErrorsCount Googlehotels.Int64AsString optional The number of unmatched properties that have data-related errors.

SummarizePriceAccuracyResponse

Response message for PriceAccuracyViewService.SummarizePriceAccuracy.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponse

Wire fieldSource typePresenceSource constraintsDescription
currentBookOnGoogleScore Googlehotels.SummarizePriceAccuracyResponseCurrentBookOnGoogleScore optional The current Book on Google price accuracy score.
currentOverallScore Googlehotels.SummarizePriceAccuracyResponseCurrentOverallScore optional The current price accuracy score combining both website and Book on Google scores.
currentScore Googlehotels.SummarizePriceAccuracyResponseCurrentScore optional The current price accuracy score. Contains the same value as `current_website_score`. For clarity, use either `current_website_score` or 'current_overall_score` depending upon which is needed.
currentWebsiteScore Googlehotels.SummarizePriceAccuracyResponseCurrentWebsiteScore optional The current website price accuracy score.
predictedBookOnGoogleScore Googlehotels.SummarizePriceAccuracyResponsePredictedBookOnGoogleScore optional The predicted Book on Google price accuracy score.
predictedOverallScore Googlehotels.SummarizePriceAccuracyResponsePredictedOverallScore optional The predicted price accuracy score combining both website and Book on Google scores.
predictedScore Googlehotels.SummarizePriceAccuracyResponsePredictedScore optional The predicted price accuracy score. Contains the same value as `predicted_website_score`. For clarity, use either `predicted_website_score` or 'predicted_overall_score` depending upon which is needed.
predictedWebsiteScore Googlehotels.SummarizePriceAccuracyResponsePredictedWebsiteScore optional The predicted website price accuracy score.
updateTime utcDateTime optional The update timestamp for the current score.

ValidateReconciliationReportResponse

Response message for ReconciliationReportService.ValidateReconciliationReport.

TypeSpec name: Googlehotels.ValidateReconciliationReportResponse

Wire fieldSource typePresenceSource constraintsDescription
issues Array<Googlehotels.ReconciliationReportValidationIssue> optional Issues that were encountered when validating the file.
successfulRecordCount int32 optional The number of commission records that were successfully validated.

VerifyListingsRequest

Request message for VRPartnerListingVerificationService.VerifyPartnerListings.

TypeSpec name: Googlehotels.VerifyListingsRequest

Wire fieldSource typePresenceSource constraintsDescription
xmlListing string optional A listing that follows the XML format specified in https://developers.google.com/hotels/hotel-prices/xml-reference/hotel-list-feed.

VerifyListingsResponse

Response message for VRPartnerListingVerificationService.VerifyPartnerListings.

TypeSpec name: Googlehotels.VerifyListingsResponse

Wire fieldSource typePresenceSource constraintsDescription
parsedListing Googlehotels.ParsedListing optional The parsed listing output.

Enumerations

AccountLinkStatus

Values AccountLink.status accepts.

TypeSpec name: Googlehotels.AccountLinkStatus

MemberWire valueDescription
accountLinkStatusUnknown ACCOUNT_LINK_STATUS_UNKNOWN The account link status is not recognized by this API version.
accountLinkStatusUnspecified ACCOUNT_LINK_STATUS_UNSPECIFIED Default value.
approved APPROVED The account link has been approved.
requestedFromGoogleAds REQUESTED_FROM_GOOGLE_ADS The account link was initiated through Google Ads and has not yet been approved in Hotel Center.
requestedFromHotelCenter REQUESTED_FROM_HOTEL_CENTER The account link was initiated through Hotel Center and has not yet been approved in Google Ads.

BrandDisplayNameState

Values Brand.displayNameState accepts.

TypeSpec name: Googlehotels.BrandDisplayNameState

MemberWire valueDescription
approved APPROVED The icon or display name is approved and ready for public display.
rejected REJECTED The icon or display name is rejected. Google won't display it.
reviewStateNew REVIEW_STATE_NEW Google is reviewing the icon or display name.
reviewStateUnspecified REVIEW_STATE_UNSPECIFIED Default value.

BrandIconDisapprovalReasons

Values Brand.iconDisapprovalReasons accepts.

TypeSpec name: Googlehotels.BrandIconDisapprovalReasons

MemberWire valueDescription
animated ANIMATED Icon image is animated.
badBackground BAD_BACKGROUND Icon image does not have a transparent or non-white background.
imageDisapprovalReasonUnspecified IMAGE_DISAPPROVAL_REASON_UNSPECIFIED Not specified.
lowQuality LOW_QUALITY Icon image is low quality.
notLikeSite NOT_LIKE_SITE Icon image does not match the favicon or artwork on the advertiser’s final URL.
offensive OFFENSIVE Icon image contains offensive content.
textTooSmall TEXT_TOO_SMALL Icon image contains text that is too small.

BrandIconState

Values Brand.iconState accepts.

TypeSpec name: Googlehotels.BrandIconState

MemberWire valueDescription
approved APPROVED The icon or display name is approved and ready for public display.
rejected REJECTED The icon or display name is rejected. Google won't display it.
reviewStateNew REVIEW_STATE_NEW Google is reviewing the icon or display name.
reviewStateUnspecified REVIEW_STATE_UNSPECIFIED Default value.

DataIssueDetailDataIssueSeverity

Values DataIssueDetail.dataIssueSeverity accepts.

TypeSpec name: Googlehotels.DataIssueDetailDataIssueSeverity

MemberWire valueDescription
dataIssueSeverityUnspecified DATA_ISSUE_SEVERITY_UNSPECIFIED The severity of the issue is unknown.
error ERROR The data issue will make the listing ineligible for serving.
info INFO The data issue is for informational purposes.
warning WARNING The listing will still be eligible for serving, but the data issue may have an adverse effect on the content shown.

DataIssueDetailDataIssueType

Values DataIssueDetail.dataIssueType accepts.

TypeSpec name: Googlehotels.DataIssueDetailDataIssueType

MemberWire valueDescription
adwordsAttributeTooLong ADWORDS_ATTRIBUTE_TOO_LONG The category or `content.attributes.client_attr[name='hotel_brand']` element exceeds 70 Unicode characters, and/or `content.attributes.client_attr[name='custom_*']` exceeds 100 Unicode characters.
brandNameTooLong BRAND_NAME_TOO_LONG Vacation rental listing brand name is too long.
cannotFetchImages CANNOT_FETCH_IMAGES The images for this property cannot be fetched. Please check that the image URLs are valid (e.g. do not give a 404 error) and that the domain hosting the image URLs does not block crawling of these images in its robots.txt file or X-Robots-Tag HTTP Header.
couldNotGeocode COULD_NOT_GEOCODE A valid pair of latitude/longitude fields is missing and Google could not generate them from the address.
duplicateAddress DUPLICATE_ADDRESS The address is the same as another property in the Hotel List Feed.
duplicateLatlong DUPLICATE_LATLONG The latitude/longitude pair is the same as another property in the Hotel List Feed.
duplicatePhoneNumber DUPLICATE_PHONE_NUMBER The phone number you provided for this property is the same as the phone number for another property. More than one listing in the Hotel List Feed cannot have the same phone number.
feedDataIssueUnknown FEED_DATA_ISSUE_UNKNOWN The value is unknown in this version.
feedDataIssueUnspecified FEED_DATA_ISSUE_UNSPECIFIED Not specified.
flaggedDueToSuspiciousMetadata FLAGGED_DUE_TO_SUSPICIOUS_METADATA Contact your account manager for details.
hotelNameEmpty HOTEL_NAME_EMPTY An empty or whitespace only name is provided, but no valid name.
hotelNameTooLong HOTEL_NAME_TOO_LONG The hotel name exceeds 200 characters.
imageProcessingInProgress IMAGE_PROCESSING_IN_PROGRESS The images for this vacation rental property are still being processed.
incompatibleImageSizeOrLowQuality INCOMPATIBLE_IMAGE_SIZE_OR_LOW_QUALITY The images provided for this property do not meet Google's requirements due to dimensions, size, or automated quality signals. Please ensure that the images are less than 10 MB large, less than 4K pixels wide, and less than 4K pixels tall. Please check additional guidance outlined at the [Property listing image requirements](/hotels/vacation-rentals/dev-guide/onboarding#property_listing_image_requirements)
internalBlocklist INTERNAL_BLOCKLIST This listing is in an internal blocklist. Contact your account manager for help.
invalidAmenities INVALID_AMENITIES The name and value at 'listing.content.attributes.attr' is either unsupported or has an invalid value.
invalidCheckinFormat INVALID_CHECKIN_FORMAT Vacation rental listing has an invalid check-in format.
invalidCheckoutFormat INVALID_CHECKOUT_FORMAT Vacation rental listing has an invalid check-out format.
invalidEmailAddress INVALID_EMAIL_ADDRESS The email at 'listing.content.attributes.attr[name='email']' is not a valid email address.
invalidHotelName INVALID_HOTEL_NAME An invalid name is provided, but no valid name.
invalidPhoneNumber INVALID_PHONE_NUMBER The phone number is not valid.
invalidPhoneNumberCountryCode INVALID_PHONE_NUMBER_COUNTRY_CODE The country code of the phone number is not valid.
invalidPhoneNumberFormat INVALID_PHONE_NUMBER_FORMAT The phone number format is not valid.
invalidPostalCode INVALID_POSTAL_CODE The address contains an invalid postal code.
invalidPostalCodeSuffix INVALID_POSTAL_CODE_SUFFIX The address contains an invalid postal code suffix.
invalidReviewRating INVALID_REVIEW_RATING Vacation rental listing has an invalid review rating.
invalidWebsiteUrl INVALID_WEBSITE_URL The specified `content.attributes.attr[name='website']` element is not a valid URL.
isHotel IS_HOTEL Vacation rental listing has been characterized as a hotel and not a vacation rental.
latlongInconsistentWithAddress LATLONG_INCONSISTENT_WITH_ADDRESS The latitude/longitude pair provided for the address is more than 500 meters away from the Google latitude/longitude generated from the address.
missingAddress MISSING_ADDRESS The address does not appear to contain a street number, street name, or supported country code.
missingBrandName MISSING_BRAND_NAME Google no longer requires brand names; this issue no longer occurs.
missingCountry MISSING_COUNTRY An invalid but recognized country code was provided.
missingHotelName MISSING_HOTEL_NAME No hotel name is provided.
missingLangInName MISSING_LANG_IN_NAME Vacation rental listing name is missing a language field.
missingLangInRawListing MISSING_LANG_IN_RAW_LISTING Deprecated Issue Vacation rental raw listing is missing a language field.
missingLatlong MISSING_LATLONG A valid pair of latitude/longitude fields is missing and Google latitude/longitude generation is disabled.
missingName MISSING_NAME Vacation rental listing is missing a name.
missingPhoneNumber MISSING_PHONE_NUMBER No valid phone number for this property found.
missingPhysicalStreetAddress MISSING_PHYSICAL_STREET_ADDRESS The provided address appears to contain a postal box instead of a physical street address.
missingReqAttr MISSING_REQ_ATTR Vacation rental listing is missing a required attribute.
missingStreetName MISSING_STREET_NAME The address does not appear to contain a street name.
missingStreetNumber MISSING_STREET_NUMBER The address does not appear to contain a street number.
missingVoicePhoneNumber MISSING_VOICE_PHONE_NUMBER Only invalid or fax phone numbers found.
nameAndDescriptionAbuseVerified NAME_AND_DESCRIPTION_ABUSE_VERIFIED Vacation rental listing's name or description is verfied to contain content that violates Google's content policy.
noDataIssue NO_DATA_ISSUE No data issues found.
nonVrAccommodationType NON_VR_ACCOMMODATION_TYPE Listing that is sent as a vacation rental is suspected to be a non-vacation rental accommodation type, such as a hotel, hostel, etc.
nonVrAccommodationTypeBasedOnListingName NON_VR_ACCOMMODATION_TYPE_BASED_ON_LISTING_NAME Please use NON_VR_ACCOMMODATION_TYPE instead.
notEnoughImagesProvided NOT_ENOUGH_IMAGES_PROVIDED Vacation rental properties must have at least five feed images. Eight or more images are strongly recommended; having fewer than 8 may impact performance (such as impressions and clicks).
parseErrorInXml PARSE_ERROR_IN_XML Google encountered an error while importing your Hotel List Feed.
phoneNumberTooLong PHONE_NUMBER_TOO_LONG The phone number contains too many digits.
phoneNumberTooShort PHONE_NUMBER_TOO_SHORT The phone number contains has too few digits.
reviewMissingVisitTimestamp REVIEW_MISSING_VISIT_TIMESTAMP This listing has a review that is missing a visit timestamp and the timestamp is required in the listing's country. The review should include "servicedate" if using XML markup or "contentReferenceTime" if using schema.org.
testProperty TEST_PROPERTY Vacation rental listing is a test property.
unexpectedAttributeInXml UNEXPECTED_ATTRIBUTE_IN_XML Google encountered an unknown error while importing your Hotel List Feed.
unexpectedPostalCode UNEXPECTED_POSTAL_CODE The address contains a postal code when unsupported by the country's postal code system.
unexpectedPostalCodeSuffix UNEXPECTED_POSTAL_CODE_SUFFIX The address contains a postal code suffix when unsupported by the country's postal code system.
vrAddressIncomplete VR_ADDRESS_INCOMPLETE Deprecated: Replaced with more specifc errors or VR_ADDRESS_INVALID. Google detected that the provided address for this listing is incomplete. For example, it may be missing a unit number.
vrAddressIncompleteNoStreetName VR_ADDRESS_INCOMPLETE_NO_STREET_NAME The provided address is missing a street name.
vrAddressIncompleteNoStreetNumber VR_ADDRESS_INCOMPLETE_NO_STREET_NUMBER The provided address is missing a street number.
vrAddressIncompleteNoUnitNumber VR_ADDRESS_INCOMPLETE_NO_UNIT_NUMBER The provided address is missing a unit number.
vrAddressInvalid VR_ADDRESS_INVALID The provided address is invalid. Review address requirements on the [dev guide](/hotels/vacation-rentals/dev-guide/vr-attributes). Debugging suggestions: 1. Confirm the address does not contain redundant information such as the country in both addr1 and country_code. 2. Use Google Maps to confirm if the address is formatted correctly for its region. 3. Use a [plus code](https://plus.codes) if the address continues to be invalid.
vrAddressLatlongMismatch VR_ADDRESS_LATLONG_MISMATCH The provided address and lat/long data for this listing doesn't match.
vrAddressMissing VR_ADDRESS_MISSING An address should be added to this listing.
vrBrandMissingLandingPage VR_BRAND_MISSING_LANDING_PAGE The brand of this vacation rental property doesn't have a landing page. Contact your account manager for details.
vrInvalidRoomType VR_INVALID_ROOM_TYPE The room type is invalid. Private rooms and shared rooms are part of shared accommodations, which are not currently supported on the platform.
vrLiveOnGoogleInactiveError VR_LIVE_ON_GOOGLE_INACTIVE_ERROR The "Live on Google" setting for this Vacation Rental is set to false. Note: once "Live on Google" is set to true, it will take a few days for this error to disappear.
vrNameTooLong VR_NAME_TOO_LONG Vacation rental listing name is too long.
vrPendingInitialProcessing VR_PENDING_INITIAL_PROCESSING Vacation rental listing is undergoing initial processing.
vrPendingWebsiteCrawling VR_PENDING_WEBSITE_CRAWLING Vacation rental listing has a website link that is still undergoing crawling.
vrWebsiteLinkRoboted VR_WEBSITE_LINK_ROBOTED Vacation rental listing has a website link that is blocked by a robots.txt
vrWebsiteLinkWithCrawlingError VR_WEBSITE_LINK_WITH_CRAWLING_ERROR Vacation rental listing has a website link with a crawling error.
vrXmlFailedParsing VR_XML_FAILED_PARSING This listing's XML failed to parse. Please fix the XML associated with this listing.
vrZipFileCorrupt VR_ZIP_FILE_CORRUPT A listing that indicates the that feed ZIP file is corrupt. Please ensure the ZIP file is valid.

DisplayNameDisapprovalReasonDisapprovalReason

Values DisplayNameDisapprovalReason.disapprovalReason accepts.

TypeSpec name: Googlehotels.DisplayNameDisapprovalReasonDisapprovalReason

MemberWire valueDescription
disapprovalReasonUnspecified DISAPPROVAL_REASON_UNSPECIFIED Not specified.
landingPageNotMatched LANDING_PAGE_NOT_MATCHED The display name does not match the landing page.
marketingLanguage MARKETING_LANGUAGE The display name contains marketing language.
notBrandName NOT_BRAND_NAME The display name does not appear to be a brand.
punctuation PUNCTUATION The display name has bad formatting and/or contains punctuation.

FreeBookingLinksResultDeviceType

Values FreeBookingLinksResult.deviceType accepts.

TypeSpec name: Googlehotels.FreeBookingLinksResultDeviceType

MemberWire valueDescription
desktop DESKTOP Computers.
deviceUnknown DEVICE_UNKNOWN The value is unknown in this version.
deviceUnspecified DEVICE_UNSPECIFIED Not specified.
mobile MOBILE Mobile devices with full browsers.
tablet TABLET Tablets with full browsers.

HotelViewDataIssues

Values HotelView.dataIssues accepts.

TypeSpec name: Googlehotels.HotelViewDataIssues

MemberWire valueDescription
adwordsAttributeTooLong ADWORDS_ATTRIBUTE_TOO_LONG The category or `content.attributes.client_attr[name='hotel_brand']` element exceeds 70 Unicode characters, and/or `content.attributes.client_attr[name='custom_*']` exceeds 100 Unicode characters.
brandNameTooLong BRAND_NAME_TOO_LONG Vacation rental listing brand name is too long.
cannotFetchImages CANNOT_FETCH_IMAGES The images for this property cannot be fetched. Please check that the image URLs are valid (e.g. do not give a 404 error) and that the domain hosting the image URLs does not block crawling of these images in its robots.txt file or X-Robots-Tag HTTP Header.
couldNotGeocode COULD_NOT_GEOCODE A valid pair of latitude/longitude fields is missing and Google could not generate them from the address.
duplicateAddress DUPLICATE_ADDRESS The address is the same as another property in the Hotel List Feed.
duplicateLatlong DUPLICATE_LATLONG The latitude/longitude pair is the same as another property in the Hotel List Feed.
duplicatePhoneNumber DUPLICATE_PHONE_NUMBER The phone number you provided for this property is the same as the phone number for another property. More than one listing in the Hotel List Feed cannot have the same phone number.
feedDataIssueUnknown FEED_DATA_ISSUE_UNKNOWN The value is unknown in this version.
feedDataIssueUnspecified FEED_DATA_ISSUE_UNSPECIFIED Not specified.
flaggedDueToSuspiciousMetadata FLAGGED_DUE_TO_SUSPICIOUS_METADATA Contact your account manager for details.
hotelNameEmpty HOTEL_NAME_EMPTY An empty or whitespace only name is provided, but no valid name.
hotelNameTooLong HOTEL_NAME_TOO_LONG The hotel name exceeds 200 characters.
imageProcessingInProgress IMAGE_PROCESSING_IN_PROGRESS The images for this vacation rental property are still being processed.
incompatibleImageSizeOrLowQuality INCOMPATIBLE_IMAGE_SIZE_OR_LOW_QUALITY The images provided for this property do not meet Google's requirements due to dimensions, size, or automated quality signals. Please ensure that the images are less than 10 MB large, less than 4K pixels wide, and less than 4K pixels tall. Please check additional guidance outlined at the [Property listing image requirements](/hotels/vacation-rentals/dev-guide/onboarding#property_listing_image_requirements)
internalBlocklist INTERNAL_BLOCKLIST This listing is in an internal blocklist. Contact your account manager for help.
invalidAmenities INVALID_AMENITIES The name and value at 'listing.content.attributes.attr' is either unsupported or has an invalid value.
invalidCheckinFormat INVALID_CHECKIN_FORMAT Vacation rental listing has an invalid check-in format.
invalidCheckoutFormat INVALID_CHECKOUT_FORMAT Vacation rental listing has an invalid check-out format.
invalidEmailAddress INVALID_EMAIL_ADDRESS The email at 'listing.content.attributes.attr[name='email']' is not a valid email address.
invalidHotelName INVALID_HOTEL_NAME An invalid name is provided, but no valid name.
invalidPhoneNumber INVALID_PHONE_NUMBER The phone number is not valid.
invalidPhoneNumberCountryCode INVALID_PHONE_NUMBER_COUNTRY_CODE The country code of the phone number is not valid.
invalidPhoneNumberFormat INVALID_PHONE_NUMBER_FORMAT The phone number format is not valid.
invalidPostalCode INVALID_POSTAL_CODE The address contains an invalid postal code.
invalidPostalCodeSuffix INVALID_POSTAL_CODE_SUFFIX The address contains an invalid postal code suffix.
invalidReviewRating INVALID_REVIEW_RATING Vacation rental listing has an invalid review rating.
invalidWebsiteUrl INVALID_WEBSITE_URL The specified `content.attributes.attr[name='website']` element is not a valid URL.
isHotel IS_HOTEL Vacation rental listing has been characterized as a hotel and not a vacation rental.
latlongInconsistentWithAddress LATLONG_INCONSISTENT_WITH_ADDRESS The latitude/longitude pair provided for the address is more than 500 meters away from the Google latitude/longitude generated from the address.
missingAddress MISSING_ADDRESS The address does not appear to contain a street number, street name, or supported country code.
missingBrandName MISSING_BRAND_NAME Google no longer requires brand names; this issue no longer occurs.
missingCountry MISSING_COUNTRY An invalid but recognized country code was provided.
missingHotelName MISSING_HOTEL_NAME No hotel name is provided.
missingLangInName MISSING_LANG_IN_NAME Vacation rental listing name is missing a language field.
missingLangInRawListing MISSING_LANG_IN_RAW_LISTING Deprecated Issue Vacation rental raw listing is missing a language field.
missingLatlong MISSING_LATLONG A valid pair of latitude/longitude fields is missing and Google latitude/longitude generation is disabled.
missingName MISSING_NAME Vacation rental listing is missing a name.
missingPhoneNumber MISSING_PHONE_NUMBER No valid phone number for this property found.
missingPhysicalStreetAddress MISSING_PHYSICAL_STREET_ADDRESS The provided address appears to contain a postal box instead of a physical street address.
missingReqAttr MISSING_REQ_ATTR Vacation rental listing is missing a required attribute.
missingStreetName MISSING_STREET_NAME The address does not appear to contain a street name.
missingStreetNumber MISSING_STREET_NUMBER The address does not appear to contain a street number.
missingVoicePhoneNumber MISSING_VOICE_PHONE_NUMBER Only invalid or fax phone numbers found.
nameAndDescriptionAbuseVerified NAME_AND_DESCRIPTION_ABUSE_VERIFIED Vacation rental listing's name or description is verfied to contain content that violates Google's content policy.
noDataIssue NO_DATA_ISSUE No data issues found.
nonVrAccommodationType NON_VR_ACCOMMODATION_TYPE Listing that is sent as a vacation rental is suspected to be a non-vacation rental accommodation type, such as a hotel, hostel, etc.
nonVrAccommodationTypeBasedOnListingName NON_VR_ACCOMMODATION_TYPE_BASED_ON_LISTING_NAME Please use NON_VR_ACCOMMODATION_TYPE instead.
notEnoughImagesProvided NOT_ENOUGH_IMAGES_PROVIDED Vacation rental properties must have at least five feed images. Eight or more images are strongly recommended; having fewer than 8 may impact performance (such as impressions and clicks).
parseErrorInXml PARSE_ERROR_IN_XML Google encountered an error while importing your Hotel List Feed.
phoneNumberTooLong PHONE_NUMBER_TOO_LONG The phone number contains too many digits.
phoneNumberTooShort PHONE_NUMBER_TOO_SHORT The phone number contains has too few digits.
reviewMissingVisitTimestamp REVIEW_MISSING_VISIT_TIMESTAMP This listing has a review that is missing a visit timestamp and the timestamp is required in the listing's country. The review should include "servicedate" if using XML markup or "contentReferenceTime" if using schema.org.
testProperty TEST_PROPERTY Vacation rental listing is a test property.
unexpectedAttributeInXml UNEXPECTED_ATTRIBUTE_IN_XML Google encountered an unknown error while importing your Hotel List Feed.
unexpectedPostalCode UNEXPECTED_POSTAL_CODE The address contains a postal code when unsupported by the country's postal code system.
unexpectedPostalCodeSuffix UNEXPECTED_POSTAL_CODE_SUFFIX The address contains a postal code suffix when unsupported by the country's postal code system.
vrAddressIncomplete VR_ADDRESS_INCOMPLETE Deprecated: Replaced with more specifc errors or VR_ADDRESS_INVALID. Google detected that the provided address for this listing is incomplete. For example, it may be missing a unit number.
vrAddressIncompleteNoStreetName VR_ADDRESS_INCOMPLETE_NO_STREET_NAME The provided address is missing a street name.
vrAddressIncompleteNoStreetNumber VR_ADDRESS_INCOMPLETE_NO_STREET_NUMBER The provided address is missing a street number.
vrAddressIncompleteNoUnitNumber VR_ADDRESS_INCOMPLETE_NO_UNIT_NUMBER The provided address is missing a unit number.
vrAddressInvalid VR_ADDRESS_INVALID The provided address is invalid. Review address requirements on the [dev guide](/hotels/vacation-rentals/dev-guide/vr-attributes). Debugging suggestions: 1. Confirm the address does not contain redundant information such as the country in both addr1 and country_code. 2. Use Google Maps to confirm if the address is formatted correctly for its region. 3. Use a [plus code](https://plus.codes) if the address continues to be invalid.
vrAddressLatlongMismatch VR_ADDRESS_LATLONG_MISMATCH The provided address and lat/long data for this listing doesn't match.
vrAddressMissing VR_ADDRESS_MISSING An address should be added to this listing.
vrBrandMissingLandingPage VR_BRAND_MISSING_LANDING_PAGE The brand of this vacation rental property doesn't have a landing page. Contact your account manager for details.
vrInvalidRoomType VR_INVALID_ROOM_TYPE The room type is invalid. Private rooms and shared rooms are part of shared accommodations, which are not currently supported on the platform.
vrLiveOnGoogleInactiveError VR_LIVE_ON_GOOGLE_INACTIVE_ERROR The "Live on Google" setting for this Vacation Rental is set to false. Note: once "Live on Google" is set to true, it will take a few days for this error to disappear.
vrNameTooLong VR_NAME_TOO_LONG Vacation rental listing name is too long.
vrPendingInitialProcessing VR_PENDING_INITIAL_PROCESSING Vacation rental listing is undergoing initial processing.
vrPendingWebsiteCrawling VR_PENDING_WEBSITE_CRAWLING Vacation rental listing has a website link that is still undergoing crawling.
vrWebsiteLinkRoboted VR_WEBSITE_LINK_ROBOTED Vacation rental listing has a website link that is blocked by a robots.txt
vrWebsiteLinkWithCrawlingError VR_WEBSITE_LINK_WITH_CRAWLING_ERROR Vacation rental listing has a website link with a crawling error.
vrXmlFailedParsing VR_XML_FAILED_PARSING This listing's XML failed to parse. Please fix the XML associated with this listing.
vrZipFileCorrupt VR_ZIP_FILE_CORRUPT A listing that indicates the that feed ZIP file is corrupt. Please ensure the ZIP file is valid.

HotelViewLiveOnGoogleStatus

Values HotelView.liveOnGoogleStatus accepts.

TypeSpec name: Googlehotels.HotelViewLiveOnGoogleStatus

MemberWire valueDescription
liveOnGoogleStatusActive LIVE_ON_GOOGLE_STATUS_ACTIVE The property will show on Google unconditionally.
liveOnGoogleStatusActiveOutsideDsaRegion LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION The property will show on Google for users outside of DSA regions. Current regions include: EU.
liveOnGoogleStatusInactive LIVE_ON_GOOGLE_STATUS_INACTIVE The property will not show on Google.
liveOnGoogleStatusUnspecified LIVE_ON_GOOGLE_STATUS_UNSPECIFIED Not specified.

HotelViewMatchStatus

Values HotelView.matchStatus accepts.

TypeSpec name: Googlehotels.HotelViewMatchStatus

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

IconDisapprovalReasons

Values Icon.disapprovalReasons accepts.

TypeSpec name: Googlehotels.IconDisapprovalReasons

MemberWire valueDescription
animated ANIMATED Icon image is animated.
badBackground BAD_BACKGROUND Icon image does not have a transparent or non-white background.
imageDisapprovalReasonUnspecified IMAGE_DISAPPROVAL_REASON_UNSPECIFIED Not specified.
lowQuality LOW_QUALITY Icon image is low quality.
notLikeSite NOT_LIKE_SITE Icon image does not match the favicon or artwork on the advertiser’s final URL.
offensive OFFENSIVE Icon image contains offensive content.
textTooSmall TEXT_TOO_SMALL Icon image contains text that is too small.

IconState

Values Icon.state accepts.

TypeSpec name: Googlehotels.IconState

MemberWire valueDescription
approved APPROVED The icon is approved and is ready for public display. You can link APPROVED icons to brands.
new NEW Google has received the icon and is reviewing its contents.
rejected REJECTED The icon is rejected. Google won't display this icon.
stateUnspecified STATE_UNSPECIFIED Default value.

KeyDeviceType

Values Key.deviceType accepts.

TypeSpec name: Googlehotels.KeyDeviceType

MemberWire valueDescription
desktop DESKTOP Computers.
deviceUnknown DEVICE_UNKNOWN The value is unknown in this version.
deviceUnspecified DEVICE_UNSPECIFIED Not specified.
mobile MOBILE Mobile devices with full browsers.
tablet TABLET Tablets with full browsers.

PriceAccuracyRowDeviceType

Values PriceAccuracyRow.deviceType accepts.

TypeSpec name: Googlehotels.PriceAccuracyRowDeviceType

MemberWire valueDescription
desktop DESKTOP Computers.
deviceUnknown DEVICE_UNKNOWN The value is unknown in this version.
deviceUnspecified DEVICE_UNSPECIFIED Not specified.
mobile MOBILE Mobile devices with full browsers.
tablet TABLET Tablets with full browsers.

PriceAccuracyRowMismatchReason

Values PriceAccuracyRow.mismatchReason accepts.

TypeSpec name: Googlehotels.PriceAccuracyRowMismatchReason

MemberWire valueDescription
discountMissing DISCOUNT_MISSING Discount missing.
incorrectDiscountValue INCORRECT_DISCOUNT_VALUE Incorrect discount value.
mismatchReasonUnknown MISMATCH_REASON_UNKNOWN The value is unknown in this version.
mismatchReasonUnspecified MISMATCH_REASON_UNSPECIFIED Not specified.
priceFeedDelayed PRICE_FEED_DELAYED Price feed delayed.
roomUnavailable ROOM_UNAVAILABLE Room unavailable.
siteError SITE_ERROR Site error.
taxMismatch TAX_MISMATCH Tax mismatch.
wrongItinerary WRONG_ITINERARY Wrong itinerary.

PriceAccuracyRowSignalSource

Values PriceAccuracyRow.signalSource accepts.

TypeSpec name: Googlehotels.PriceAccuracyRowSignalSource

MemberWire valueDescription
fetched FETCHED The price is read directly from the partner's website.
pixel PIXEL The price is provided by the partner via a price accuracy pixel.
signalSourceUnknown SIGNAL_SOURCE_UNKNOWN The value is unknown in this version.
signalSourceUnspecified SIGNAL_SOURCE_UNSPECIFIED Not specified.

PriceCoverageBucketAdvanceBookingWindowRange

Values PriceCoverageBucket.advanceBookingWindowRange accepts.

TypeSpec name: Googlehotels.PriceCoverageBucketAdvanceBookingWindowRange

MemberWire valueDescription
advanceBookingWindowRangeUnknown ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN The value is unknown in this version.
advanceBookingWindowRangeUnspecified ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED Not specified.
days0To30 DAYS_0_TO_30 Represents advance booking window between 0 and 30 days.
days121To150 DAYS_121_TO_150 Represents advance booking window between 121 and 150 days.
days151To180 DAYS_151_TO_180 Represents advance booking window between 151 and 180 days.
days181To210 DAYS_181_TO_210 Represents advance booking window between 181 and 210 days.
days211To240 DAYS_211_TO_240 Represents advance booking window between 211 and 240 days.
days241To270 DAYS_241_TO_270 Represents advance booking window between 241 and 270 days.
days271To300 DAYS_271_TO_300 Represents advance booking window between 271 and 300 days.
days301To330 DAYS_301_TO_330 Represents advance booking window between 301 and 330 days.
days31To60 DAYS_31_TO_60 Represents advance booking window between 31 and 60 days.
days61To90 DAYS_61_TO_90 Represents advance booking window between 61 and 90 days.
days91To120 DAYS_91_TO_120 Represents advance booking window between 91 and 120 days.

PriceCoverageBucketLengthOfStayRange

Values PriceCoverageBucket.lengthOfStayRange accepts.

TypeSpec name: Googlehotels.PriceCoverageBucketLengthOfStayRange

MemberWire valueDescription
lengthOfStay15To30 LENGTH_OF_STAY_15_TO_30 Represents length of stay from 15 to 30 nights.
lengthOfStay1To7 LENGTH_OF_STAY_1_TO_7 Represents length of stay from 1 to 7 nights.
lengthOfStay8To14 LENGTH_OF_STAY_8_TO_14 Represents length of stay from 8 to 14 nights.
lengthOfStayRangeUnknown LENGTH_OF_STAY_RANGE_UNKNOWN The value is unknown in this version.
lengthOfStayRangeUnspecified LENGTH_OF_STAY_RANGE_UNSPECIFIED Not specified.

PropertyPerformanceResultAdvanceBookingWindow

Values PropertyPerformanceResult.advanceBookingWindow accepts.

TypeSpec name: Googlehotels.PropertyPerformanceResultAdvanceBookingWindow

MemberWire valueDescription
advanceBookingWindowDays121To150 ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 Check-in date was 121-150 days after query date.
advanceBookingWindowDays151To180 ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 Check-in date was 151-180 days after query date.
advanceBookingWindowDays15To30 ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 Check-in date was 15-30 days after query date.
advanceBookingWindowDays2To7 ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 Check-in date was 2-7 days after query date.
advanceBookingWindowDays31To60 ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 Check-in date was 31-60 days after query date.
advanceBookingWindowDays61To90 ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 Check-in date was 61-90 days after query date.
advanceBookingWindowDays8To14 ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 Check-in date was 8-14 days after query date.
advanceBookingWindowDays91To120 ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 Check-in date was 91-120 days after query date.
advanceBookingWindowDaysOver180 ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 Check-in date was over 180 days after query date.
advanceBookingWindowNextDay ADVANCE_BOOKING_WINDOW_NEXT_DAY Check-in date was next day after query date.
advanceBookingWindowSameDay ADVANCE_BOOKING_WINDOW_SAME_DAY Check-in date was same as query date.
advanceBookingWindowUnspecified ADVANCE_BOOKING_WINDOW_UNSPECIFIED Not specified.

PropertyPerformanceResultDeviceType

Values PropertyPerformanceResult.deviceType accepts.

TypeSpec name: Googlehotels.PropertyPerformanceResultDeviceType

MemberWire valueDescription
desktop DESKTOP Computers.
deviceUnknown DEVICE_UNKNOWN The value is unknown in this version.
deviceUnspecified DEVICE_UNSPECIFIED Not specified.
mobile MOBILE Mobile devices with full browsers.
tablet TABLET Tablets with full browsers.

PropertyPerformanceResultLengthOfStay

Values PropertyPerformanceResult.lengthOfStay accepts.

TypeSpec name: Googlehotels.PropertyPerformanceResultLengthOfStay

MemberWire valueDescription
lengthOfStayNights1 LENGTH_OF_STAY_NIGHTS_1 Single night stay.
lengthOfStayNights15To21 LENGTH_OF_STAY_NIGHTS_15_TO_21 Stay of 15-21 nights.
lengthOfStayNights2 LENGTH_OF_STAY_NIGHTS_2 Stay of 2 nights.
lengthOfStayNights22To30 LENGTH_OF_STAY_NIGHTS_22_TO_30 Stay of 22-30 nights.
lengthOfStayNights3 LENGTH_OF_STAY_NIGHTS_3 Stay of 3 nights.
lengthOfStayNights4To7 LENGTH_OF_STAY_NIGHTS_4_TO_7 Stay of 4-7 nights.
lengthOfStayNights8To14 LENGTH_OF_STAY_NIGHTS_8_TO_14 Stay of 8-14 nights.
lengthOfStayNightsOver30 LENGTH_OF_STAY_NIGHTS_OVER_30 Stay of over 30 nights.
lengthOfStayUnspecified LENGTH_OF_STAY_UNSPECIFIED Not specified.

PropertyPerformanceResultOccupancy

Values PropertyPerformanceResult.occupancy accepts.

TypeSpec name: Googlehotels.PropertyPerformanceResultOccupancy

MemberWire valueDescription
occupancy1 OCCUPANCY_1 Single person.
occupancy2 OCCUPANCY_2 Two people.
occupancy3 OCCUPANCY_3 Three people.
occupancy4 OCCUPANCY_4 Four people.
occupancyOver4 OCCUPANCY_OVER_4 Over 4 people.
occupancyUnspecified OCCUPANCY_UNSPECIFIED Not specified.

RatingType

Values Rating.type accepts.

TypeSpec name: Googlehotels.RatingType

MemberWire valueDescription
overall OVERALL Rating is of overall type.
typeUnspecified TYPE_UNSPECIFIED Rating type is unspecified.

ReviewType

Values Review.type accepts.

TypeSpec name: Googlehotels.ReviewType

MemberWire valueDescription
editorial EDITORIAL Review is of editorial type.
unknown UNKNOWN Review type is unknown.
user USER Review is of user type.

SetLiveOnGoogleRequestLiveOnGoogleStatus

Values SetLiveOnGoogleRequest.liveOnGoogleStatus accepts.

TypeSpec name: Googlehotels.SetLiveOnGoogleRequestLiveOnGoogleStatus

MemberWire valueDescription
liveOnGoogleStatusActive LIVE_ON_GOOGLE_STATUS_ACTIVE The property will show on Google unconditionally.
liveOnGoogleStatusActiveOutsideDsaRegion LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION The property will show on Google for users outside of DSA regions. Current regions include: EU.
liveOnGoogleStatusInactive LIVE_ON_GOOGLE_STATUS_INACTIVE The property will not show on Google.
liveOnGoogleStatusUnspecified LIVE_ON_GOOGLE_STATUS_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponseCurrentBookOnGoogleScore

Values SummarizePriceAccuracyResponse.currentBookOnGoogleScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentBookOnGoogleScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponseCurrentOverallScore

Values SummarizePriceAccuracyResponse.currentOverallScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentOverallScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponseCurrentScore

Values SummarizePriceAccuracyResponse.currentScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponseCurrentWebsiteScore

Values SummarizePriceAccuracyResponse.currentWebsiteScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentWebsiteScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponsePredictedBookOnGoogleScore

Values SummarizePriceAccuracyResponse.predictedBookOnGoogleScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedBookOnGoogleScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponsePredictedOverallScore

Values SummarizePriceAccuracyResponse.predictedOverallScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedOverallScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponsePredictedScore

Values SummarizePriceAccuracyResponse.predictedScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

SummarizePriceAccuracyResponsePredictedWebsiteScore

Values SummarizePriceAccuracyResponse.predictedWebsiteScore accepts.

TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedWebsiteScore

MemberWire valueDescription
atRisk AT_RISK Average score is close to the account suspension threshold.
excellent EXCELLENT Average score exceeds the positioning threshold.
failed FAILED Average score is below the account suspension threshold.
good GOOD Average score is slightly below the positioning threshold. “Good” has been renamed to “Fair” in Hotel Center.
poor POOR Average score is well below the positioning threshold.
priceAccuracyStateUnknown PRICE_ACCURACY_STATE_UNKNOWN The value is unknown in this version.
priceAccuracyStateUnspecified PRICE_ACCURACY_STATE_UNSPECIFIED Not specified.

Versions

TypeSpec name: Googlehotels.Versions

MemberWire valueDescription
v3 v3 Travel Partner API v3, document revision 20260901.

Scalar aliases

Int64AsString

TypeSpec name: Googlehotels.Int64AsString; base scalar: int64; constraints:

Uint64AsString

TypeSpec name: Googlehotels.Uint64AsString; base scalar: uint64; constraints:

Named unions

No named service-local unions are declared.