REST Resource: accounts.priceCoverageViews
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:PriceCoverageView
价格涵盖视图。介绍了 3.0 版之前的 API 版本中的 price_coverage_stats
统计信息摘要功能。如需了解详情,请参阅推送和提示合作伙伴的价格覆盖范围。
JSON 表示法 |
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
字段 |
calculationDate |
object (Date )
进行计算的日期。
|
matchedPropertyCount |
integer
包含指定行程价格的房产总数。
|
priceCoverageBinaryPercent |
number
计算期间至少有 1 个价格的酒店数量与matchedPropertyCount 的比率。
|
priceCoveragePercent |
number
帐号的总体价格覆盖率。此值是计算预订期限内酒店价格的数量与住宿时长的比值除以所有可能的价格数量所得出的值,即 matchedPropertyCount x 330(提前预订期限)x 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 天之间的提前预订期限。 |
住宿时长
枚举 |
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 和/或其关联公司的注册商标。
最后更新时间 (UTC):2022-08-23。
[null,null,["最后更新时间 (UTC):2022-08-23。"],[[["\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. |"]]