REST Resource: accounts.priceCoverageViews
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: PriceCoverageView
Просмотр ценового покрытия. Охватывает функциональность системы показателей price_coverage_stats
в версиях API до версии 3.0. Для получения дополнительной информации см. Ценовое покрытие для партнеров Push и Hint .
Представление JSON |
---|
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
Поля |
---|
calculationDate | object ( Date ) Дата, на которую были произведены расчеты. |
matchedPropertyCount | integer Общее количество объектов недвижимости, у которых есть цены для заданных маршрутов. |
priceCoverageBinaryPercent | number Соотношение между количеством отелей, у которых есть хотя бы одна цена за расчетный период, и matchedPropertyCount . |
priceCoveragePercent | number Общее ценовое покрытие аккаунта. Это значение представляет собой отношение между количеством цен на отели для расчетного окна бронирования и диапазоном продолжительности пребывания, деленное на количество всех возможных цен, которое равно matchedPropertyCount , умноженному на 330 (для окна предварительного бронирования) и на 30 (для продолжительности пребывания). |
priceCoverageBuckets[] | object ( PriceCoverageBucket ) Статистика ценового покрытия для комбинаций окна предварительного бронирования и диапазонов продолжительности пребывания. |
ЦенаПокрытиеВедро
Статистика покрытия для одной комбинации окна предварительного бронирования и продолжительности пребывания.
Поля |
---|
advanceBookingWindowRange | enum ( AdvanceBookingWindowRange ) Диапазон окна предварительного бронирования. |
lengthOfStayRange | enum ( LengthOfStayRange ) Диапазон продолжительности пребывания. |
availablePriceCount | string ( int64 format) Количество цен для этого сегмента окна предварительного бронирования и периода пребывания. |
priceCoveragePercent | number Процент маршрутов, для которых у вас есть покрытие для этого сегмента окна предварительного бронирования и сегмента продолжительности пребывания. |
Предварительное БронированиеОкноДиапазон
Перечисляет диапазоны окна бронирования.
перечисления |
---|
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED | Не определен. |
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN | Значение неизвестно в этой версии. |
DAYS_0_TO_30 | Представляет окно предварительного бронирования от 0 до 30 дней. |
DAYS_31_TO_60 | Представляет окно предварительного бронирования от 31 до 60 дней. |
DAYS_61_TO_90 | Представляет окно предварительного бронирования от 61 до 90 дней. |
DAYS_91_TO_120 | Представляет окно предварительного бронирования от 91 до 120 дней. |
DAYS_121_TO_150 | Представляет окно предварительного бронирования от 121 до 150 дней. |
DAYS_151_TO_180 | Представляет окно предварительного бронирования от 151 до 180 дней. |
DAYS_181_TO_210 | Представляет окно предварительного бронирования от 181 до 210 дней. |
DAYS_211_TO_240 | Представляет окно предварительного бронирования от 211 до 240 дней. |
DAYS_241_TO_270 | Представляет окно предварительного бронирования от 241 до 270 дней. |
DAYS_271_TO_300 | Представляет окно предварительного бронирования от 271 до 300 дней. |
DAYS_301_TO_330 | Представляет окно предварительного бронирования от 301 до 330 дней. |
RangeOfStayRange
Перечисляет диапазоны продолжительности пребывания.
перечисления |
---|
LENGTH_OF_STAY_RANGE_UNSPECIFIED | Не определен. |
LENGTH_OF_STAY_RANGE_UNKNOWN | Значение неизвестно в этой версии. |
LENGTH_OF_STAY_1_TO_7 | Представляет собой продолжительность пребывания от 1 до 7 ночей. |
LENGTH_OF_STAY_8_TO_14 | Представляет собой продолжительность пребывания от 8 до 14 ночей. |
LENGTH_OF_STAY_15_TO_30 | Представляет собой продолжительность пребывания от 15 до 30 ночей. |
Методы |
---|
| Возвращает последнее представление ценового покрытия во всех подробностях. |
| Возвращает всю историю покрытия цен. |
Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2022-08-23 UTC.
[null,null,["Последнее обновление: 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. |"]]