REST Resource: accounts.priceCoverageViews
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Risorsa: PriceCoperturaView
Una visualizzazione della copertura dei prezzi. Include la funzionalità Scorecard price_coverage_stats
nelle versioni API precedenti alla 3.0. Per ulteriori informazioni, consulta la sezione Copertura dei prezzi per i partner Push e Hint.
Rappresentazione JSON |
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
Campi |
calculationDate |
object (Date )
La data in cui sono stati effettuati i calcoli.
|
matchedPropertyCount |
integer
Il numero totale di proprietà con prezzi per gli itinerari specifici.
|
priceCoverageBinaryPercent |
number
Il rapporto tra il numero di hotel con almeno un prezzo per il periodo di calcolo e matchedPropertyCount .
|
priceCoveragePercent |
number
La copertura dei prezzi complessivi per un account. Questo valore è il rapporto tra il numero di prezzi degli hotel per la finestra di prenotazione del calcolo e la durata del soggiorno diviso per il numero di tutti i prezzi possibili, ovvero matchedPropertyCount volte 330 (per la finestra per prenotazione anticipata) per 30 (per la durata del soggiorno).
|
priceCoverageBuckets[] |
object (PriceCoverageBucket )
Statistiche sulla copertura dei prezzi per combinazioni di finestra per prenotazione anticipata e durata del soggiorno.
|
Bucket Copertura dei prezzi
Statistiche sulla copertura per una combinazione di finestra per prenotazione anticipata e durata del soggiorno.
Campi |
advanceBookingWindowRange |
enum (AdvanceBookingWindowRange )
Intervallo della finestra per prenotazione anticipata.
|
lengthOfStayRange |
enum (LengthOfStayRange )
Intervallo durata del soggiorno.
|
availablePriceCount |
string (int64 format)
Numero di prezzi per questo bucket della finestra per prenotazione anticipata e durata del bucket di soggiorno.
|
priceCoveragePercent |
number
La percentuale di itinerari per i quali hai la copertura per questo bucket della finestra per prenotazione anticipata e per il bucket della durata del soggiorno.
|
Finestradi prenotazione anticipata
Enumera gli intervalli delle finestre di prenotazione.
Enum |
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED |
Non specificato. |
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN |
Il valore è sconosciuto in questa versione. |
DAYS_0_TO_30 |
Rappresenta una finestra per prenotazione anticipata tra 0 e 30 giorni. |
DAYS_31_TO_60 |
Rappresenta una finestra per prenotazione anticipata tra 31 e 60 giorni. |
DAYS_61_TO_90 |
Rappresenta una finestra per prenotazione anticipata tra 61 e 90 giorni. |
DAYS_91_TO_120 |
Rappresenta una finestra per prenotazione anticipata tra 91 e 120 giorni. |
DAYS_121_TO_150 |
Rappresenta una finestra per prenotazione anticipata tra 121 e 150 giorni. |
DAYS_151_TO_180 |
Rappresenta una finestra per prenotazione anticipata tra 151 e 180 giorni. |
DAYS_181_TO_210 |
Rappresenta una finestra per prenotazione anticipata tra 181 e 210 giorni. |
DAYS_211_TO_240 |
Rappresenta una finestra per prenotazione anticipata tra 211 e 240 giorni. |
DAYS_241_TO_270 |
Rappresenta una finestra per prenotazione anticipata tra 241 e 270 giorni. |
DAYS_271_TO_300 |
Rappresenta una finestra per prenotazione anticipata tra 271 e 300 giorni. |
DAYS_301_TO_330 |
Rappresenta una finestra per prenotazione anticipata tra 301 e 330 giorni. |
Lunghezza del soggiorno
Enumera la durata del soggiorno.
Enum |
LENGTH_OF_STAY_RANGE_UNSPECIFIED |
Non specificato. |
LENGTH_OF_STAY_RANGE_UNKNOWN |
Il valore è sconosciuto in questa versione. |
LENGTH_OF_STAY_1_TO_7 |
Rappresenta la durata del soggiorno da 1 a 7 notti. |
LENGTH_OF_STAY_8_TO_14 |
Rappresenta una durata del soggiorno da 8 a 14 notti. |
LENGTH_OF_STAY_15_TO_30 |
Rappresenta una durata del soggiorno da 15 a 30 notti. |
Metodi |
|
Restituisce la visualizzazione della copertura dei prezzi più recente in dettaglio. |
|
Restituisce l'intera cronologia della copertura dei prezzi. |
Tutti i diritti riservati. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2022-08-23 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]