REST Resource: accounts.priceCoverageViews
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: PriceCoverageView
Representação JSON |
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
Campos |
calculationDate |
object (Date )
A data em que os cálculos foram feitos.
|
matchedPropertyCount |
integer
O número total de propriedades com preços para os itinerários fornecidos.
|
priceCoverageBinaryPercent |
number
A proporção entre o número de hotéis com pelo menos um preço para o período de cálculo e matchedPropertyCount .
|
priceCoveragePercent |
number
A cobertura geral de preços para uma conta. Esse valor é a proporção entre o número de preços de hotéis para a janela de reserva de cálculo e a duração da estadia, dividido pelo número de todos os preços possíveis, que é matchedPropertyCount vezes 330 (para uma janela de reserva futura) vezes 30 (para a duração da estadia).
|
priceCoverageBuckets[] |
object (PriceCoverageBucket )
Estatísticas de cobertura de preço para combinações de janela de reserva futura e períodos de estadia.
|
Cobertura de preços
Estatísticas de cobertura para uma combinação de janela de reserva futura e duração da estadia.
Campos |
advanceBookingWindowRange |
enum (AdvanceBookingWindowRange )
Período antecipado de janela de reserva.
|
lengthOfStayRange |
enum (LengthOfStayRange )
Período de permanência.
|
availablePriceCount |
string (int64 format)
Número de preços para este bucket de janela de reserva futura e bucket de duração da estadia.
|
priceCoveragePercent |
number
A porcentagem de itinerários em que você tem cobertura para esse bucket de janela de reserva futura e duração da estadia.
|
AdvanceBookingWindowRange
Enumera os intervalos da janela de agendamento.
Enums |
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED |
Não especificado. |
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN |
O valor é desconhecido nesta versão. |
DAYS_0_TO_30 |
Representa a janela de reserva futura entre 0 e 30 dias. |
DAYS_31_TO_60 |
Representa a janela de reserva futura entre 31 e 60 dias. |
DAYS_61_TO_90 |
Representa uma janela de reserva futura entre 61 e 90 dias. |
DAYS_91_TO_120 |
Representa a janela de reserva futura entre 91 e 120 dias. |
DAYS_121_TO_150 |
Representa a janela de reserva futura entre 121 e 150 dias. |
DAYS_151_TO_180 |
Representa a janela de reserva futura entre 151 e 180 dias. |
DAYS_181_TO_210 |
Representa a janela de reserva futura entre 181 e 210 dias. |
DAYS_211_TO_240 |
Representa a janela de reserva futura entre 211 e 240 dias. |
DAYS_241_TO_270 |
Representa a janela de reserva futura entre 241 e 270 dias. |
DAYS_271_TO_300 |
Representa a janela de reserva futura entre 271 e 300 dias. |
DAYS_301_TO_330 |
Representa a janela de reserva futura entre 301 e 330 dias. |
Duração da estadia
Enumera a duração dos intervalos de estadia.
Enums |
LENGTH_OF_STAY_RANGE_UNSPECIFIED |
Não especificado. |
LENGTH_OF_STAY_RANGE_UNKNOWN |
O valor é desconhecido nesta versão. |
LENGTH_OF_STAY_1_TO_7 |
Representa a duração da estadia de uma a sete noites. |
LENGTH_OF_STAY_8_TO_14 |
Representa a duração da estadia de 8 a 14 noites. |
LENGTH_OF_STAY_15_TO_30 |
Representa a duração da estadia de 15 a 30 noites. |
Métodos |
|
Retorna a visualização mais recente de cobertura de preço com todos os detalhes. |
|
Retorna todo o histórico de cobertura de preços. |
Todos os direitos reservados. Java é uma marca registrada da Oracle e/ou suas afiliadas.
Última atualização 2022-08-23 UTC.
[null,null,["Última atualização 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. |"]]