REST Resource: accounts.priceCoverageViews
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: PriceCoverageView
תצוגה של כיסוי מחירים. מכסה את הפונקציונליות של כרטיס המידע price_coverage_stats
בגרסאות API שקודמות לגרסה 3.0. למידע נוסף, ניתן לעיין בקטע כיסוי מחירים לשותפי דחיפה ורמז.
ייצוג 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
אחוז מסלולי הנסיעה שעבורם יש לכם כיסוי לקטגוריה הזו של חלון ההזמנות מראש ומשך השהייה.
|
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 |
הנתון הזה מייצג את משך השהייה בין לילה אחד ל-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. |"]]