Search

맞춤검색 요청에 대한 응답입니다.

JSON 표현
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
필드
kind

string

현재 객체 유형의 고유 식별자입니다. 이 API에서는 customsearch#search입니다.

url

object

이 API의 템플릿을 정의하는 OpenSearch URL 요소입니다.

url.type

string

Custom Search JSON API에 대한 OpenSearch URL 템플릿의 MIME 유형입니다.

url.template

string

이 API의 실제 OpenSearch 템플릿입니다.

queries

object

역할 이름으로 키가 지정된 쿼리 메타데이터 집합을 하나 이상 포함합니다. 가능한 역할 이름에는 OpenSearch 쿼리 역할에서 정의한 request와 두 가지 맞춤 역할(nextPagepreviousPage)이 포함됩니다.

queries.previousPage[]

object

결과의 이전 페이지를 나타내는 메타데이터입니다(해당하는 경우).

queries.previousPage[].title

string

쿼리에 대한 설명입니다.

queries.previousPage[].totalResults

string (int64 format)

총 검색 결과의 예상 수입니다. 정확하지 않을 수 있습니다.

queries.previousPage[].searchTerms

string

사용자가 입력한 검색어입니다.

queries.previousPage[].count

integer

이 집합에서 반환된 검색 결과의 개수입니다.

queries.previousPage[].startIndex

integer

전체 결과 집합에 대한 현재 검색 결과 집합의 색인으로, 첫 번째 결과의 색인은 1입니다.

queries.previousPage[].startPage

integer

이 결과 집합의 페이지 번호로, 페이지 길이는 count 속성에 의해 설정됩니다.

queries.previousPage[].language

string

검색 결과의 언어입니다.

queries.previousPage[].inputEncoding

string

검색 요청에 지원되는 문자 인코딩입니다.

queries.previousPage[].outputEncoding

string

검색 결과에 지원되는 문자 인코딩입니다.

queries.previousPage[].safe

string

성인용 검색 결과를 필터링하는 데 사용되는 세이프서치 수준을 지정합니다. OpenSearch 사양에 정의되지 않은 맞춤 속성입니다. 유효한 매개변수 값은 다음과 같습니다.

  • "off": 세이프서치 사용 중지

  • "active": 세이프서치 사용

queries.previousPage[].cx

string

프로그래밍 검색 엔진 제어판을 사용하여 만든 엔진의 식별자입니다. OpenSearch 사양에 정의되지 않은 맞춤 속성입니다. 이 매개변수는 필수입니다.

queries.previousPage[].sort

string

지정된 표현식에 따라 결과를 정렬하도록 지정합니다. 예를 들어 날짜별로 정렬할 수 있습니다.

queries.previousPage[].filter

string

Google 검색 결과의 자동 필터링을 활성화 또는 비활성화합니다. Google의 검색결과 필터에 대한 자세한 내용은 자동 필터링을 참조하세요. 이 매개변수에 유효한 값은 다음과 같습니다.

  • 0: 사용 중지됨

  • 1: 사용 설정됨 (기본값)

참고: 기본적으로 Google은 모든 검색 결과에 필터링을 적용하여 검색 결과의 품질을 개선합니다.

queries.previousPage[].gl

string

출처 국가가 매개변수 값과 일치하는 검색결과를 개선합니다. 유효한 값 목록은 국가 코드를 참조하세요.

WebSearch 요청에서 gl 매개변수 값을 지정하면 결과의 관련성이 향상됩니다. 특히 미국 이외의 영어권 국가 고객, 특히 해외 고객의 경우 더욱 그렇습니다.

queries.previousPage[].cr

string

출처가 특정 국가의 문서로 검색결과를 제한합니다. cr 매개변수의 값에 부울 연산자를 사용할 수 있습니다.

Google 웹 검색은 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)입니다.

  • 웹 서버 IP 주소의 지리적 위치입니다.

이 매개변수에 유효한 값 목록은 국가 (cr) 매개변수 값을 참조하세요.

queries.previousPage[].googleHost

string

