Method: query.suggest

提供关于自动填充查询的建议。

注意：此 API 需要使用标准最终用户账号才能执行。服务账号无法直接执行 Query API 请求；要使用服务账号执行查询，请设置 Google Workspace 全网域授权。

HTTP 请求

POST https://cloudsearch.googleapis.com/v1/query/suggest

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "requestOptions": {
    object (RequestOptions)
  },
  "query": string,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ]
}
字段
requestOptions

object (RequestOptions)

请求选项，例如搜索应用和用户时区。
query

string

将显示自动填充建议的部分查询。例如，如果查询内容为“sea”，服务器可能会返回“season”“search”“seagull”依此类推。
dataSourceRestrictions[]

object (DataSourceRestriction)

用于建议的来源。如果未指定，则会从当前搜索应用获取数据源。

注意：系统只针对以下来源提供建议：

  • 第三方数据源
  • PredefinedSource.PERSON
  • PredefinedSource.GOOGLE_DRIVE

响应正文

如果成功，响应正文将包含结构如下的数据：

对建议 API 的响应。

JSON 表示法 
{
  "suggestResults": [
    {
      object (SuggestResult)
    }
  ]
}
字段
suggestResults[]

object (SuggestResult)

建议列表。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

有关详情，请参阅授权指南。

SuggestResult

1 条建议结果。

JSON 表示法 
{
  "suggestedQuery": string,
  "source": {
    object (Source)
  },

  // Union field suggestion can be only one of the following:
  "querySuggestion": {
    object (QuerySuggestion)
  },
  "peopleSuggestion": {
    object (PeopleSuggestion)
  }
  // End of list of possible types for union field suggestion.
}
字段
suggestedQuery

string

用户点击建议后将用于搜索的建议查询
source

object (Source)

建议的来源。
联合字段 suggestion。包含有关建议的查询的其他元数据。它还会指明建议查询的类型。例如：如果存在 PeopleSuggestion ，则表示 suggested_query 是人物建议。suggestion 只能是下列其中一项：
querySuggestion

object (QuerySuggestion)

如果建议的查询是字词/短语补全内容，则会显示此字段。
peopleSuggestion

object (PeopleSuggestion)

当建议的人物是人时，系统会显示此属性。其中包含有关此人的更多信息，例如电子邮件 ID、姓名等。

QuerySuggestion

此字段目前不包含任何内容，仅用于表明建议结果是字词补全。

PeopleSuggestion

此字段包含建议的人员的相关信息。

JSON 表示法 
{
  "person": {
    object (Person)
  }
}
字段
person

object (Person)

建议的联系人。系统可能不会填充该人物对象的所有字段。