REST Resource: accounts.priceCoverageViews
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: PriceCoverageView
가격 적용 범위 보기 v3.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일의 숙박 기간을 나타냅니다. |
메서드 |
|
최신 가격 적용 범위 보기를 자세히 반환합니다. |
|
전체 가격 적용 범위 내역을 반환합니다. |
All rights reserved. 자바는 Oracle 및/또는 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. |"]]