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과 2가지 맞춤 역할(nextPage 및 previousPage)이 포함됩니다.
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 WebSearch는 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 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:lowRange 및 cse:highrange를 사용하여 쿼리에 lowRange...highRange의 포괄적인 검색 범위를 추가합니다.
queries.previousPage[].highRange

string

검색 범위의 끝 값을 지정합니다. cse:lowRange 및 cse: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)

  • Shock Wave Flash (swf)

  • 텍스트 (ans, txt)

향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 목록은 파일 형식 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 WebSearch는 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 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:lowRange 및 cse:highrange를 사용하여 쿼리에 lowRange...highRange의 포괄적인 검색 범위를 추가합니다.
queries.request[].highRange

string

검색 범위의 끝 값을 지정합니다. cse:lowRange 및 cse: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)

  • Shock Wave Flash (swf)

  • 텍스트 (ans, txt)

향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 목록은 파일 형식 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 WebSearch는 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 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:lowRange 및 cse:highrange를 사용하여 쿼리에 lowRange...highRange의 포괄적인 검색 범위를 추가합니다.
queries.nextPage[].highRange

string

검색 범위의 끝 값을 지정합니다. cse:lowRange 및 cse: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)

  • Shock Wave Flash (swf)

  • 텍스트 (ans, txt)

향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 목록은 파일 형식 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

상세검색 라벨 및 연결된 상세검색 작업입니다.