검색을 제한할 Google 도메인 (예: google.com, google.de, google.fr)을 지정합니다.

queries.previousPage[].disableCnTwTranslation

string

중국어 간체 및 번체 검색 기능을 사용 또는 사용 중지합니다.

지원되는 값은 다음과 같습니다.

  • 0: 사용 설정됨 (기본값)

  • 1: 사용 중지됨

queries.previousPage[].hq

string

마치 논리적 AND 연산자와 결합된 것처럼 지정된 검색어를 쿼리에 추가합니다.

queries.previousPage[].hl

string

사용자 인터페이스의 인터페이스 언어 (호스트 언어)를 지정합니다. 이 매개변수를 명시적으로 설정하면 검색결과의 성능과 품질이 향상됩니다.

자세한 내용은 쿼리 및 결과 다국어 프레젠테이션인터페이스 언어 섹션을, 지원되는 언어 목록은 지원되는 인터페이스 언어를 참고하세요.

queries.previousPage[].siteSearch

string

결과를 지정된 사이트의 URL로 제한합니다.

queries.previousPage[].siteSearchFilter

string

sitesearch 매개변수에 명명된 사이트의 검색 결과를 포함할지 아니면 제외할지 지정합니다. 지원되는 값은 다음과 같습니다.

  • i: 사이트의 콘텐츠 포함

  • e: 사이트에서 콘텐츠 제외

queries.previousPage[].exactTerms

string

검색 결과의 모든 문서에 포함되어야 하는 구문을 식별합니다.

queries.previousPage[].excludeTerms

string

검색결과의 문서에 표시되지 않아야 하는 단어 또는 구문을 식별합니다.

queries.previousPage[].linkSite

string

모든 결과에 특정 URL 링크가 포함되도록 지정합니다.

queries.previousPage[].orTerms

string

문서에서 확인할 추가 검색어를 제공합니다. 검색결과의 각 문서에는 추가 검색어가 하나 이상 포함되어야 합니다. 이 유형의 쿼리에는 부울 OR 검색어를 사용할 수도 있습니다.

queries.previousPage[].relatedSite

string

모든 검색 결과가 지정된 URL과 관련된 페이지여야 함을 지정합니다. 매개변수 값은 URL이어야 합니다.

queries.previousPage[].dateRestrict

string

날짜를 기준으로 한 URL로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • d[number]: 지정된 지난 일수로부터 결과를 요청합니다.

  • w[number]: 지정된 지난 주 수로부터 결과를 요청합니다.

  • m[number]: 지정된 지난 개월 수로부터 결과를 요청합니다.

  • y[number]: 지정된 지난 연도 수로부터 결과를 요청합니다.

queries.previousPage[].lowRange

string

검색 범위의 시작 값을 지정합니다. cse:lowRangecse:highrange를 사용하여 lowRange...highRange의 검색 범위를 쿼리에 추가합니다.

queries.previousPage[].highRange

string

검색 범위의 종료 값을 지정합니다. cse:lowRangecse:highrange를 사용하여 lowRange...highRange의 검색 범위를 쿼리에 추가합니다.

queries.previousPage[].fileType

string

지정된 확장자의 파일로 결과를 제한합니다. Google에서 지원하는 파일 형식은 다음과 같습니다.

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • 서식 있는 텍스트 형식 (rtf)

  • Shockwave Flash (swf)

  • 텍스트 (ans, txt)

향후 더 많은 파일 형식이 추가될 수 있습니다. Google의 파일 형식 FAQ에서 항상 최신 목록을 확인할 수 있습니다.

queries.previousPage[].rights

string

라이선스를 기반으로 합니다. 지원되는 값은 다음과 같습니다.

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

허용되는 값은 web 또는 image입니다. 지정하지 않으면 검색 결과가 웹페이지로 제한됩니다.

queries.previousPage[].imgSize

string

지정된 크기의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • icon (소형)

  • small | medium | large | xlarge (중간 버전)

  • xxlarge (대형)

  • huge (초대형)

queries.previousPage[].imgType

string

