REST Resource: accounts.priceCoverageViews
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: PriceCoverageView
Biểu diễn dưới dạng JSON |
{
"calculationDate": {
object (Date )
},
"matchedPropertyCount": integer,
"priceCoverageBinaryPercent": number,
"priceCoveragePercent": number,
"priceCoverageBuckets": [
{
object (PriceCoverageBucket )
}
]
} |
Các trường |
calculationDate |
object (Date )
Ngày thực hiện tính toán.
|
matchedPropertyCount |
integer
Tổng số cơ sở lưu trú có giá của các hành trình đã cho.
|
priceCoverageBinaryPercent |
number
Tỷ lệ giữa số lượng khách sạn có ít nhất một mức giá cho kỳ tính toán và matchedPropertyCount .
|
priceCoveragePercent |
number
Phạm vi tổng giá cho một tài khoản. Giá trị này bằng tỷ lệ giữa số giá phòng khách sạn của thời hạn đặt phòng và thời gian lưu trú chia cho số giá có thể có, đây là matchedPropertyCount nhân 330 (đối với thời hạn đặt trước) nhân với 30 (đối với thời gian lưu trú).
|
priceCoverageBuckets[] |
object (PriceCoverageBucket )
Số liệu thống kê về phạm vi bao phủ của giá kết hợp thời hạn đặt trước và thời gian lưu trú.
|
Mức độ phù hợp của giá
Số liệu thống kê về phạm vi bao phủ của một tổ hợp thời hạn đặt trước và thời gian lưu trú.
Các trường |
advanceBookingWindowRange |
enum (AdvanceBookingWindowRange )
Phạm vi thời hạn đặt trước.
|
lengthOfStayRange |
enum (LengthOfStayRange )
Khoảng thời gian lưu trú.
|
availablePriceCount |
string (int64 format)
Số lượng giá của nhóm thời hạn đặt trước và thời gian lưu trú.
|
priceCoveragePercent |
number
Tỷ lệ phần trăm số hành trình mà bạn có quyền sử dụng nhóm thời hạn đặt trước và thời gian lưu trú.
|
Đặt trước phạm vi cửa sổ
Liệt kê phạm vi thời gian đặt trước.
Enum |
ADVANCE_BOOKING_WINDOW_RANGE_UNSPECIFIED |
Chưa chỉ định. |
ADVANCE_BOOKING_WINDOW_RANGE_UNKNOWN |
Không xác định được giá trị trong phiên bản này. |
DAYS_0_TO_30 |
Cho biết thời hạn đặt trước từ 0 đến 30 ngày. |
DAYS_31_TO_60 |
Cho biết thời hạn đặt trước từ 31 đến 60 ngày. |
DAYS_61_TO_90 |
Cho biết thời hạn đặt trước từ 61 đến 90 ngày. |
DAYS_91_TO_120 |
Cho biết thời hạn đặt trước từ 91 đến 120 ngày. |
DAYS_121_TO_150 |
Thể hiện thời hạn đặt trước từ 121 đến 150 ngày. |
DAYS_151_TO_180 |
Thể hiện thời hạn đặt trước từ 151 đến 180 ngày. |
DAYS_181_TO_210 |
Thể hiện thời hạn đặt trước từ 181 đến 210 ngày. |
DAYS_211_TO_240 |
Thể hiện thời hạn đặt trước từ 211 đến 240 ngày. |
DAYS_241_TO_270 |
Thể hiện khoảng thời gian đặt trước từ 241 đến 270 ngày. |
DAYS_271_TO_300 |
Thể hiện thời hạn đặt trước từ 271 đến 300 ngày. |
DAYS_301_TO_330 |
Cho biết thời hạn đặt trước từ 301 đến 330 ngày. |
DurationOfStayRange
Liệt kê thời gian lưu trú.
Enum |
LENGTH_OF_STAY_RANGE_UNSPECIFIED |
Chưa chỉ định. |
LENGTH_OF_STAY_RANGE_UNKNOWN |
Không xác định được giá trị trong phiên bản này. |
LENGTH_OF_STAY_1_TO_7 |
Thể hiện thời gian lưu trú từ 1 đến 7 đêm. |
LENGTH_OF_STAY_8_TO_14 |
Thể hiện thời gian lưu trú từ 8 đến 14 đêm. |
LENGTH_OF_STAY_15_TO_30 |
Thể hiện thời gian lưu trú từ 15 đến 30 đêm. |
Phương pháp |
|
Trả về thông tin chi tiết mới nhất về phạm vi bao phủ giá. |
|
Trả về toàn bộ lịch sử phạm vi giá. |
Mọi quyền được bảo lưu. Java là một nhãn hiệu đã đăng ký của Oracle và/hoặc chi nhánh của Oracle.
Cập nhật lần gần đây nhất: 2022-08-23 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]