Method: stats.getQuery
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получите статистику запросов для клиента.
Примечание. Для выполнения этого API требуется стандартная учетная запись конечного пользователя.
HTTP-запрос
GET https://cloudsearch.googleapis.com/v1/stats/query
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
fromDate | object ( Date ) Возвращается вся доступная статистика от fromDate до toDate. fromDate должен быть в пределах года, а toDate >= fromDate. |
toDate | object ( Date ) |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"stats": [
{
object (CustomerQueryStats )
}
],
"totalQueryCount": string
} |
Поля |
---|
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
Дополнительную информацию см. в руководстве по авторизации .
Статистика запросов клиента
Поля |
---|
date | object ( Date ) Дата, для которой была рассчитана статистика запросов. Возвращаются статистические данные, рассчитанные на следующий день ближе к полуночи. |
queryCountByStatus[] | object ( QueryCountByStatus ) |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],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)`)` |"]]