지정된 유형의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • clipart (클립아트)

  • face (얼굴)

  • lineart (선화)

  • photo (사진)

  • animated (애니메이션)

  • stock (주식)

queries.previousPage[].imgColorType

string

지정된 색상 유형의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • mono (흑백)

  • gray (그레이 스케일)

  • color (색상)

queries.previousPage[].imgDominantColor

string

특정 주요 색상을 사용하는 이미지로 검색결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

현재 요청을 나타내는 메타데이터입니다.

queries.request[].title

string

쿼리에 대한 설명입니다.

queries.request[].totalResults

string (int64 format)

총 검색 결과의 예상 수입니다. 정확하지 않을 수 있습니다.

queries.request[].searchTerms

string

사용자가 입력한 검색어입니다.

queries.request[].count

integer

이 집합에서 반환된 검색 결과의 개수입니다.

queries.request[].startIndex

integer

전체 결과 집합에 대한 현재 검색 결과 집합의 색인으로, 첫 번째 결과의 색인은 1입니다.

queries.request[].startPage

integer

이 결과 집합의 페이지 번호로, 페이지 길이는 count 속성에 의해 설정됩니다.

queries.request[].language

string

검색 결과의 언어입니다.

queries.request[].inputEncoding

string

검색 요청에 지원되는 문자 인코딩입니다.

queries.request[].outputEncoding

string

검색 결과에 지원되는 문자 인코딩입니다.

queries.request[].safe

string

성인용 검색 결과를 필터링하는 데 사용되는 세이프서치 수준을 지정합니다. OpenSearch 사양에 정의되지 않은 맞춤 속성입니다. 유효한 매개변수 값은 다음과 같습니다.

  • "off": 세이프서치 사용 중지

  • "active": 세이프서치 사용

queries.request[].cx

string

프로그래밍 검색 엔진 제어판을 사용하여 만든 엔진의 식별자입니다. OpenSearch 사양에 정의되지 않은 맞춤 속성입니다. 이 매개변수는 필수입니다.

queries.request[].sort

string

지정된 표현식에 따라 결과를 정렬하도록 지정합니다. 예를 들어 날짜별로 정렬할 수 있습니다.

queries.request[].filter

string

Google 검색 결과의 자동 필터링을 활성화 또는 비활성화합니다. Google의 검색결과 필터에 대한 자세한 내용은 자동 필터링을 참조하세요. 이 매개변수에 유효한 값은 다음과 같습니다.

  • 0: 사용 중지됨

  • 1: 사용 설정됨 (기본값)

참고: 기본적으로 Google은 모든 검색 결과에 필터링을 적용하여 검색 결과의 품질을 개선합니다.

queries.request[].gl

string

출처 국가가 매개변수 값과 일치하는 검색결과를 개선합니다. 유효한 값 목록은 국가 코드를 참조하세요.

WebSearch 요청에서 gl 매개변수 값을 지정하면 결과의 관련성이 향상됩니다. 특히 미국 이외의 영어권 국가 고객, 특히 해외 고객의 경우 더욱 그렇습니다.

queries.request[].cr

string

출처가 특정 국가의 문서로 검색결과를 제한합니다. cr 매개변수의 값에 부울 연산자를 사용할 수 있습니다.

Google 웹 검색은 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)입니다.

  • 웹 서버 IP 주소의 지리적 위치입니다.

이 매개변수에 유효한 값 목록은 국가 (cr) 매개변수 값을 참조하세요.

queries.request[].googleHost

string

검색을 제한할 Google 도메인 (예: google.com, google.de, google.fr)을 지정합니다.

queries.request[].disableCnTwTranslation

string

중국어 간체 및 번체 검색 기능을 사용 또는 사용 중지합니다.

지원되는 값은 다음과 같습니다.

  • 0: 사용 설정됨 (기본값)

  • 1: 사용 중지됨

queries.request[].hq

string

마치 논리적 AND 연산자와 결합된 것처럼 지정된 검색어를 쿼리에 추가합니다.

queries.request[].hl

string

