Required for CREATE requests. The properties in the Hotel Center account that can be managed using the linked Google Ads account.
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.
The resource name for the account link in the format `accounts/{account_id}/accountLinks/{account_link_id}`.
True if all properties under the Hotel Center account are made available to the account link. The default is `false`.
List of properties that is made available to the account link.
Output only. The number of properties with the corresponding brand ID.
Output only. The brand's icon's review state. If there are both submitted and active icons, this refers to the submitted icon.
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.
Output only. The icon's disapproval reason(s). Only applies to submitted icons with `REJECTED` state.
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}`.
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.
Output only. Display name's disapproval reason. Only applies to display names with the review state 'REJECTED'.
Output only. The brand's active display names in all provided languages, only present if the display name is approved for all provided languages.
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.
Output only. URL of the active icon, only present when the icon has been approved.
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.
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.
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.
Language of the disapproved display name.
Localized string in the language corresponding to language_code below.
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.
Issues that were encountered when validating the file.
The number of commission records that were successfully saved.
Resource name of the new reconciliation report. The format is `accounts/{account_id}`.
Text description of the issue, typically including what was seen and why it was invalid.
The line number on which the issue was detected. If this field is 0, the issue applies to the whole file.
Name of the invalid field. If no field name is given, this issue applies to the whole line (or file).
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.
Required. Desired filename of the reconciliation report.
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).
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.
Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
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.
Partner's hotel ID. Only present if `partnerHotelId` is specified in `aggregateBy` in the request.
A date within the requested date range. Only present if `date` is specified in `aggregateBy` in the request.
Partner's hotel name. Only present if `partnerHotelDisplayName` is specified in `aggregateBy` in the request.
The user’s device type. Only present if `deviceType` is specified in `aggregateBy` in the request.
The total number of clicks that were recorded for this result.
ISO 3116 region code of the country/region of the user. Only present if `userRegionCode` is specified in `aggregateBy` in the request
Currency for `price`, `taxes`, and `fees`.
The unique ID of the hotel that the partner provides in their Hotel List Feed.
Optional. A URL to the property on Google. Only available for properties that are listed.
The primary hotel in the overclustered set.
Optional. Whether the hotel appears in Google's hotel booking links. Declaration & behavior to get detection of presence/absence in JSON conversion.
The reasons why a hotel failed to match to a property on Maps.
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.
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.
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.
The Google Maps identifier for the hotel.
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.
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.
Output only. The icon's disapproval reason(s). Only applies to icons with `REJECTED` state.
Output only. The approved icon's Google-hosted URI. Only applies to icons with `APPROVED` state.
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.
Required. Input only. The icon contents, which must be in PNG format, or convertible to PNG.
URL that is deeplink to the image in a gallery (or a webpage).
URL that points to the binary image content directly.
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`.
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`.
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`.
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`.
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`.
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`.
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`.
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`.
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`.
The longitude in degrees. It must be in the range [-180.0, +180.0].
The latitude in degrees. It must be in the range [-90.0, +90.0].
A list of all account links associated with the Hotel Center account being queried.
A list of brands for the current page associated with the Hotel Center account being queried.
Token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
Pagination token used to retrieve the next page of results.
A list of all icons associated with the queried partner account.
Resource name should be in the format `accounts/{account_id}/priceAccuracyViews/{report_date}`.
The reason why the fetched price didn't match the cached price.
The rate rule of the advertised price for non-public rates.
The domain of the final page from which prices are read.
The country of the hotel (based on address).
Time at which an incorrect price is updated to a correct price.
Initial URL visited on the partner website.
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.
True if this row affects the overall price accuracy score.
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.
Price coverage stats for combinations of advance booking window and length of stay ranges.
The ratio between the number of hotels which have at least one price for the calculation period and `matched_property_count`.
The total number of properties that have prices for the given itineraries.
The date on which the calculations were made.
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).
The percent of itineraries for which you have coverage for this advance booking window bucket and length of stay bucket.
Number of prices for this advance booking window bucket and length of stay bucket.
The list of names of reconciliation reports. Note that the `contents` and `fileName` fields of each `ReconciliationReport` object are not returned by this call.
The reasons that contributed to the price unavailable count.
The reasons that contributed to the no price count (for example, live pricing not available) and the total count for each reason.
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
The total number of missed participation due to one or more of your hotels not specifying taxes and fees separately.
The reasons that contributed to the price missing count.
The total number of missed participations due to one or more of your hotels being suspended due to price accuracy violations.
Hotel did not participate for an unknown reason.
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.
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
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
The reasons that contributed to the price problem count.
The total number of missed participations due to a price not being offered for the requested itinerary.
No price was cached for this itinerary, and no live query was done because your server usually tells us the hotel is unavailable or sold out.
Hotel did not participate because it wasn't available for the itinerary dates.
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.
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.
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.
The number of missed participations due to other issues with live pricing.
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.
No price was cached for this itinerary. A live query did not time out, but your system returned an error.
No price exists in the cache for this itinerary. A live query was not done due to page constraints.
No price was cached for this itinerary, and live query was not configured for this account.
No price was cached for this itinerary, and there was no live query quota remaining.
No price was cached for this itinerary, and a live query sent to your system timed out.
The itinerary was outside of your basic parameters, so no price was pulled for the itinerary from either live query or cache fill.
Taxes and fees were missing from pricing.
Base price too low relative to total price.
The price given for this itinerary seemed oddly high compared to regional trends.
The hotel was suspended. This may be due to persistent problems in areas such as incorrect taxes and fees.
The price given for this itinerary seemed oddly low compared to regional trends.
Represents the accuracy of the location. The listing can be anywhere within the defined circular area.
The list ID on partner LEC feed, provided by partner.
Location of listing using latitude and longitude (degrees).
Reviews associated with this listing. Each review has a single language attached to it.
If not empty, it indicates that this listing belongs to a brand of the feed.
Images associated with this listing, localized.
The partner provided category (accommodation type) of the property.
Whether the listing can be served based on non image data alone.
The country code where the listing is located.
The title of the review, for example: Great three bedrooms.
Language of the review in ISO639 format, such as "en", "de", etc.
Unix timestamp (in seconds) of the review, in UTC+0.
Unix timestamp (in seconds) of when the stay was, in UTC+0.
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.
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%.
The total number of opportunities for which you were eligible to enter in the Google Ads auction process.
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
Partner's hotel display name. This field is only populated when the result is aggregated by `partnerHotelId`.
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.
The reasons that contributed to the missed participation count (for example, no availability) and a total count for each reason.
Resource name in the format `accounts/{account_id}/priceViews/{partner_hotel_id}`.
ISO 3116 region code of the country/region of the property. Only present if `propertyRegionCode` is specified in `aggregateBy` in the request
The total number of ad impressions that were recorded for this result.
Equal to `ads_click_count` divided by `ads_impression_count`.
The total number of clicks on the "Website" button on Google for vacation rentals.
Requested number of people staying at the property. Only present if `partnerPropertyId` is specified in `aggregateBy` in the request.
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.
Partner-specified brand for the property. Only present if `brand` is specified in `aggregateBy` in the request.
Partner's property name. Only present if `partnerPropertyDisplayName` is specified in `aggregateBy` in the request.
The total number of ad clicks that were recorded for this result.
The total number of free booking link clicks that were recorded for this result.
Whether the user’s query indicated a strong interest in booking. Only present if `highIntentUsers` is specified in `aggregateBy` in the request.
The total number of free booking link impressions that were recorded for this result. This value is rounded to preserve user privacy.
Number of nights between check-in and check-out dates specified by user. Only present if `lengthOfStay` is specified in `aggregateBy` in the request.
Partner's property ID. Only present if `partnerPropertyId` is specified in `aggregateBy` in the request.
Equal to `click_count` divided by `impression_count`.
The list of results that match the query.
Pagination token used to retrieve the next page of results. If this field is omitted, there are no subsequent pages.
The list of results that matches the query.
Required. Identifies the properties to update with the liveOnGoogle setting.
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"`.
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.
Identifies properties that Google could not update.
Timestamp of the last hotel manifest update.
Timestamp of the last hotel feed submission.
The number of unmatched properties that have data-related errors.
The number of hotels that are considered overclustered.
overclustered property with errors count
The number of overclustered properties that have data-related errors.
The number of properties that are considered unmatched.
The number of properties that match Google's manifest.
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.
The predicted Book on Google price accuracy score.
The current Book on Google price accuracy score.
The current price accuracy score combining both website and Book on Google scores.
The predicted price accuracy score combining both website and Book on Google scores.
The update timestamp for the current score.
The current website price accuracy score.
The predicted website price accuracy score.
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.
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.
The number of commission records that were successfully validated.
A listing that follows the XML format specified in https://developers.google.com/hotels/hotel-prices/xml-reference/hotel-list-feed.
SELECT $this ?key WHERE { $this <https://relay.inferal.com/ontology/googlehotels/record/Googlehotels.ParsedListing/unitAttributes/entry> ?left, ?right . FILTER(?left != ?right) ?left <https://relay.inferal.com/ontology/googlehotels/record/Googlehotels.ParsedListing/unitAttributes/key> ?key . ?right <https://relay.inferal.com/ontology/googlehotels/record/Googlehotels.ParsedListing/unitAttributes/key> ?key . }