REST Resource: accounts.priceCoverageViews
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: PriceCoverageView
Représentation JSON |
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
Champs |
calculationDate |
object (Date )
Date à laquelle les calculs ont été effectués.
|
matchedPropertyCount |
integer
Nombre total d'établissements ayant des prix pour les séjours donnés.
|
priceCoverageBinaryPercent |
number
Ratio entre le nombre d'hôtels ayant au moins un prix pour la période de calcul et matchedPropertyCount .
|
priceCoveragePercent |
number
Prix global du compte. Cette valeur correspond au rapport entre le nombre de prix de l'hôtel pour la période de réservation du calcul et la durée du séjour divisé par le nombre total de tous les prix possibles, soit matchedPropertyCount x 330 (pour la période de réservation à l'avance) x 30 (pour la durée du séjour).
|
priceCoverageBuckets[] |
object (PriceCoverageBucket )
Statistiques de couverture des prix pour des combinaisons de période de réservation à l'avance et de durée de séjour.
|
Couverture PrixPrix
Statistiques de couverture pour une combinaison de période de réservation à l'avance et de durée du séjour.
Champs |
advanceBookingWindowRange |
enum (AdvanceBookingWindowRange )
Période de réservation à l'avance.
|
lengthOfStayRange |
enum (LengthOfStayRange )
Durée du séjour.
|
availablePriceCount |
string (int64 format)
Nombre de prix pour cet ensemble de périodes de réservation à l'avance et de durée du séjour.
|
priceCoveragePercent |
number
Pourcentage de séjours pour lesquels vous bénéficiez de cette période de réservation à l'avance et de la durée du séjour.
|
Plage de période de réservation avancée
Énumère les plages de périodes de réservation.
Enums |
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED |
Non spécifié. |
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN |
La valeur est inconnue dans cette version. |
DAYS_0_TO_30 |
Représente une période de réservation à l'avance entre 0 et 30 jours. |
DAYS_31_TO_60 |
Représente une période de réservation à l'avance entre 31 et 60 jours. |
DAYS_61_TO_90 |
Représente une période de réservation à l'avance entre 61 et 90 jours. |
DAYS_91_TO_120 |
Représente une période de réservation à l'avance entre 91 et 120 jours. |
DAYS_121_TO_150 |
Représente une période de réservation à l'avance entre 121 et 150 jours. |
DAYS_151_TO_180 |
Représente une période de réservation à l'avance entre 151 et 180 jours. |
DAYS_181_TO_210 |
Représente une période de réservation à l'avance entre 181 et 210 jours. |
DAYS_211_TO_240 |
Représente une période de réservation à l'avance entre 211 et 240 jours. |
DAYS_241_TO_270 |
Représente une période de réservation à l'avance entre 241 et 270 jours. |
DAYS_271_TO_300 |
Représente une période de réservation à l'avance entre 271 et 300 jours. |
DAYS_301_TO_330 |
Représente une période de réservation à l'avance entre 301 et 330 jours. |
Durée du séjour
Énumère la durée des séjours.
Enums |
LENGTH_OF_STAY_RANGE_UNSPECIFIED |
Non spécifié. |
LENGTH_OF_STAY_RANGE_UNKNOWN |
La valeur est inconnue dans cette version. |
LENGTH_OF_STAY_1_TO_7 |
Représente une durée de séjour de 1 à 7 nuits. |
LENGTH_OF_STAY_8_TO_14 |
Représente une durée de séjour de 8 à 14 nuits. |
LENGTH_OF_STAY_15_TO_30 |
Représente une durée de séjour de 15 à 30 nuits. |
Méthodes |
|
Affiche la couverture des prix la plus récente en détail. |
|
Renvoie l'intégralité de l'historique de la couverture des prix. |
Tous droits réservés. Java est une marque déposée d'Oracle et/ou ses affiliés.
Dernière mise à jour le 2022/08/23 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]