사용자 인터페이스의 인터페이스 언어 (호스트 언어)를 지정합니다. 이 매개변수를 명시적으로 설정하면 검색결과의 성능과 품질이 향상됩니다.

자세한 내용은 쿼리 및 결과 다국어 프레젠테이션인터페이스 언어 섹션을, 지원되는 언어 목록은 지원되는 인터페이스 언어를 참고하세요.

queries.request[].siteSearch

string

결과를 지정된 사이트의 URL로 제한합니다.

queries.request[].siteSearchFilter

string

sitesearch 매개변수에 명명된 사이트의 검색 결과를 포함할지 아니면 제외할지 지정합니다. 지원되는 값은 다음과 같습니다.

  • i: 사이트의 콘텐츠 포함

  • e: 사이트에서 콘텐츠 제외

queries.request[].exactTerms

string

검색 결과의 모든 문서에 포함되어야 하는 구문을 식별합니다.

queries.request[].excludeTerms

string

검색결과의 문서에 표시되지 않아야 하는 단어 또는 구문을 식별합니다.

queries.request[].linkSite

string

모든 결과에 특정 URL 링크가 포함되도록 지정합니다.

queries.request[].orTerms

string

문서에서 확인할 추가 검색어를 제공합니다. 검색결과의 각 문서에는 추가 검색어가 하나 이상 포함되어야 합니다. 이 유형의 쿼리에는 부울 OR 검색어를 사용할 수도 있습니다.

queries.request[].relatedSite

string

모든 검색 결과가 지정된 URL과 관련된 페이지여야 함을 지정합니다. 매개변수 값은 URL이어야 합니다.

queries.request[].dateRestrict

string

날짜를 기준으로 한 URL로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • d[number]: 지정된 지난 일수로부터 결과를 요청합니다.

  • w[number]: 지정된 지난 주 수로부터 결과를 요청합니다.

  • m[number]: 지정된 지난 개월 수로부터 결과를 요청합니다.

  • y[number]: 지정된 지난 연도 수로부터 결과를 요청합니다.

queries.request[].lowRange

string

검색 범위의 시작 값을 지정합니다. cse:lowRangecse:highrange를 사용하여 lowRange...highRange의 검색 범위를 쿼리에 추가합니다.

queries.request[].highRange

string

검색 범위의 종료 값을 지정합니다. cse:lowRangecse:highrange를 사용하여 lowRange...highRange의 검색 범위를 쿼리에 추가합니다.

queries.request[].fileType

string

지정된 확장자의 파일로 결과를 제한합니다. Google에서 지원하는 파일 형식은 다음과 같습니다.

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • 서식 있는 텍스트 형식 (rtf)

  • Shockwave Flash (swf)

  • 텍스트 (ans, txt)

향후 더 많은 파일 형식이 추가될 수 있습니다. Google의 파일 형식 FAQ에서 항상 최신 목록을 확인할 수 있습니다.

queries.request[].rights

string

라이선스를 기반으로 합니다. 지원되는 값은 다음과 같습니다.

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

허용되는 값은 web 또는 image입니다. 지정하지 않으면 검색 결과가 웹페이지로 제한됩니다.

queries.request[].imgSize

string

지정된 크기의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • icon (소형)

  • small | medium | large | xlarge (중간 버전)

  • xxlarge (대형)

  • huge (초대형)

queries.request[].imgType

string

지정된 유형의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • clipart (클립아트)

  • face (얼굴)

  • lineart (선화)

  • photo (사진)

  • animated (애니메이션)

  • stock (주식)

queries.request[].imgColorType

string

지정된 색상 유형의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • mono (흑백)

  • gray (그레이 스케일)

  • color (색상)

queries.request[].imgDominantColor

string

특정 주요 색상을 사용하는 이미지로 검색결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

해당하는 경우 결과의 다음 페이지를 나타내는 메타데이터입니다.

queries.nextPage[].title

string

쿼리에 대한 설명입니다.

queries.nextPage[].totalResults

string (int64 format)

