REST Resource: accounts.priceCoverageViews
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:PriceCoverageView
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 天開放預訂。 |
入住天數範圍
列舉 |
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 (世界標準時間)。
[null,null,["上次更新時間: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. |"]]