REST Resource: accounts.priceCoverageViews
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: PriceCoberturaView
Representación JSON |
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
Campos |
calculationDate |
object (Date )
La fecha en que se realizaron los cálculos.
|
matchedPropertyCount |
integer
La cantidad total de propiedades que tienen precios para los itinerarios especificados.
|
priceCoverageBinaryPercent |
number
La proporción entre la cantidad de hoteles que tienen, al menos, un precio para el período de cálculo y matchedPropertyCount .
|
priceCoveragePercent |
number
Es la cobertura de precios general de una cuenta. Este valor es la proporción entre la cantidad de precios de hoteles para el período de reserva de cálculo y la duración del rango de estadía dividida por la cantidad de precios posibles, que es matchedPropertyCount por 330 (para la ventana de reserva anticipada) por 30 (para la duración de la estadía).
|
priceCoverageBuckets[] |
object (PriceCoverageBucket )
Estadísticas de cobertura de precios para combinaciones de períodos de reserva anticipada y duración de los intervalos de estadía.
|
Cobertura de precios
Estadísticas de cobertura para una combinación del período de reserva anticipada y la duración de la estadía.
Campos |
advanceBookingWindowRange |
enum (AdvanceBookingWindowRange )
Período de reserva anticipada.
|
lengthOfStayRange |
enum (LengthOfStayRange )
Duración del rango de estadía.
|
availablePriceCount |
string (int64 format)
Cantidad de precios para este bucket de período de reserva anticipada y duración del bucket de estadía.
|
priceCoveragePercent |
number
El porcentaje de itinerarios sobre los que tienes cobertura para este bucket del período de reserva anticipada y la duración del bucket de estadía.
|
Período de reserva anticipada
Enumera los rangos del período de reserva.
Enumeradores |
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED |
No se especifica. |
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN |
El valor es desconocido en esta versión. |
DAYS_0_TO_30 |
Representa el período de reserva anticipada entre 0 y 30 días. |
DAYS_31_TO_60 |
Representa el período de reserva anticipada entre 31 y 60 días. |
DAYS_61_TO_90 |
Representa el período de reserva anticipada entre 61 y 90 días. |
DAYS_91_TO_120 |
Representa el período de reserva anticipada entre 91 y 120 días. |
DAYS_121_TO_150 |
Representa el período de reserva anticipada entre 121 y 150 días. |
DAYS_151_TO_180 |
Representa el período de reserva anticipada entre 151 y 180 días. |
DAYS_181_TO_210 |
Representa el período de reserva anticipada entre 181 y 210 días. |
DAYS_211_TO_240 |
Representa el período de reserva anticipada entre 211 y 240 días. |
DAYS_241_TO_270 |
Representa el período de reserva anticipada entre 241 y 270 días. |
DAYS_271_TO_300 |
Representa el período de reserva anticipada entre 271 y 300 días. |
DAYS_301_TO_330 |
Representa el período de reserva anticipada entre 301 y 330 días. |
Duración de la estadía
Enumera la longitud de los rangos de estadía.
Enumeradores |
LENGTH_OF_STAY_RANGE_UNSPECIFIED |
No se especifica. |
LENGTH_OF_STAY_RANGE_UNKNOWN |
El valor es desconocido en esta versión. |
LENGTH_OF_STAY_1_TO_7 |
Representa la duración de la estadía de 1 a 7 noches. |
LENGTH_OF_STAY_8_TO_14 |
Representa la duración de la estadía de 8 a 14 noches. |
LENGTH_OF_STAY_15_TO_30 |
Representa la duración de la estadía de 15 a 30 noches. |
Métodos |
|
Muestra la vista de cobertura de precios más reciente en detalle. |
|
Muestra el historial de cobertura de precios completo. |
Todos los derechos reservados. Java es una marca comercial de Oracle o sus afiliados.
Última actualización: 2022-08-23 (UTC)
[null,null,["Última actualización: 2022-08-23 (UTC)"],[[["\u003cp\u003e\u003ccode\u003ePriceCoverageView\u003c/code\u003e provides insights into your hotel price coverage across different booking windows and lengths of stay, aiding in identifying potential areas for improvement to maximize visibility and bookings.\u003c/p\u003e\n"],["\u003cp\u003eIt includes key metrics like overall price coverage percentage, a breakdown of coverage by booking window and length of stay ranges, and the number of properties with available prices.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAdvanceBookingWindowRange\u003c/code\u003e and \u003ccode\u003eLengthOfStayRange\u003c/code\u003e enums further categorize the data for detailed analysis of price coverage patterns.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the latest price coverage view or the entire history through the provided methods: \u003ccode\u003egetLatest\u003c/code\u003e and \u003ccode\u003elist\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# REST Resource: accounts.priceCoverageViews\n\n- [Resource: PriceCoverageView](#PriceCoverageView)\n - [JSON representation](#PriceCoverageView.SCHEMA_REPRESENTATION)\n- [PriceCoverageBucket](#PriceCoverageBucket)\n - [JSON representation](#PriceCoverageBucket.SCHEMA_REPRESENTATION)\n- [AdvanceBookingWindowRange](#AdvanceBookingWindowRange)\n- [LengthOfStayRange](#LengthOfStayRange)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PriceCoverageView\n---------------------------\n\nA 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](//support.google.com/hotelprices/answer/6317686).\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"calculationDate\": { object (/hotels/hotel-prices/api-reference/rest/v3/Date) }, \"matchedPropertyCount\": integer, \"priceCoverageBinaryPercent\": number, \"priceCoveragePercent\": number, \"priceCoverageBuckets\": [ { object (/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews#PriceCoverageBucket) } ] } ``` |\n\n| Fields ||\n|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `calculationDate` | `object (`[Date](/hotels/hotel-prices/api-reference/rest/v3/Date)`)` The date on which the calculations were made. |\n| `matchedPropertyCount` | `integer` The total number of properties that have prices for the given itineraries. |\n| `priceCoverageBinaryPercent` | `number` The ratio between the number of hotels which have at least one price for the calculation period and `matchedPropertyCount`. |\n| `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). |\n| `priceCoverageBuckets[]` | `object (`[PriceCoverageBucket](/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews#PriceCoverageBucket)`)` Price coverage stats for combinations of advance booking window and length of stay ranges. |\n\nPriceCoverageBucket\n-------------------\n\nCoverage stats for one combination of advance booking window and length of stay.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"advanceBookingWindowRange\": enum (/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews#AdvanceBookingWindowRange), \"lengthOfStayRange\": enum (/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews#LengthOfStayRange), \"availablePriceCount\": string, \"priceCoveragePercent\": number } ``` |\n\n| Fields ||\n|-----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advanceBookingWindowRange` | `enum (`[AdvanceBookingWindowRange](/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews#AdvanceBookingWindowRange)`)` Advance booking window range. |\n| `lengthOfStayRange` | `enum (`[LengthOfStayRange](/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews#LengthOfStayRange)`)` Length of stay range. |\n| `availablePriceCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of prices for this advance booking window bucket and length of stay bucket. |\n| `priceCoveragePercent` | `number` The percent of itineraries for which you have coverage for this advance booking window bucket and length of stay bucket. |\n\nAdvanceBookingWindowRange\n-------------------------\n\nEnumerates booking window ranges.\n\n| Enums ||\n|--------------------------------------------|-------------------------------------------------------------|\n| `ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED` | Not specified. |\n| `ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN` | The value is unknown in this version. |\n| `DAYS_0_TO_30` | Represents advance booking window between 0 and 30 days. |\n| `DAYS_31_TO_60` | Represents advance booking window between 31 and 60 days. |\n| `DAYS_61_TO_90` | Represents advance booking window between 61 and 90 days. |\n| `DAYS_91_TO_120` | Represents advance booking window between 91 and 120 days. |\n| `DAYS_121_TO_150` | Represents advance booking window between 121 and 150 days. |\n| `DAYS_151_TO_180` | Represents advance booking window between 151 and 180 days. |\n| `DAYS_181_TO_210` | Represents advance booking window between 181 and 210 days. |\n| `DAYS_211_TO_240` | Represents advance booking window between 211 and 240 days. |\n| `DAYS_241_TO_270` | Represents advance booking window between 241 and 270 days. |\n| `DAYS_271_TO_300` | Represents advance booking window between 271 and 300 days. |\n| `DAYS_301_TO_330` | Represents advance booking window between 301 and 330 days. |\n\nLengthOfStayRange\n-----------------\n\nEnumerates length of stay ranges.\n\n| Enums ||\n|------------------------------------|-------------------------------------------------|\n| `LENGTH_OF_STAY_RANGE_UNSPECIFIED` | Not specified. |\n| `LENGTH_OF_STAY_RANGE_UNKNOWN` | The value is unknown in this version. |\n| `LENGTH_OF_STAY_1_TO_7` | Represents length of stay from 1 to 7 nights. |\n| `LENGTH_OF_STAY_8_TO_14` | Represents length of stay from 8 to 14 nights. |\n| `LENGTH_OF_STAY_15_TO_30` | Represents length of stay from 15 to 30 nights. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------------|--------------------------------------------------------|\n| ### [getLatest](/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews/getLatest) | Returns the latest price coverage view in full detail. |\n| ### [list](/hotels/hotel-prices/api-reference/rest/v3/accounts.priceCoverageViews/list) | Returns the entire price coverage history. |"]]