총 검색 결과의 예상 수입니다. 정확하지 않을 수 있습니다.

queries.nextPage[].searchTerms

string

사용자가 입력한 검색어입니다.

queries.nextPage[].count

integer

이 집합에서 반환된 검색 결과의 개수입니다.

queries.nextPage[].startIndex

integer

전체 결과 집합에 대한 현재 검색 결과 집합의 색인으로, 첫 번째 결과의 색인은 1입니다.

queries.nextPage[].startPage

integer

이 결과 집합의 페이지 번호로, 페이지 길이는 count 속성에 의해 설정됩니다.

queries.nextPage[].language

string

검색 결과의 언어입니다.

queries.nextPage[].inputEncoding

string

검색 요청에 지원되는 문자 인코딩입니다.

queries.nextPage[].outputEncoding

string

검색 결과에 지원되는 문자 인코딩입니다.

queries.nextPage[].safe

string

성인용 검색 결과를 필터링하는 데 사용되는 세이프서치 수준을 지정합니다. OpenSearch 사양에 정의되지 않은 맞춤 속성입니다. 유효한 매개변수 값은 다음과 같습니다.

  • "off": 세이프서치 사용 중지

  • "active": 세이프서치 사용

queries.nextPage[].cx

string

프로그래밍 검색 엔진 제어판을 사용하여 만든 엔진의 식별자입니다. OpenSearch 사양에 정의되지 않은 맞춤 속성입니다. 이 매개변수는 필수입니다.

queries.nextPage[].sort

string

지정된 표현식에 따라 결과를 정렬하도록 지정합니다. 예를 들어 날짜별로 정렬할 수 있습니다.

queries.nextPage[].filter

string

Google 검색 결과의 자동 필터링을 활성화 또는 비활성화합니다. Google의 검색결과 필터에 대한 자세한 내용은 자동 필터링을 참조하세요. 이 매개변수에 유효한 값은 다음과 같습니다.

  • 0: 사용 중지됨

  • 1: 사용 설정됨 (기본값)

참고: 기본적으로 Google은 모든 검색 결과에 필터링을 적용하여 검색 결과의 품질을 개선합니다.

queries.nextPage[].gl

string

출처 국가가 매개변수 값과 일치하는 검색결과를 개선합니다. 유효한 값 목록은 국가 코드를 참조하세요.

WebSearch 요청에서 gl 매개변수 값을 지정하면 결과의 관련성이 향상됩니다. 특히 미국 이외의 영어권 국가 고객, 특히 해외 고객의 경우 더욱 그렇습니다.

queries.nextPage[].cr

string

출처가 특정 국가의 문서로 검색결과를 제한합니다. cr 매개변수의 값에 부울 연산자를 사용할 수 있습니다.

Google 웹 검색은 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)입니다.

  • 웹 서버 IP 주소의 지리적 위치입니다.

이 매개변수에 유효한 값 목록은 국가 (cr) 매개변수 값을 참조하세요.

queries.nextPage[].googleHost

string

검색을 제한할 Google 도메인 (예: google.com, google.de, google.fr)을 지정합니다.

queries.nextPage[].disableCnTwTranslation

string

중국어 간체 및 번체 검색 기능을 사용 또는 사용 중지합니다.

지원되는 값은 다음과 같습니다.

  • 0: 사용 설정됨 (기본값)

  • 1: 사용 중지됨

queries.nextPage[].hq

string

마치 논리적 AND 연산자와 결합된 것처럼 지정된 검색어를 쿼리에 추가합니다.

queries.nextPage[].hl

string

사용자 인터페이스의 인터페이스 언어 (호스트 언어)를 지정합니다. 이 매개변수를 명시적으로 설정하면 검색결과의 성능과 품질이 향상됩니다.

자세한 내용은 쿼리 및 결과 다국어 프레젠테이션인터페이스 언어 섹션을, 지원되는 언어 목록은 지원되는 인터페이스 언어를 참고하세요.

queries.nextPage[].siteSearch

string

결과를 지정된 사이트의 URL로 제한합니다.

