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 use 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. Note: This field may not be consistently populated due to technical constraints. If missing, partners should assume a default of 2 adults.

childOccupancy

integer

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.

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 use 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.
Create a Mobile Website
View Site in Mobile | Classic
Share by: