수행된 검색에 대한 메타데이터, 검색에 사용된 엔진에 대한 메타데이터 및 검색결과를 반환합니다.
HTTP 요청
GET https://customsearch.googleapis.com/customsearch/v1
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
c2coff |
중국어 간체 및 번체 검색을 사용 설정하거나 사용 중지합니다. 이 매개변수의 기본값은 0 (영)이며 기능이 사용 설정되었음을 의미합니다. 지원되는 값은 다음과 같습니다.
|
cr |
출처가 특정 국가인 문서로 검색결과를 제한합니다. cr 매개변수의 값에 부울 연산자를 사용할 수 있습니다. Google 검색은 다음을 분석하여 문서의 국가를 결정합니다.
이 매개변수에 유효한 값 목록을 보려면 국가 매개변수 값 페이지를 참조하세요. |
cx |
이 요청에 사용할 프로그래밍 검색 엔진 ID입니다. |
dateRestrict |
날짜를 기준으로 한 URL로 검색결과를 제한합니다. 지원되는 값은 다음과 같습니다.
|
exactTerms |
검색 결과의 모든 문서에 포함해야 하는 구문을 식별합니다. |
excludeTerms |
검색결과의 어떤 문서에도 표시되어서는 안 되는 단어 또는 구문을 식별합니다. |
fileType |
지정된 확장자의 파일로 결과를 제한합니다. Google에서 색인을 생성할 수 있는 파일 형식 목록은 Search Console 고객센터에서 확인할 수 있습니다. |
filter |
중복 콘텐츠 필터를 사용 설정 또는 사용 중지할 수 있습니다.
사용 가능한 값:
|
gl |
최종 사용자의 위치정보입니다.
|
googlehost |
지원 중단됨. 검색을 수행하는 데 사용할 로컬 Google 도메인 (예: google.com, google.de 또는 google.fr). |
highRange |
검색 범위의 끝 값을 지정합니다.
|
hl |
사용자 인터페이스 언어를 설정합니다.
|
hq |
지정된 검색어를 논리 AND 연산자와 함께 사용한 것처럼 쿼리에 추가합니다. |
imgColorType |
흑백, 회색조, 투명 또는 컬러 이미지를 반환합니다. 사용 가능한 값:
|
imgDominantColor |
특정 주요 색상의 이미지를 반환합니다. 사용 가능한 값:
|
imgSize |
지정된 크기의 이미지를 반환합니다. 사용 가능한 값:
|
imgType |
유형의 이미지를 반환합니다. 사용 가능한 값:
|
linkSite |
모든 검색결과에 특정 URL로 연결되는 링크가 포함되도록 지정합니다. |
lowRange |
검색 범위의 시작 값을 지정합니다. |
lr |
특정 언어 (예: 사용 가능한 값:
|
num |
반환할 검색결과 수입니다.
|
orTerms |
문서에서 확인할 추가 검색어를 제공합니다. 검색 결과의 각 문서에는 하나 이상의 추가 검색어가 포함되어야 합니다. |
q |
쿼리 |
relatedSite |
지원이 중단되었습니다. |
rights |
라이선스를 기반으로 한 필터입니다. 지원되는 값: |
safe |
검색 안전 수준 사용 가능한 값:
|
searchType |
검색 유형( 사용 가능한 값:
|
siteSearch |
결과에 항상 포함되거나 제외되어야 하는 사이트를 지정합니다 (아래의 |
siteSearchFilter |
사용 가능한 값:
|
sort |
결과에 적용할 정렬 표현식입니다. 정렬 매개변수는 지정된 표현식(예: 날짜순 정렬)에 따라 결과가 정렬되도록 지정합니다. 예: sort=date. |
start |
반환할 첫 번째 결과의 색인입니다. 페이지당 기본 결과 수는 10개이므로 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공한 경우 응답 본문에 Search
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/cse
자세한 내용은 OAuth 2.0 개요를 참고하세요.