queries.nextPage[].siteSearchFilter

string

sitesearch 매개변수에 명명된 사이트의 검색 결과를 포함할지 아니면 제외할지 지정합니다. 지원되는 값은 다음과 같습니다.

  • i: 사이트의 콘텐츠 포함

  • e: 사이트에서 콘텐츠 제외

queries.nextPage[].exactTerms

string

검색 결과의 모든 문서에 포함되어야 하는 구문을 식별합니다.

queries.nextPage[].excludeTerms

string

검색결과의 문서에 표시되지 않아야 하는 단어 또는 구문을 식별합니다.

queries.nextPage[].linkSite

string

모든 결과에 특정 URL 링크가 포함되도록 지정합니다.

queries.nextPage[].orTerms

string

문서에서 확인할 추가 검색어를 제공합니다. 검색결과의 각 문서에는 추가 검색어가 하나 이상 포함되어야 합니다. 이 유형의 쿼리에는 부울 OR 검색어를 사용할 수도 있습니다.

queries.nextPage[].relatedSite

string

모든 검색 결과가 지정된 URL과 관련된 페이지여야 함을 지정합니다. 매개변수 값은 URL이어야 합니다.

queries.nextPage[].dateRestrict

string

날짜를 기준으로 한 URL로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • d[number]: 지정된 지난 일수로부터 결과를 요청합니다.

  • w[number]: 지정된 지난 주 수로부터 결과를 요청합니다.

  • m[number]: 지정된 지난 개월 수로부터 결과를 요청합니다.

  • y[number]: 지정된 지난 연도 수로부터 결과를 요청합니다.

queries.nextPage[].lowRange

string

검색 범위의 시작 값을 지정합니다. cse:lowRangecse:highrange를 사용하여 lowRange...highRange의 검색 범위를 쿼리에 추가합니다.

queries.nextPage[].highRange

string

검색 범위의 종료 값을 지정합니다. cse:lowRangecse:highrange를 사용하여 lowRange...highRange의 검색 범위를 쿼리에 추가합니다.

queries.nextPage[].fileType

string

지정된 확장자의 파일로 결과를 제한합니다. Google에서 지원하는 파일 형식은 다음과 같습니다.

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • 서식 있는 텍스트 형식 (rtf)

  • Shockwave Flash (swf)

  • 텍스트 (ans, txt)

향후 더 많은 파일 형식이 추가될 수 있습니다. Google의 파일 형식 FAQ에서 항상 최신 목록을 확인할 수 있습니다.

queries.nextPage[].rights

string

라이선스를 기반으로 합니다. 지원되는 값은 다음과 같습니다.

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

허용되는 값은 web 또는 image입니다. 지정하지 않으면 검색 결과가 웹페이지로 제한됩니다.

queries.nextPage[].imgSize

string

지정된 크기의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • icon (소형)

  • small | medium | large | xlarge (중간 버전)

  • xxlarge (대형)

  • huge (초대형)

queries.nextPage[].imgType

string

지정된 유형의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • clipart (클립아트)

  • face (얼굴)

  • lineart (선화)

  • photo (사진)

  • animated (애니메이션)

  • stock (주식)

queries.nextPage[].imgColorType

string

지정된 색상 유형의 이미지로 결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • mono (흑백)

  • gray (그레이 스케일)

  • color (색상)

queries.nextPage[].imgDominantColor

string

특정 주요 색상을 사용하는 이미지로 검색결과를 제한합니다. 지원되는 값은 다음과 같습니다.

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

프로모션 모음입니다. 맞춤검색 엔진의 구성 파일이 지정된 검색어에 대해 프로모션을 정의하는 경우에만 표시됩니다.

context

object (Struct format)

다음을 포함하여 특정 검색엔진과 관련된 메타데이터 및 상세검색

  • 검색어에 사용된 검색엔진의 이름입니다.

  • 검색을 미세 조정하는 데 사용할 수 있는 패싯 객체 집합 (상세검색)

searchInformation

object

검색 시간 및 총 결과 등 이 검색에 대한 메타데이터입니다.

