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.
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.
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.
These are deliberate limits of the RDF representation, not silently inferred semantics:
AccountLinkAn account link. Represents the link between a Google Ads customer and a Hotel Ads (Hotel Center) account. An account link defines the set of hotels under the Hotel Center account that is linked to the Google Ads customer.
TypeSpec name: Googlehotels.AccountLink
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
accountLinkTarget |
Googlehotels.AccountLinkTarget |
optional | — | Required for CREATE requests. The properties in the Hotel Center account that can be managed using the linked Google Ads account. |
googleAdsCustomerName |
string |
optional | — | Required for CREATE requests. The value representing the Google Ads customer ID in the format `customers/{google_ads_customer_id}`. For example: `customers/0123456789`. Note that the `googleAdsCustomerName` field is not returned in responses to GET requests. |
name |
string |
optional | — | The resource name for the account link in the format `accounts/{account_id}/accountLinks/{account_link_id}`. |
status |
Googlehotels.AccountLinkStatus |
optional | — | The current status of the account link. |
AccountLinkTargetDefines 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
BrandBrand-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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
CreateReconciliationReportResponseResponse message for ReconciliationReportService.CreateReconciliationReport.
TypeSpec name: Googlehotels.CreateReconciliationReportResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
DataIssueDetailDetails on a data issue in the listing.
TypeSpec name: Googlehotels.DataIssueDetail
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
DateRepresents 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
DisplayNameDisapprovalReasonDisapproval reason of the display name in a specific language.
TypeSpec name: Googlehotels.DisplayNameDisapprovalReason
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
disapprovalReason |
Googlehotels.DisplayNameDisapprovalReasonDisapprovalReason |
optional | — | Disapproval reason. |
languageCode |
string |
optional | — | Language of the disapproved display name. |
EmptyA 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
| 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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 |
GooglehotelsAuthTravel 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
scheme |
"Bearer" |
required in source | — | bearer auth scheme |
type |
unknown |
required in source | — | Http authentication |
HotelListThe properties in the Hotel Center account that can be managed with the Google Ads account.
TypeSpec name: Googlehotels.HotelList
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
partnerHotelIds |
Array<string> |
optional | — | Hotel IDs. |
HotelPricePerItineraryHotel price for a given itinerary.
TypeSpec name: Googlehotels.HotelPricePerItinerary
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
HotelViewA hotel view.
TypeSpec name: Googlehotels.HotelView
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
IconInformation about a partner's icon.
TypeSpec name: Googlehotels.Icon
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ImageA single image in a VR Listing. Title and gallery URL are stored per locale. NEXT ID: 4
TypeSpec name: Googlehotels.Image
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
KeyKey of a result.
TypeSpec name: Googlehotels.Key
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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`. |
LatLngAn 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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]. |
ListAccountLinksResponseResponse message for AccountLinkService.ListAccountLinks.
TypeSpec name: Googlehotels.ListAccountLinksResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
accountLinks |
Array<Googlehotels.AccountLink> |
optional | — | A list of all account links associated with the Hotel Center account being queried. |
ListBrandsResponseResponse message for BrandService.ListBrands.
TypeSpec name: Googlehotels.ListBrandsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ListHotelViewsResponseResponse message for HotelViewService.ListHotelViews.
TypeSpec name: Googlehotels.ListHotelViewsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ListIconsResponseResponse message for IconService.ListIcons.
TypeSpec name: Googlehotels.ListIconsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
icons |
Array<Googlehotels.Icon> |
optional | — | A list of all icons associated with the queried partner account. |
ListPriceAccuracyViewsResponseResponse message for PriceAccuracyViewService.ListPriceAccuracyViews.
TypeSpec name: Googlehotels.ListPriceAccuracyViewsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
priceAccuracyViews |
Array<Googlehotels.PriceAccuracyView> |
optional | — | The list of rows that match the query. |
ListPriceCoverageViewsResponseResponse message for PriceCoverageViewService.ListPriceCoverageViews.
TypeSpec name: Googlehotels.ListPriceCoverageViewsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
priceCoverageViews |
Array<Googlehotels.PriceCoverageView> |
optional | — | Hotel price coverage stats. |
ListReconciliationReportsResponseResponse message for ReconciliationReportService.ListReconciliationReports.
TypeSpec name: Googlehotels.ListReconciliationReportsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
LocalizedTextLocalized variant of a text in a particular language.
TypeSpec name: Googlehotels.LocalizedText
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
MissedParticipationCountDetailsMissed participation count broken down by reason.
TypeSpec name: Googlehotels.MissedParticipationCountDetails
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
NoPriceCountDetailsThe reasons that contributed to the no price count and the total count for each reason.
TypeSpec name: Googlehotels.NoPriceCountDetails
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ParsedListingA parsed listing
TypeSpec name: Googlehotels.ParsedListing
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ParticipationResultRepresents a result from querying for participation stats for an account.
TypeSpec name: Googlehotels.ParticipationResult
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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`. |
PriceAccuracyRowA price accuracy row.
TypeSpec name: Googlehotels.PriceAccuracyRow
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
PriceAccuracyViewA 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
PriceCoverageBucketCoverage stats for one combination of advance booking window and length of stay.
TypeSpec name: Googlehotels.PriceCoverageBucket
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
PriceCoverageViewA 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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). |
PriceMissingCountDetailsThe reasons that contributed to the price missing count and the total count for each reason.
TypeSpec name: Googlehotels.PriceMissingCountDetails
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
PriceProblemCountDetailsThe reasons that contributed to the price problem count and the total count for each reason.
TypeSpec name: Googlehotels.PriceProblemCountDetails
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
PriceRecordA price record.
TypeSpec name: Googlehotels.PriceRecord
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
PriceViewA price view. Covers the Prices functionality in pre-v3.0 API versions.
TypeSpec name: Googlehotels.PriceView
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
name |
string |
optional | — | Resource name in the format `accounts/{account_id}/priceViews/{partner_hotel_id}`. |
perItineraryPrices |
Array<Googlehotels.HotelPricePerItinerary> |
optional | — | Price for each itinerary. |
PropertyPerformanceResultRepresents a result from querying for the property performance report for an account.
TypeSpec name: Googlehotels.PropertyPerformanceResult
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
QueryParticipationReportResponseResponse message for ParticipationReportService.QueryParticipationReport.
TypeSpec name: Googlehotels.QueryParticipationReportResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
QueryPropertyPerformanceReportResponseResponse message for PropertyPerformanceReportService.QueryPropertyPerformanceReport.
TypeSpec name: Googlehotels.QueryPropertyPerformanceReportResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
RatingA rating for a vacation rentals listing. NEXT ID: 4
TypeSpec name: Googlehotels.Rating
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ReconciliationReportReconciliation 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 field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ReconciliationReportValidationIssueRepresents an issue encountered when validating a reconciliation report.
TypeSpec name: Googlehotels.ReconciliationReportValidationIssue
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ReviewA single review in a VR Listing. NEXT ID: 10
TypeSpec name: Googlehotels.Review
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
SetLiveOnGoogleRequestRequest message for HotelService.SetLiveOnGoogle.
TypeSpec name: Googlehotels.SetLiveOnGoogleRequest
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
SetLiveOnGoogleResponseResponse message for HotelService.SetLiveOnGoogle.
TypeSpec name: Googlehotels.SetLiveOnGoogleResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
failedHotelIds |
Array<string> |
optional | — | Identifies properties that Google could not update. |
updatedHotelIds |
Array<string> |
optional | — | Identifies the updated properties. |
SummarizeHotelViewsResponseResponse message for HotelViewService.SummarizeHotelViews.
TypeSpec name: Googlehotels.SummarizeHotelViewsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
SummarizePriceAccuracyResponseResponse message for PriceAccuracyViewService.SummarizePriceAccuracy.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
ValidateReconciliationReportResponseResponse message for ReconciliationReportService.ValidateReconciliationReport.
TypeSpec name: Googlehotels.ValidateReconciliationReportResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
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. |
VerifyListingsRequestRequest message for VRPartnerListingVerificationService.VerifyPartnerListings.
TypeSpec name: Googlehotels.VerifyListingsRequest
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
xmlListing |
string |
optional | — | A listing that follows the XML format specified in https://developers.google.com/hotels/hotel-prices/xml-reference/hotel-list-feed. |
VerifyListingsResponseResponse message for VRPartnerListingVerificationService.VerifyPartnerListings.
TypeSpec name: Googlehotels.VerifyListingsResponse
| Wire field | Source type | Presence | Source constraints | Description |
|---|---|---|---|---|
parsedListing |
Googlehotels.ParsedListing |
optional | — | The parsed listing output. |
AccountLinkStatusValues AccountLink.status accepts.
TypeSpec name: Googlehotels.AccountLinkStatus
| Member | Wire value | Description |
|---|---|---|
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. |
BrandDisplayNameStateValues Brand.displayNameState accepts.
TypeSpec name: Googlehotels.BrandDisplayNameState
| Member | Wire value | Description |
|---|---|---|
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. |
BrandIconDisapprovalReasonsValues Brand.iconDisapprovalReasons accepts.
TypeSpec name: Googlehotels.BrandIconDisapprovalReasons
| Member | Wire value | Description |
|---|---|---|
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. |
BrandIconStateValues Brand.iconState accepts.
TypeSpec name: Googlehotels.BrandIconState
| Member | Wire value | Description |
|---|---|---|
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. |
DataIssueDetailDataIssueSeverityValues DataIssueDetail.dataIssueSeverity accepts.
TypeSpec name: Googlehotels.DataIssueDetailDataIssueSeverity
| Member | Wire value | Description |
|---|---|---|
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. |
DataIssueDetailDataIssueTypeValues DataIssueDetail.dataIssueType accepts.
TypeSpec name: Googlehotels.DataIssueDetailDataIssueType
| Member | Wire value | Description |
|---|---|---|
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. |
DisplayNameDisapprovalReasonDisapprovalReasonValues DisplayNameDisapprovalReason.disapprovalReason accepts.
TypeSpec name: Googlehotels.DisplayNameDisapprovalReasonDisapprovalReason
| Member | Wire value | Description |
|---|---|---|
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. |
FreeBookingLinksResultDeviceTypeValues FreeBookingLinksResult.deviceType accepts.
TypeSpec name: Googlehotels.FreeBookingLinksResultDeviceType
| Member | Wire value | Description |
|---|---|---|
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. |
HotelViewDataIssuesValues HotelView.dataIssues accepts.
TypeSpec name: Googlehotels.HotelViewDataIssues
| Member | Wire value | Description |
|---|---|---|
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. |
HotelViewLiveOnGoogleStatusValues HotelView.liveOnGoogleStatus accepts.
TypeSpec name: Googlehotels.HotelViewLiveOnGoogleStatus
| Member | Wire value | Description |
|---|---|---|
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. |
HotelViewMatchStatusValues HotelView.matchStatus accepts.
TypeSpec name: Googlehotels.HotelViewMatchStatus
| Member | Wire value | Description |
|---|---|---|
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. |
IconDisapprovalReasonsValues Icon.disapprovalReasons accepts.
TypeSpec name: Googlehotels.IconDisapprovalReasons
| Member | Wire value | Description |
|---|---|---|
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. |
IconStateValues Icon.state accepts.
TypeSpec name: Googlehotels.IconState
| Member | Wire value | Description |
|---|---|---|
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. |
KeyDeviceTypeValues Key.deviceType accepts.
TypeSpec name: Googlehotels.KeyDeviceType
| Member | Wire value | Description |
|---|---|---|
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. |
PriceAccuracyRowDeviceTypeValues PriceAccuracyRow.deviceType accepts.
TypeSpec name: Googlehotels.PriceAccuracyRowDeviceType
| Member | Wire value | Description |
|---|---|---|
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. |
PriceAccuracyRowMismatchReasonValues PriceAccuracyRow.mismatchReason accepts.
TypeSpec name: Googlehotels.PriceAccuracyRowMismatchReason
| Member | Wire value | Description |
|---|---|---|
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. |
PriceAccuracyRowSignalSourceValues PriceAccuracyRow.signalSource accepts.
TypeSpec name: Googlehotels.PriceAccuracyRowSignalSource
| Member | Wire value | Description |
|---|---|---|
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. |
PriceCoverageBucketAdvanceBookingWindowRangeValues PriceCoverageBucket.advanceBookingWindowRange accepts.
TypeSpec name: Googlehotels.PriceCoverageBucketAdvanceBookingWindowRange
| Member | Wire value | Description |
|---|---|---|
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. |
PriceCoverageBucketLengthOfStayRangeValues PriceCoverageBucket.lengthOfStayRange accepts.
TypeSpec name: Googlehotels.PriceCoverageBucketLengthOfStayRange
| Member | Wire value | Description |
|---|---|---|
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. |
PropertyPerformanceResultAdvanceBookingWindowValues PropertyPerformanceResult.advanceBookingWindow accepts.
TypeSpec name: Googlehotels.PropertyPerformanceResultAdvanceBookingWindow
| Member | Wire value | Description |
|---|---|---|
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. |
PropertyPerformanceResultDeviceTypeValues PropertyPerformanceResult.deviceType accepts.
TypeSpec name: Googlehotels.PropertyPerformanceResultDeviceType
| Member | Wire value | Description |
|---|---|---|
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. |
PropertyPerformanceResultLengthOfStayValues PropertyPerformanceResult.lengthOfStay accepts.
TypeSpec name: Googlehotels.PropertyPerformanceResultLengthOfStay
| Member | Wire value | Description |
|---|---|---|
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. |
PropertyPerformanceResultOccupancyValues PropertyPerformanceResult.occupancy accepts.
TypeSpec name: Googlehotels.PropertyPerformanceResultOccupancy
| Member | Wire value | Description |
|---|---|---|
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. |
RatingTypeValues Rating.type accepts.
TypeSpec name: Googlehotels.RatingType
| Member | Wire value | Description |
|---|---|---|
overall |
OVERALL |
Rating is of overall type. |
typeUnspecified |
TYPE_UNSPECIFIED |
Rating type is unspecified. |
ReviewTypeValues Review.type accepts.
TypeSpec name: Googlehotels.ReviewType
| Member | Wire value | Description |
|---|---|---|
editorial |
EDITORIAL |
Review is of editorial type. |
unknown |
UNKNOWN |
Review type is unknown. |
user |
USER |
Review is of user type. |
SetLiveOnGoogleRequestLiveOnGoogleStatusValues SetLiveOnGoogleRequest.liveOnGoogleStatus accepts.
TypeSpec name: Googlehotels.SetLiveOnGoogleRequestLiveOnGoogleStatus
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponseCurrentBookOnGoogleScoreValues SummarizePriceAccuracyResponse.currentBookOnGoogleScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentBookOnGoogleScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponseCurrentOverallScoreValues SummarizePriceAccuracyResponse.currentOverallScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentOverallScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponseCurrentScoreValues SummarizePriceAccuracyResponse.currentScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponseCurrentWebsiteScoreValues SummarizePriceAccuracyResponse.currentWebsiteScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponseCurrentWebsiteScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponsePredictedBookOnGoogleScoreValues SummarizePriceAccuracyResponse.predictedBookOnGoogleScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedBookOnGoogleScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponsePredictedOverallScoreValues SummarizePriceAccuracyResponse.predictedOverallScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedOverallScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponsePredictedScoreValues SummarizePriceAccuracyResponse.predictedScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedScore
| Member | Wire value | Description |
|---|---|---|
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. |
SummarizePriceAccuracyResponsePredictedWebsiteScoreValues SummarizePriceAccuracyResponse.predictedWebsiteScore accepts.
TypeSpec name: Googlehotels.SummarizePriceAccuracyResponsePredictedWebsiteScore
| Member | Wire value | Description |
|---|---|---|
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. |
VersionsTypeSpec name: Googlehotels.Versions
| Member | Wire value | Description |
|---|---|---|
v3 |
v3 |
Travel Partner API v3, document revision 20260901. |
Int64AsStringTypeSpec name: Googlehotels.Int64AsString; base scalar: int64; constraints: —
Uint64AsStringTypeSpec name: Googlehotels.Uint64AsString; base scalar: uint64; constraints: —
No named service-local unions are declared.