REST Resource: accounts.priceCoverageViews
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
منبع: PriceCoverageView
نمای پوشش قیمت عملکرد price_coverage_stats
Scorecard را در نسخههای 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 ) آمار پوشش قیمت برای ترکیبی از پنجره رزرو قبلی و محدوده مدت اقامت. |
PriceCoverageBucket
آمار پوشش برای یک ترکیب از پنجره رزرو قبلی و مدت اقامت.
زمینه های |
---|
advanceBookingWindowRange | enum ( AdvanceBookingWindowRange ) محدوده پنجره رزرو قبلی |
lengthOfStayRange | enum ( LengthOfStayRange ) محدوده طول اقامت |
availablePriceCount | string ( int64 format) تعداد قیمتهای این سطل پنجره رزرو قبلی و مدت زمان سطل اقامت. |
priceCoveragePercent | number درصد برنامه های سفری که برای این سطل پنجره رزرو قبلی و مدت سطل اقامت برای آنها پوشش دارید. |
AdvanceBookingWindowRange
محدوده پنجره رزرو را بر می شمارد.
Enums |
---|
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 روز را نشان می دهد. |
طول مدت اقامت
محدوده های مدت اقامت را بر می شمارد.
Enums |
---|
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. |"]]