REST Resource: accounts.priceAccuracyViews

  • The PriceAccuracyView resource covers price accuracy reports and provides a list of rows matching a query.

  • Each PriceAccuracyRow contains details about a price accuracy event including hotel, dates, fetched and cached prices, device type, and reason for price mismatch.

  • A PriceRecord includes the base price, taxes and fees, currency code, and a timestamp.

  • The API defines specific enums for Device types, Mismatch Reasons for price discrepancies, and Signal Sources for price accuracy data.

  • Methods available include retrieving a specific price accuracy view, listing available views, and summarizing price accuracy.

Resource: PriceAccuracyView

A price accuracy view. Covers the price accuracy reports functionality in pre-v3.0 API versions. For more information, refer to Price Accuracy report.

JSON representation 
{
  "name": string,
  "results": [
    {
      object (PriceAccuracyRow)
    }
  ]
}
Fields
name

string

Resource name should be in the format accounts/{account_id}/priceAccuracyViews/{report_date}.
results[]

object (PriceAccuracyRow)

The list of rows that match the query.

PriceAccuracyRow

A price accuracy row.

JSON representation 
{
  "hotel": string,
  "checkinDate": {
    object (Date)
  },
  "lengthOfStayDays": integer,
  "fetchedPriceRecord": {
    object (PriceRecord)
  },
  "cachedPriceRecord": {
    object (PriceRecord)
  },
  "correctionTime": string,
  "url": string,
  "rateRuleId": string,
  "hotelCountryCode": string,
  "deviceType": enum (Device),
  "finalDomain": string,
  "mismatchReason": enum (MismatchReason),
  "affectsScore": boolean,
  "signalSource": enum (SignalSource),
  "userRegionCode": string,
  "adultOccupancy": integer,
  "childOccupancy": integer
}
Fields
hotel

string

Partner-defined hotel ID.
checkinDate

object (Date)

Check-in date.
lengthOfStayDays

integer

Length of stay.
fetchedPriceRecord

object (PriceRecord)

Price as read from the partner website.
cachedPriceRecord

object (PriceRecord)

Price as advertised.
correctionTime

string (Timestamp format)

Time at which an incorrect price is updated to a correct price.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
url

string

Initial URL visited on the partner website.
rateRuleId

string

The rate rule of the advertised price for non-public rates.
hotelCountryCode

string

The country of the hotel (based on address).
deviceType

enum (Device)

The user's device type.
finalDomain

string

The domain of the final page from which prices are read.
mismatchReason

enum (MismatchReason)

The reason why the fetched price didn't match the cached price.
affectsScore

boolean

True if this row affects the overall price accuracy score.
signalSource

enum (SignalSource)

Source of the price accuracy signal.
userRegionCode

string

The user's region.
adultOccupancy

integer

The number of adults in the occupancy details of the validation query.
childOccupancy

integer

The number of children in the occupancy details of the validation query.

PriceRecord

A price record.

JSON representation 
{
  "basePrice": number,
  "taxesAndFees": number,
  "currencyCode": string,
  "time": string
}
Fields
basePrice

number

Base price.
taxesAndFees

number

Taxes and fees.
currencyCode

string

ISO 4217 currency code.
time

string (Timestamp format)

Timestamp of this price record.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

Device

Enumerates supported devices.

Enums
DEVICE_UNSPECIFIED Not specified.
DEVICE_UNKNOWN The value is unknown in this version.
DESKTOP Computers.
MOBILE Mobile devices with full browsers.
TABLET Tablets with full browsers.

MismatchReason

Enumerates mismatch reasons.

Enums
MISMATCH_REASON_UNSPECIFIED Not specified.
MISMATCH_REASON_UNKNOWN The value is unknown in this version.
TAX_MISMATCH Tax mismatch.
ROOM_UNAVAILABLE Room unavailable.
SITE_ERROR Site error.
PRICE_FEED_DELAYED Price feed delayed.
DISCOUNT_MISSING Discount missing.
INCORRECT_DISCOUNT_VALUE Incorrect discount value.
WRONG_ITINERARY Wrong itinerary.

SignalSource

Enumerates supported signaling methods for price accuracy.

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

Methods

get

 Returns the requested price accuracy view in full detail.

list

 Lists the available price accuracy views.

summarize

 Returns the price accuracy summary.