searchInformation.searchTime

number

서버가 검색결과를 반환하는 데 걸린 시간입니다.

searchInformation.formattedSearchTime

string

서버가 언어 스타일에 따라 형식이 지정된 검색결과를 반환하는 데 걸린 시간입니다.

searchInformation.totalResults

string

쿼리가 반환한 총 검색 결과 수입니다.

searchInformation.formattedTotalResults

string

언어 스타일에 따라 형식이 지정된 총 검색 결과 수입니다.

spelling

object

수정된 쿼리를 캡슐화합니다.

spelling.correctedQuery

string

수정된 쿼리입니다.

spelling.htmlCorrectedQuery

string

HTML 형식으로 된 수정된 검색어입니다.

items[]

object (Result)

맞춤 검색 결과의 현재 집합입니다.

프로모션

프로모션 결과입니다.

JSON 표현
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
필드
title

string

프로모션 제목입니다.

htmlTitle

string

HTML 형식의 프로모션 제목입니다.

bodyLines[]

object

이 프로모션의 블록 객체의 배열입니다.

bodyLines[].title

string

블록 객체의 텍스트(텍스트가 있는 경우)

bodyLines[].htmlTitle

string

블록 객체의 HTML 텍스트입니다(텍스트가 있는 경우).

bodyLines[].url

string

블록 객체 링크의 URL입니다(있는 경우).

bodyLines[].link

string

블록 객체 링크의 앵커 텍스트입니다(링크가 있는 경우).

image

object

이 프로모션과 연결된 이미지입니다(있는 경우).

image.source

string

이 프로모션 링크에 대한 이미지의 URL입니다.

image.width

integer

픽셀 단위의 이미지 너비입니다.

image.height

integer

픽셀 단위의 이미지 높이입니다.

결과

맞춤 검색 결과입니다.

JSON 표현
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
필드
kind

string

현재 객체 유형의 고유 식별자입니다. 이 API에서는 customsearch#result.입니다.

title

string

일반 텍스트로 된 검색 결과의 제목입니다.

htmlTitle

string

HTML 형식의 검색 결과 제목입니다.

snippet

string

일반 텍스트로 된 검색결과 스니펫입니다.

htmlSnippet

string

HTML 형식의 검색결과 스니펫입니다.

cacheId

string

Google의 저장된 검색결과 버전 ID를 나타냅니다.

formattedUrl

string

각 검색결과의 스니펫 뒤에 표시되는 URL입니다.

htmlFormattedUrl

string

각 검색결과의 스니펫 뒤에 표시되는 HTML 형식의 URL입니다.

pagemap

object (Struct format)

이 검색 결과에 대한 PageMap 정보를 포함합니다.

mime

string

검색 결과의 MIME 유형입니다.

fileFormat

string

검색 결과의 파일 형식입니다.

image

object

검색 결과로 반환된 이미지에 대한 모든 정보를 캡슐화합니다.

image.contextLink

string

이미지를 호스팅하는 웹페이지를 가리키는 URL입니다.

image.height

integer

이미지의 높이(픽셀)입니다.

image.width

integer

이미지의 너비(픽셀)입니다.

image.byteSize

integer

바이트 단위의 이미지 크기입니다.

image.thumbnailLink

string

썸네일 이미지의 URL입니다.

image.thumbnailHeight

integer

썸네일 이미지의 높이(픽셀)입니다.

image.thumbnailWidth

integer

썸네일 이미지의 너비(픽셀)입니다.

labels[]

object

상세검색 라벨에 대한 모든 정보를 캡슐화합니다.

labels[].name

string

상세검색을 할 때 사용할 수 있는 상세검색 라벨의 이름입니다. 사용자 인터페이스에 표시하지 마세요. 대신 displayName을 사용하세요.

labels[].displayName

string

상세검색 라벨의 표시 이름입니다. 이 이름은 사용자 인터페이스에 표시해야 합니다.

labels[].label_with_op

string

상세검색 라벨 및 관련 상세검색 작업입니다.