Method: query.suggest

쿼리 자동 완성을 위한 제안을 제공합니다.

참고: 이 API를 사용하려면 표준 최종 사용자 계정이 필요합니다. 서비스 계정은 Query API 요청을 직접 수행할 수 없습니다. 서비스 계정을 사용하여 쿼리를 수행하려면 Google Workspace 도메인 전체 권한 위임을 설정합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requestOptions": {
    object (RequestOptions)
  },
  "query": string,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ]
}
필드
requestOptions

object (RequestOptions)

요청 옵션(예: 검색 애플리케이션 및 사용자 시간대)
query

string

자동 완성 추천이 표시될 부분 쿼리입니다. 예를 들어 쿼리가 'sea'인 경우 서버는 'season', 'search', 'seagull' 등을 반환할 수 있습니다.
dataSourceRestrictions[]

object (DataSourceRestriction)

추천에 사용할 소스입니다. 지정하지 않으면 현재 검색 애플리케이션에서 데이터 소스를 가져옵니다.

참고: 다음 소스에서만 추천이 지원됩니다.

  • 서드 파티 데이터 소스
  • 사전 정의된 소스.PERSON
  • 사전 정의 소스.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

자세한 내용은 승인 가이드를 참고하세요.

추천 결과

제안 결과 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이 있으면 제안_쿼리가 사용자 제안임을 나타냅니다. suggestion은 다음 중 하나여야 합니다.
querySuggestion

object (QuerySuggestion)

이 필드는 추천 검색어가 단어/구문 완성인 경우에 표시됩니다.
peopleSuggestion

object (PeopleSuggestion)

추천은 사람을 나타낼 때 표시됩니다. 이메일 ID, 이름 등 개인에 대한 자세한 정보가 포함되어 있습니다.

쿼리 제안

이 필드에는 현재 아무것도 포함되어 있지 않으며 추천 결과가 구문 완성이라는 것을 나타내는 지표로만 사용됩니다.

사용자 추천

이 필드에는 추천인에 대한 정보가 포함됩니다.

JSON 표현 
{
  "person": {
    object (Person)
  }
}
필드
person

object (Person)

추천 사용자. 사람 객체의 모든 필드가 채워지지 않을 수도 있습니다.