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

자동 완성 추천이 표시될 부분 쿼리입니다. 예를 들어 쿼리가 '바다'인 경우 서버는 '계절', '검색', '해물' 등을 반환할 수 있습니다.

dataSourceRestrictions[]

object (DataSourceRestriction)

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

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

  • 타사 데이터 소스
  • 사전 정의된 소스.개인
  • 사전 정의된 소스.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

자세한 내용은 OAuth 2.0 개요를 참조하세요.

제안 결과

추천 검색결과 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, 이름 등 고객에 관한 추가 정보가 포함됩니다.

쿼리 추천

이 필드는 현재 아무것도 포함되지 않으며 추천 결과가 구문 완료임을 나타내는 표시기로 사용됩니다.

사용자 추천

이 필드에 추천 대상의 정보가 포함됩니다.

JSON 표현
{
  "person": {
    object (Person)
  }
}
입력란
person

object (Person)

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