REST Resource: accounts.priceCoverageViews
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
リソース: PriceCoverageView
価格保証表示。v3.0 より前の API バージョンにおける price_coverage_stats
スコアカード機能について説明します。詳しくは、Push と Hints の料金範囲をご覧ください。
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 × 330(予約可能期間)× 30(滞在日数)です。
|
priceCoverageBuckets[] |
object (PriceCoverageBucket )
予約可能期間と滞在日数の組み合わせにおける料金マッチの統計情報
|
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 泊の滞在日数を表します。 |
Methods |
|
最新の価格カバレッジ ビューの詳細を返します。 |
|
料金マッチ履歴全体を返します。 |
All rights reserved. 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. |"]]