Method: cse.list

수행된 검색에 대한 메타데이터, 검색에 사용된 엔진에 대한 메타데이터 및 검색결과를 반환합니다.

HTTP 요청

GET https://customsearch.googleapis.com/customsearch/v1

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

쿼리 매개변수

매개변수
c2coff

string

중국어 간체 및 번체 검색을 사용 설정하거나 사용 중지합니다.

이 매개변수의 기본값은 0 (영)이며 기능이 사용 설정되었음을 의미합니다. 지원되는 값은 다음과 같습니다.

  • 1: 사용 중지됨

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

cr

string

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

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

  • 문서 URL의 최상위 도메인 (TLD)

  • 웹 서버 IP 주소의 지리적 위치

이 매개변수에 유효한 값 목록을 보려면 국가 매개변수 값 페이지를 참조하세요.

cx

string

이 요청에 사용할 프로그래밍 검색 엔진 ID입니다.

dateRestrict

string

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

  • d[number]: 지정된 일수의 지난 일수에서 결과를 요청합니다.

  • w[number]: 지정된 수의 지난 주에서 결과를 요청합니다.

  • m[number]: 지정된 수의 지난 개월 수에서 결과를 요청합니다.

  • y[number]: 지정된 수년의 지난 몇 년에서 결과를 요청합니다.

exactTerms

string

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

excludeTerms

string

검색결과의 어떤 문서에도 표시되어서는 안 되는 단어 또는 구문을 식별합니다.

fileType

string

지정된 확장자의 파일로 결과를 제한합니다. Google에서 색인을 생성할 수 있는 파일 형식 목록은 Search Console 고객센터에서 확인할 수 있습니다.

filter

string

중복 콘텐츠 필터를 사용 설정 또는 사용 중지할 수 있습니다.

  • Google의 검색결과 필터에 대한 자세한 내용은 자동 필터링을 참고하세요. 호스트 크라우딩 필터링은 여러 사이트 검색에만 적용됩니다.

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

사용 가능한 값:

  • 0: 중복 콘텐츠 필터를 사용 중지합니다.

  • 1: 중복 콘텐츠 필터를 사용 설정합니다.

gl

string

최종 사용자의 위치정보입니다.

  • gl 매개변수 값은 2자리 국가 코드입니다. gl 매개변수는 출발 국가가 매개변수 값과 일치하는 검색결과를 강화합니다. 유효한 값 목록은 국가 코드 페이지를 참조하세요.

  • gl 매개변수 값을 지정하면 더 관련성 높은 결과를 얻을 수 있습니다. 이는 특히 해외 고객, 특히 미국 이외의 영어 사용 국가의 고객에게 해당됩니다.

googlehost

string

지원 중단됨. gl 매개변수를 사용하면 유사한 효과를 얻을 수 있습니다.

검색을 수행하는 데 사용할 로컬 Google 도메인 (예: google.com, google.de 또는 google.fr).

highRange

string

검색 범위의 끝 값을 지정합니다.

  • lowRangehighRange를 사용하여 쿼리에 lowRange...highRange의 포괄적인 검색 범위를 추가합니다.
hl

string

사용자 인터페이스 언어를 설정합니다.

hq

string

지정된 검색어를 논리 AND 연산자와 함께 사용한 것처럼 쿼리에 추가합니다.

imgColorType

enum (ImgColorType)

흑백, 회색조, 투명 또는 컬러 이미지를 반환합니다. 사용 가능한 값:

  • "color"

  • "gray"

  • "mono": 흑백

  • "trans": 투명한 배경

imgDominantColor

enum (ImgDominantColor)

특정 주요 색상의 이미지를 반환합니다. 사용 가능한 값:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

지정된 크기의 이미지를 반환합니다. 사용 가능한 값:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

유형의 이미지를 반환합니다. 사용 가능한 값:

  • "clipart"

  • "face"

  • "lineart"

  • "stock"

  • "photo"

  • "animated"

lowRange

string

검색 범위의 시작 값을 지정합니다. lowRangehighRange를 사용하여 쿼리에 lowRange...highRange의 포괄적인 검색 범위를 추가합니다.

lr

string

특정 언어 (예: lr=lang_ja).

사용 가능한 값:

  • "lang_ar": 아랍어

  • "lang_bg": 불가리아어

  • "lang_ca": 카탈루냐어

  • "lang_cs": 체코어

  • "lang_da": 덴마크어

  • "lang_de": 독일어

  • "lang_el": 그리스어

  • "lang_en": 영어

  • "lang_es": 스페인어

  • "lang_et": 에스토니아어

  • "lang_fi": 핀란드어

  • "lang_fr": 프랑스어

  • "lang_hr": 크로아티아어

  • "lang_hu": 헝가리어

  • "lang_id": 인도네시아어

  • "lang_is": 아이슬란드어

  • "lang_it": 이탈리아어

  • "lang_iw": 히브리어

  • "lang_ja": 일본어

  • "lang_ko": 한국어

  • "lang_lt": 리투아니아어

  • "lang_lv": 라트비아어

  • "lang_nl": 네덜란드어

  • "lang_no": 노르웨이어

  • "lang_pl": 폴란드어

  • "lang_pt": 포르투갈어

  • "lang_ro": 루마니아어

  • "lang_ru": 러시아어

  • "lang_sk": 슬로바키아어

  • "lang_sl": 슬로베니아어

  • "lang_sr": 세르비아어

  • "lang_sv": 스웨덴어

  • "lang_tr": 터키어

  • "lang_zh-CN": 중국어(간체)

  • "lang_zh-TW": 중국어(번체)

num

integer

반환할 검색결과 수입니다.

  • 유효한 값은 1에서 10 사이의 정수입니다.
orTerms

string

문서에서 확인할 추가 검색어를 제공합니다. 검색 결과의 각 문서에는 하나 이상의 추가 검색어가 포함되어야 합니다.

q

string

쿼리

relatedSite
(deprecated)

string

지원이 중단되었습니다.

rights

string

라이선스를 기반으로 한 필터입니다. 지원되는 값: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived 및 이들의 조합이 있습니다. 일반적인 조합을 참고하세요.

safe

enum (Safe)

검색 안전 수준 사용 가능한 값:

  • "active": 세이프서치 필터링을 사용 설정합니다.

  • "off": 세이프서치 필터링을 사용 중지합니다. (기본)

searchType

enum (SearchType)

검색 유형(image)을 지정합니다. 지정하지 않으면 결과가 웹페이지로 제한됩니다.

사용 가능한 값:

  • "image": 커스텀 이미지 검색
siteSearchFilter

enum (SiteSearchFilter)

siteSearch 매개변수에 이름이 지정된 사이트의 결과를 포함할지 또는 제외할지를 제어합니다.

사용 가능한 값:

  • "e": 제외

  • "i": 포함

sort

string

결과에 적용할 정렬 표현식입니다. 정렬 매개변수는 지정된 표현식(예: 날짜순 정렬)에 따라 결과가 정렬되도록 지정합니다. 예: sort=date.

start

integer (uint32 format)

반환할 첫 번째 결과의 색인입니다. 페이지당 기본 결과 수는 10개이므로 &start=11는 결과의 두 번째 페이지 상단에서 시작합니다. 참고: JSON API는 쿼리와 일치하는 문서가 100개 이상 있더라도 100개가 넘는 결과를 반환하지 않으므로 start + num의 합계를 100보다 큰 숫자로 설정하면 오류가 발생합니다. 또한 num의 최댓값은 10입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 Search의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cse

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