Method: stats.getSession
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
获取客户的搜索会话数、包含点击的成功会话百分比和查询统计信息。
注意:此 API 需要使用标准的最终用户账号才能执行。
HTTP 请求
GET https://cloudsearch.googleapis.com/v1/stats/session
网址采用 gRPC 转码语法。
查询参数
参数 |
fromDate |
object (Date )
系统会返回从 fromDate 到 toDate 的所有可用统计信息。fromDate 应在当年内,并且 toDate 应大于等于 fromDate。
|
toDate |
object (Date )
|
响应正文
字段 |
stats[] |
object (CustomerSessionStats )
|
授权范围
需要以下 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
如需了解详情,请参阅授权指南。
CustomerSessionStats
JSON 表示法 |
{
"date": {
object (Date )
},
"searchSessionsCount": string
} |
字段 |
date |
object (Date )
计算会话统计信息所对应的日期。系统会在次日接近太平洋标准时间零点时计算统计信息,然后返回。
|
searchSessionsCount |
string (int64 format)
当天的搜索会话数
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: stats.getSession\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.GetCustomerSessionStatsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [CustomerSessionStats](#CustomerSessionStats)\n - [JSON representation](#CustomerSessionStats.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet the # of search sessions, % of successful sessions with a click 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/session`\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/getSession#CustomerSessionStats) } ] } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------|\n| `stats[]` | `object (`[CustomerSessionStats](/workspace/cloud-search/docs/reference/rest/v1/stats/getSession#CustomerSessionStats)`)` |\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\nCustomerSessionStats\n--------------------\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------|\n| ``` { \"date\": { object (/workspace/cloud-search/docs/reference/rest/v1/Date) }, \"searchSessionsCount\": string } ``` |\n\n| Fields ||\n|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` The date for which session stats were calculated. Stats are calculated on the following day, close to midnight PST, and then returned. |\n| `searchSessionsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The count of search sessions on the day |"]]