REST Resource: accounts.priceCoverageViews

Resource: PriceCoverageView

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

JSON representation
{
  "calculationDate": {
    object (Date)
  },
  "matchedPropertyCount": integer,
  "priceCoverageBinaryPercent": number,
  "priceCoveragePercent": number,
  "priceCoverageBuckets": [
    {
      object (PriceCoverageBucket)
    }
  ]
}
Fields
calculationDate

object (Date)

The date on which the calculations were made.

matchedPropertyCount

integer

The total number of properties that have prices for the given itineraries.

priceCoverageBinaryPercent

number

The ratio between the number of hotels which have at least one price for the calculation period and matchedPropertyCount.

priceCoveragePercent

number

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 matchedPropertyCount times 330 (for advance book window) times 30 (for length of stay).

priceCoverageBuckets[]

object (PriceCoverageBucket)

Price coverage stats for combinations of advance booking window and length of stay ranges.

PriceCoverageBucket

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

JSON representation
{
  "advanceBookingWindowRange": enum (AdvanceBookingWindowRange),
  "lengthOfStayRange": enum (LengthOfStayRange),
  "availablePriceCount": string,
  "priceCoveragePercent": number
}
Fields
advanceBookingWindowRange

enum (AdvanceBookingWindowRange)

Advance booking window range.

lengthOfStayRange

enum (LengthOfStayRange)

Length of stay range.

availablePriceCount

string (int64 format)

Number of prices for this advance booking window bucket and length of stay bucket.

priceCoveragePercent

number

The percent of itineraries for which you have coverage for this advance booking window bucket and length of stay bucket.

AdvanceBookingWindowRange

Enumerates booking window ranges.

Enums
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED Not specified.
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN The value is unknown in this version.
DAYS_0_TO_30 Represents advance booking window between 0 and 30 days.
DAYS_31_TO_60 Represents advance booking window between 31 and 60 days.
DAYS_61_TO_90 Represents advance booking window between 61 and 90 days.
DAYS_91_TO_120 Represents advance booking window between 91 and 120 days.
DAYS_121_TO_150 Represents advance booking window between 121 and 150 days.
DAYS_151_TO_180 Represents advance booking window between 151 and 180 days.
DAYS_181_TO_210 Represents advance booking window between 181 and 210 days.
DAYS_211_TO_240 Represents advance booking window between 211 and 240 days.
DAYS_241_TO_270 Represents advance booking window between 241 and 270 days.
DAYS_271_TO_300 Represents advance booking window between 271 and 300 days.
DAYS_301_TO_330 Represents advance booking window between 301 and 330 days.

LengthOfStayRange

Enumerates length of stay ranges.

Enums
LENGTH_OF_STAY_RANGE_UNSPECIFIED Not specified.
LENGTH_OF_STAY_RANGE_UNKNOWN The value is unknown in this version.
LENGTH_OF_STAY_1_TO_7 Represents length of stay from 1 to 7 nights.
LENGTH_OF_STAY_8_TO_14 Represents length of stay from 8 to 14 nights.
LENGTH_OF_STAY_15_TO_30 Represents length of stay from 15 to 30 nights.

Methods

getLatest

Returns the latest price coverage view in full detail.

list

Returns the entire price coverage history.