REST Resource: accounts.priceCoverageViews
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: PricePriceageView
عرض تغطية الأسعار. تغطي وظيفة بطاقة قياس الأداء price_coverage_stats
في إصدارات واجهة برمجة التطبيقات السابقة للإصدار 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
تعداد نطاقات فترات الحجز.
عمليات التعداد |
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 |
تمثّل هذه المدة مدة الإقامة من ليلة إلى 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. |"]]