Method: accounts.hotelViews.summarize
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعرض معلومات موجزة عن الفنادق.
طلب HTTP
GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews:summarize
يستخدم عنوان URL بنية gRPC Transcoding.
معلّمات المسار
| المَعلمات |
parent |
string
اسم مورد الحساب الذي يتم البحث عنه التنسيق هو accounts/{account_id}.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"matchedPropertyCount": string,
"unmatchedPropertyCount": string,
"unmatchedPropertyWithErrorsCount": string,
"overclusteredPropertyCount": string,
"overclusteredPropertyWithErrorsCount": string,
"liveOnGooglePropertyCount": string,
"lastManifestUpdateTime": string,
"lastFeedSubmissionTime": string
} |
| الحقول |
matchedPropertyCount |
string (int64 format)
عدد المواقع التي تطابق بيان Google.
|
unmatchedPropertyCount |
string (int64 format)
عدد المواقع التي تُعدّ غير متطابقة
|
unmatchedPropertyWithErrorsCount |
string (int64 format)
عدد المواقع غير المطابقة التي تحتوي على أخطاء متعلقة بالبيانات.
|
overclusteredPropertyCount |
string (int64 format)
عدد الفنادق التي يتم الاكتفاء بها.
|
overclusteredPropertyWithErrorsCount |
string (int64 format)
عدد السمات التي تتضمّن بيانات كثيرة بشكلٍ مجمّع والتي تتضمّن أخطاءً متعلقة بالبيانات.
|
liveOnGooglePropertyCount |
string (int64 format)
عدد المواقع الإلكترونية المتاحة على Google
|
lastManifestUpdateTime |
string (Timestamp format)
الطابع الزمني للتعديل الأخير في بيان الفندق طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
lastFeedSubmissionTime |
string (Timestamp format)
الطابع الزمني لإرسال آخر خلاصة فندق طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/travelpartner
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على OAuth 2.0.
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2022-08-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2022-08-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eReturns summarized information about hotels, including matched, unmatched, overclustered, and live property counts.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews:summarize\u003c/code\u003e with the account ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides hotel view summary data, including counts and timestamps for manifest updates and feed submissions.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/travelpartner\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.hotelViews.summarize\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SummarizeHotelViewsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns summarized information about hotels.\n\n### HTTP request\n\n`GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews:summarize`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------|\n| `parent` | `string` The resource name of the account being queried. The format is `accounts/{account_id}`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for [HotelViewService.SummarizeHotelViews](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews/summarize#google.travel.travelpartner.v3.HotelViewService.SummarizeHotelViews).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"matchedPropertyCount\": string, \"unmatchedPropertyCount\": string, \"unmatchedPropertyWithErrorsCount\": string, \"overclusteredPropertyCount\": string, \"overclusteredPropertyWithErrorsCount\": string, \"liveOnGooglePropertyCount\": string, \"lastManifestUpdateTime\": string, \"lastFeedSubmissionTime\": string } ``` |\n\n| Fields ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `matchedPropertyCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of properties that match Google's manifest. |\n| `unmatchedPropertyCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of properties that are considered unmatched. |\n| `unmatchedPropertyWithErrorsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of unmatched properties that have data-related errors. |\n| `overclusteredPropertyCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of hotels that are considered overclustered. |\n| `overclusteredPropertyWithErrorsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of overclustered properties that have data-related errors. |\n| `liveOnGooglePropertyCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The number of properties that are Live on Google. This includes properties that are conditionally active, e.g. LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION. |\n| `lastManifestUpdateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Timestamp of the last hotel manifest update. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `lastFeedSubmissionTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Timestamp of the last hotel feed submission. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/travelpartner`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
