Method: stats.getQuery
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
آمار پرس و جو را برای مشتری دریافت کنید.
توجه: این API برای اجرا به یک حساب کاربری نهایی استاندارد نیاز دارد.
درخواست HTTP
GET https://cloudsearch.googleapis.com/v1/stats/query
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها |
---|
fromDate | object ( Date ) تمام آمارهای موجود از fromDate تا toDate برگردانده می شوند. fromDate باید در سال باشد و toDate >= fromDate. |
toDate | object ( Date ) |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
فیلدها |
---|
stats[] | object ( CustomerQueryStats ) |
totalQueryCount | string ( int64 format) تعداد کل درخواست موفق (کد وضعیت 200) برای محدوده تاریخ معین. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/cloud_search.stats.indexing
-
https://www.googleapis.com/auth/cloud_search.stats
-
https://www.googleapis.com/auth/cloud_search
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
CustomerQueryStats
فیلدها |
---|
date | object ( Date ) تاریخی که آمار پرس و جو برای آن محاسبه شد. آمار محاسبه شده در روز بعد نزدیک به نیمه شب برگردانده می شود. |
queryCountByStatus[] | object ( QueryCountByStatus ) |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: stats.getQuery\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GetCustomerQueryStatsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [CustomerQueryStats](#CustomerQueryStats)\n - [JSON representation](#CustomerQueryStats.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet the query statistics for customer.\n\n**Note:** This API requires a standard end user account to execute.\n\n### HTTP request\n\n`GET https://cloudsearch.googleapis.com/v1/stats/query`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fromDate` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` All available stats from fromDate to toDate are returned. fromDate should be within the year and toDate \\\u003e= fromDate. |\n| `toDate` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"stats\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/stats/getQuery#CustomerQueryStats) } ], \"totalQueryCount\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `stats[]` | `object (`[CustomerQueryStats](/workspace/cloud-search/docs/reference/rest/v1/stats/getQuery#CustomerQueryStats)`)` |\n| `totalQueryCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Total successful query count (status code 200) for the given date range. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.stats.indexing`\n- `https://www.googleapis.com/auth/cloud_search.stats`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nCustomerQueryStats\n------------------\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"date\": { object (/workspace/cloud-search/docs/reference/rest/v1/Date) }, \"queryCountByStatus\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/stats.query.searchapplications#QueryCountByStatus) } ] } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` The date for which query stats were calculated. Stats calculated on the next day close to midnight are returned. |\n| `queryCountByStatus[]` | `object (`[QueryCountByStatus](/workspace/cloud-search/docs/reference/rest/v1/stats.query.searchapplications#QueryCountByStatus)`)` |"]]