JSON API 참조

불리언 OR 검색 [ OR ]
설명

OR 쿼리는 일련의 (두 개 이상의) 쿼리 검색어 중 하나를 포함하는 문서를 검색합니다. OR 검색어를 사용하려면 시리즈의 각 검색어 사이에 대문자로 OR 검색어를 삽입합니다.

'as_oq' 요청 매개변수 (예: 'as_oq=London+Paris')를 사용하여 검색어 집합에서 특정 검색어에 대한 검색을 제출할 수도 있습니다.

참고: 검색 요청에서 '런던+OR+파리'라는 쿼리를 지정하면 검색결과에 이 두 단어 중 하나 이상이 포함된 문서가 포함됩니다. 경우에 따라 검색결과의 문서에 두 단어가 모두 포함될 수 있습니다.
예시

런던 또는 파리 검색:

사용자 입력:london OR paris 검색어:q=london+OR+paris

휴가 및 런던 또는 파리 검색:

검색어:q=vacation+london+OR+paris

휴가 및 런던, 파리 또는 초콜릿 중 하나를 검색합니다.

검색어:  q=vacation+london+OR+paris+OR+chocolates

휴가 및 초콜릿, 런던 또는 파리를 검색합니다. 초콜릿에 가장 적은 가중치를 부여합니다.

검색어:  q=vacation+london+OR+paris+chocolates

런던 또는 파리가 포함된 문서에서 휴가, 초콜릿, 꽃 검색:

검색어:  q=vacation+london+OR+paris+chocolates+flowers

휴가와 런던 또는 파리 중 하나를 검색하고 초콜릿이나 꽃 중 하나를 검색합니다.

검색어:  q=vacation+london+OR+paris+chocolates+OR+flowers

불리언 연산자

다음과 같은 매개변수의 값에 부울 연산자를 사용할 수 있습니다.

  • cr
  • lr

부울 연산자 정의

참고: 매개변수 값에는 공백을 포함할 수 없습니다.

불리언 AND [.]
설명

AND 연산자 (.)는 '.' 연산자 양쪽의 컬렉션 교집합에 있는 결과를 반환합니다.
예시

이 예에서는 프랑스어 또는 이탈리아어로 된 결과를 모두 삭제합니다.
lr=(-lang_fr).(-lang_it)

불리언 NOT [-]
설명

NOT 연산자 (-)는 빼기 ('-') 연산자 바로 다음에 오는 컬렉션에 있는 모든 결과를 삭제합니다.
예시

이 예에서는 프랑스어로 된 결과를 모두 삭제합니다.
lr=-lang_fr

이 예에서는 프랑스어 또는 이탈리아어로 된 결과를 모두 삭제합니다.
lr=(-lang_fr).(-lang_it)

참고: 위의 두 번째 예에서는 부울 AND 연산자를 사용하여 결과를 프랑스어나 이탈리아어로 작성하지 않도록 지정합니다. 쿼리에서 괄호의 배치에 따라 부울 AND 연산자 또는 부울 OR 연산자를 사용하여 이 쿼리를 표현할 수 있습니다. 이는 문서가 프랑스어로 작성된 경우 이탈리아어로 작성되지 않았기 때문입니다. 따라서 불리언 문은 문서가 프랑스어로 작성되지 않았고 또한 문서가 이탈리아어로 작성되지 않았음을 나타내야 합니다.

불리언 OR [|]
설명

OR 연산자 (|)는 파이프 ("|") 연산자의 왼쪽 또는 오른쪽의 컬렉션에 있는 결과를 반환합니다.
예시

이 예에서는 중국어 간체 또는 중국어 번체로 작성된 모든 결과를 반환합니다.
lr=lang_zh-TW|lang_zh-CN

이 예에서는 프랑스어나 이탈리아어로 작성되지 않은 모든 결과를 요청합니다. 부울 AND 연산자의 샘플 쿼리와 다른 위치에 괄호를 삽입합니다.
lr=-(lang_fr|lang_it)


부울 괄호 [()]
설명

이 연산자를 사용하면 괄호 밖에 있는 용어가 평가되기 전에 가장 안쪽의 괄호 안에 있는 모든 용어가 평가되도록 할 수 있습니다. 괄호를 사용하여 용어가 평가되는 순서를 조정할 수 있습니다.
예시

NOT [-] 연산자의 예는 프랑스어나 이탈리아어로 작성되지 않은 요청 결과에 대한 다음 구문을 보여줍니다.
lr=(-lang_fr).(-lang_it)

OR (|) 연산자의 예는 이탈리아어의 프랑스어로 작성되지 않은 결과에 대한 요청도 보여줍니다. 후자의 예에서는 AND 연산자 대신 OR 연산자를 사용하므로 괄호의 위치도 변경해야 합니다.
lr=-(lang_fr|lang_it)

쿼리 및 결과 프레젠테이션 국제화

Google WebSearch 서비스를 사용하면 여러 언어로 문서를 검색할 수 있습니다. HTTP 요청을 해석하고 응답을 인코딩하는 데 사용할 문자 인코딩을 지정할 수 있습니다. 특정 언어로 작성된 문서만 포함하도록 결과를 필터링할 수도 있습니다.

다음 섹션에서는 여러 언어로 검색하는 것과 관련된 문제를 설명합니다.

인터페이스 언어

'hl' 요청 매개변수를 사용하여 그래픽 인터페이스의 언어를 식별할 수 있습니다. 'hl' 매개변수 값은 언어 제한('lr' 매개변수 사용)이 명시적으로 지정되지 않은 경우 특히 국제 검색어의 검색결과에 영향을 줄 수 있습니다. 이러한 경우 'hl' 매개변수는 사용자 입력 언어와 동일한 언어로 된 검색결과를 홍보할 수 있습니다.

Google에서 각 검색어에 대해 가장 높은 품질의 검색결과를 선택할 수 있도록 검색결과에 'hl' 매개변수를 명시적으로 설정하는 것이 좋습니다.

'hl' 매개변수에 유효한 값의 전체 목록은 지원되는 인터페이스 언어 섹션을 참고하세요.

중국어 간체와 번체는 중국어의 두 가지 쓰기 변형입니다. 동일한 개념이 각 변형에서 다르게 작성될 수 있습니다. 대안 중 하나의 검색어를 입력하면 Google WebSearch 서비스가 두 대안의 페이지가 모두 포함된 결과를 반환할 수 있습니다.

이 기능을 사용하려면 다음 안내를 따르세요.

  1. 'c2coff' 요청 매개변수를 0로 설정합니다.
    및
  2. 다음 방법 중 하나를 따릅니다.
    • 'lr' 요청 매개변수를 설정하지 않음
      또는
    • 'lr' 요청 매개변수를 lr=lang_zh-TW|lang_zh-CN로 설정합니다.

다음 예시에서는 중국어 간체와 번체로 된 결과 요청에 포함할 쿼리 매개변수를 보여줍니다. 참고로 '클라이언트'와 같은 추가 필수 정보는 예에 포함되어 있지 않습니다.

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

결과 필터링

Google WebSearch는 검색결과를 필터링하는 다양한 방법을 제공합니다.

검색결과 자동 필터링

최상의 검색 결과를 제공하기 위해 Google에서는 다음 두 가지 기술을 사용하여 일반적으로 바람직하지 않은 것으로 간주되는 검색결과를 자동으로 필터링합니다.

  • 중복 콘텐츠—여러 문서에 동일한 정보가 포함되어 있으면 해당 집합 중 가장 관련성이 높은 문서만 검색결과에 포함됩니다.

  • 호스트 크라우딩—동일한 사이트의 검색 결과가 여러 개 있는 경우 Google에서는 해당 사이트의 모든 결과를 표시하지 않거나 낮은 순위로 표시할 수 있습니다.

필터는 대부분의 검색 결과의 품질을 크게 향상시키므로 일반적인 검색 요청에는 사용 설정된 상태로 두는 것이 좋습니다. 그러나 검색 요청에서 'filter' 쿼리 매개변수를 0으로 설정하여 이러한 자동 필터를 우회할 수 있습니다.

세이프서치로 성인용 콘텐츠 필터링

많은 Google 고객이 성인용 콘텐츠가 포함된 사이트의 검색결과를 표시하지 않으려고 합니다. 세이프서치 필터를 사용하면 성인용 콘텐츠가 포함된 검색결과를 필터링하여 제거할 수 있습니다. Google의 필터는 독점 기술을 사용하여 키워드, 구문, URL을 확인합니다. 100퍼센트 정확한 필터는 없지만 세이프서치는 검색결과에서 대부분의 성인용 콘텐츠를 삭제합니다.

Google은 웹을 지속적으로 크롤링하고 사용자 추천의 업데이트를 통합하여 세이프서치를 최대한 최신의 포괄적인 최신 상태로 유지하기 위해 노력하고 있습니다.

'safe' 쿼리 매개변수를 사용하면 Google에서 성인용 콘텐츠 결과를 필터링하는 정도를 조정할 수 있습니다. 다음 표에서는 Google의 세이프서치 설정과 이러한 설정이 검색결과에 미치는 영향을 설명합니다.

세이프서치 수준 설명
high 더 엄격한 버전의 세이프서치를 사용 설정합니다.
medium 포르노 및 기타 음란물이 포함된 웹페이지를 차단합니다.
off 검색결과에서 성인용 콘텐츠는 필터링되지 않습니다.

* 기본 세이프서치 설정은 사용 안함입니다.

국제적 가치

지원되는 인터페이스 언어

Google은 80개 이상의 언어를 지원합니다. 기본 인터페이스 언어는 영어입니다. 다음 목록에는 Google에서 지원하는 모든 인터페이스 언어가 나와 있습니다.

표시 언어 hl 매개변수 값
아프리칸스어 af
알바니아어 sq
암하라어 sm
아랍어 ar
아제르바이잔어 az
바스크어 eu
벨라루스어 be
벵골어 bn
비하르어 bh
보스니아어 bs
불가리아어 bg
카탈로니아어 ca
중국어(간체) zh-CN
중국어(번체) zh-TW
크로아티아어 hr
체코어 cs
덴마크어 da
네덜란드어 nl
영어 en
에스페란토어 eo
에스토니아어 et
페로어 fo
핀란드어 fi
프랑스어 fr
프리지아어 fy
갈리시아어 gl
조지아어 ka
독일어 de
그리스어 el
구자라트어 gu
히브리어 iw
힌디어 hi
헝가리어 hu
아이슬란드어 is
인도네시아어 id
인테르링구아(국제보조어협회) ia
아일랜드어 ga
이탈리아어 it
일본어 ja
자바어 jw
칸나다어 kn
한국어 ko
라틴 la
라트비아어 lv
리투아니아어 lt
마케도니아어 mk
말레이어 ms
말라암 ml
몰타어 mt
마라타어 mr
네팔어 ne
노르웨이어 no
노르웨이어(뉴노시크) nn
오크어 oc
페르시아어 fa
폴란드어 pl
포르투갈어(브라질) pt-BR
포르투갈어(포르투갈) pt-PT
펀자브어 pa
루마니아어 ro
러시아어 ru
스코틀랜드 게일어 gd
세르비아어 sr
스리랑카어 si
슬로바키아어 sk
슬로베니아어 sl
스페인어 es
수단어 su
스와힐리어 sw
스웨덴어 sv
타갈로그어 tl
타밀어 ta
텔루구어 te
태국어 th
티그리냐어 ti
튀르키예어 tr
우크라이나어 uk
우르두어 ur
우즈베크어 uz
베트남어 vi
웨일즈어 cy
코사어 xh
줄루어 zu

국가 컬렉션 값

다음 값을 사용하여 'cr' 쿼리 매개변수를 사용하는 국가 필터를 지정할 수 있습니다.

국가 국가 컬렉션 이름
아프가니스탄 countryAF
알바니아 countryAL
알제리 countryDZ
아메리칸사모아 countryAS
안도라 countryAD
앙골라 countryAO
앵귈라 countryAI
남극 countryAQ
앤티가 바부다 countryAG
아르헨티나 countryAR
아르메니아 countryAM
아루바 countryAW
오스트레일리아 countryAU
오스트리아 countryAT
아제르바이잔 countryAZ
바하마 countryBS
바레인 countryBH
방글라데시 countryBD
바베이도스 countryBB
벨라루스 countryBY
벨기에 countryBE
벨리즈 countryBZ
베냉 countryBJ
버뮤다 countryBM
부탄 countryBT
볼리비아 countryBO
보스니아 헤르체고비나 countryBA
보츠와나 countryBW
부베섬 countryBV
브라질 countryBR
영국령 인도양 지역 countryIO
브루나이 countryBN
불가리아 countryBG
부르키나파소 countryBF
부룬디 countryBI
캄보디아 countryKH
카메룬 countryCM
캐나다 countryCA
카보베르데 countryCV
케이맨 제도 countryKY
중앙아프리카공화국 countryCF
차드 countryTD
칠레 countryCL
중국 countryCN
크리스마스 섬 countryCX
코코스 군도 countryCC
콜롬비아 countryCO
코모로 countryKM
콩고 countryCG
콩고 민주공화국 countryCD
쿡 제도 countryCK
코스타리카 countryCR
코트디브와르 countryCI
크로아티아(Hrvatska) countryHR
쿠바 countryCU
키프로스 countryCY
체코 countryCZ
덴마크 countryDK
지부티 countryDJ
도미니카 countryDM
도미니카 공화국 countryDO
동티모르 countryTP
에콰도르 countryEC
이집트 countryEG
엘살바도르 countrySV
적도 기니 countryGQ
에리트레아 countryER
에스토니아 countryEE
에티오피아 countryET
유럽 연합 countryEU
포클랜드 제도(말비나스) countryFK
페로 제도 countryFO
피지 countryFJ
핀란드 countryFI
프랑스 countryFR
프랑스 메트로폴리탄 countryFX
프랑스령 기아나 countryGF
프랑스령 폴리네시아 countryPF
프랑스령 남부 지역 countryTF
가봉 countryGA
감비아 countryGM
조지아 countryGE
독일 countryDE
가나 countryGH
지브롤터 countryGI
그리스 countryGR
그린란드 countryGL
그레나다 countryGD
과델로프 countryGP
괌 countryGU
과테말라 countryGT
기니 countryGN
기니비사우 countryGW
가이아나 countryGY
아이티 countryHT
허드 맥도날드 군도 countryHM
바티칸 시국 countryVA
온두라스 countryHN
홍콩 countryHK
헝가리 countryHU
아이슬란드 countryIS
인도 countryIN
인도네시아 countryID
이란 이슬람 공화국 countryIR
이라크 countryIQ
아일랜드 countryIE
이스라엘 countryIL
이탈리아 countryIT
자메이카 countryJM
일본 countryJP
요르단 countryJO
카자흐스탄 countryKZ
케냐 countryKE
키리바시 countryKI
북한(조선민주주의인민공화국) countryKP
대한민국 countryKR
쿠웨이트 countryKW
키르기스스탄 countryKG
라오 인민민주공화국 countryLA
라트비아 countryLV
레바논 countryLB
레소토 countryLS
라이베리아 countryLR
리비아 아랍 인민공화국 countryLY
리히텐슈타인 countryLI
리투아니아 countryLT
룩셈부르크 countryLU
마카오 countryMO
마케도니아(구 유고살바 공화국) countryMK
마다가스카르 countryMG
말라위 countryMW
말레이시아 countryMY
몰디브 countryMV
말리 countryML
몰타 countryMT
마셜 제도 countryMH
마르티니크 countryMQ
모리타니 countryMR
모리셔스 countryMU
마요트 countryYT
멕시코 countryMX
마이크로네시아 연방 countryFM
몰도바 공화국 countryMD
모나코 countryMC
몽골 countryMN
몬세라 countryMS
모로코 countryMA
모잠비크 countryMZ
미얀마 countryMM
나미비아 countryNA
나우루 countryNR
네팔 countryNP
네덜란드 countryNL
네덜란드령 안틸레스 countryAN
뉴칼레도니아 countryNC
뉴질랜드 countryNZ
니카라과 countryNI
니제르 countryNE
나이지리아 countryNG
니우에 countryNU
노퍽섬 countryNF
북마리아나 제도 countryMP
노르웨이 countryNO
오만 countryOM
파키스탄 countryPK
팔라우 countryPW
팔레스타인 자치정부 countryPS
파나마 countryPA
파푸아 뉴기니 countryPG
파라과이 countryPY
페루 countryPE
필리핀 countryPH
핏케언 countryPN
폴란드 countryPL
포르투갈 countryPT
푸에르토리코 countryPR
카타르 countryQA
레위니옹 countryRE
루마니아 countryRO
러시아 연방 countryRU
르완다 countryRW
세인트헬레나 countrySH
세인트키츠네비스 countryKN
세인트루시아 countryLC
생피에르 미클롱 countryPM
세인트 빈센트 그레나딘 countryVC
사모아 countryWS
산마리노 countrySM
상투메 프린시페 countryST
사우디아라비아 countrySA
세네갈 countrySN
세르비아 몬테네그로 countryCS
세이셸 countrySC
시에라리온 countrySL
싱가포르 countrySG
슬로바키아 countrySK
슬로베니아 countrySI
솔로몬 제도 countrySB
소말리아 countrySO
남아프리카공화국 countryZA
사우스조지아 사우스샌드위치 제도 countryGS
스페인 countryES
스리랑카 countryLK
수단 countrySD
수리남 countrySR
스발바르 얀마옌 제도 countrySJ
에스와티니 countrySZ
스웨덴 countrySE
스위스 countryCH
시리아 아랍 공화국 countrySY
대만 countryTW
타지키스탄 countryTJ
탄자니아 연합 공화국 countryTZ
태국 countryTH
토고 countryTG
토켈라우 countryTK
통가 countryTO
트리니다드 토바고 countryTT
튀니지 countryTN
터키 countryTR
투르크메니스탄 countryTM
터크스 케이커스 제도 countryTC
투발루 countryTV
우간다 countryUG
우크라이나 countryUA
아랍에미리트 countryAE
영국 countryUK
미국 countryUS
마이너 아우틀링 합중국 군도 countryUM
우루과이 countryUY
우즈베키스탄 countryUZ
바누아투 countryVU
베네수엘라 countryVE
베트남 countryVN
영국령 버진군도 countryVG
미국령 버진 제도 countryVI
월리스 푸투나 countryWF
서사하라 countryEH
예멘 countryYE
유고슬라비아 countryYU
잠비아 countryZM
짐바브웨 countryZW

국가 코드

다음 표에는 'gl' 매개변수의 값으로 사용할 수 있는 2자리 국가 코드가 나와 있습니다.

국가 국가 코드
아프가니스탄 af
알바니아 al
알제리 dz
아메리칸사모아 as
안도라 ad
앙골라 ao
앵귈라 ai
남극 aq
앤티가 바부다 ag
아르헨티나 ar
아르메니아 am
아루바 aw
오스트레일리아 au
오스트리아 at
아제르바이잔 az
바하마 bs
바레인 bh
방글라데시 bd
바베이도스 bb
벨라루스 by
벨기에 be
벨리즈 bz
베냉 bj
버뮤다 bm
부탄 bt
볼리비아 bo
보스니아 헤르체고비나 ba
보츠와나 bw
부베섬 bv
브라질 br
영국령 인도양 지역 io
브루나이 bn
불가리아 bg
부르키나파소 bf
부룬디 bi
캄보디아 kh
카메룬 cm
캐나다 ca
카보베르데 cv
케이맨 제도 ky
중앙아프리카공화국 cf
차드 td
칠레 cl
중국 cn
크리스마스 섬 cx
코코스 군도 cc
콜롬비아 co
코모로 km
콩고 cg
콩고 민주공화국 cd
쿡 제도 ck
코스타리카 cr
코트디브와르 ci
크로아티아 hr
쿠바 cu
키프로스 cy
체코 cz
덴마크 dk
지부티 dj
도미니카 dm
도미니카 공화국 do
에콰도르 ec
이집트 eg
엘살바도르 sv
적도 기니 gq
에리트레아 er
에스토니아 ee
에티오피아 et
포클랜드 제도(말비나스) fk
페로 제도 fo
피지 fj
핀란드 fi
프랑스 fr
프랑스령 기아나 gf
프랑스령 폴리네시아 pf
프랑스령 남부 지역 tf
가봉 ga
감비아 gm
조지아 ge
독일 de
가나 gh
지브롤터 gi
그리스 gr
그린란드 gl
그레나다 gd
과델로프 gp
괌 gu
과테말라 gt
기니 gn
기니비사우 gw
가이아나 gy
아이티 ht
허드 맥도날드 군도 hm
바티칸 시국 va
온두라스 hn
홍콩 hk
헝가리 hu
아이슬란드 is
인도 in
인도네시아 id
이란 이슬람 공화국 ir
이라크 iq
아일랜드 ie
이스라엘 il
이탈리아 it
자메이카 jm
일본 jp
요르단 jo
카자흐스탄 kz
케냐 ke
키리바시 ki
북한(조선민주주의인민공화국) kp
대한민국 kr
쿠웨이트 kw
키르기스스탄 kg
라오 인민민주공화국 la
라트비아 lv
레바논 lb
레소토 ls
라이베리아 lr
리비아 아랍 인민공화국 ly
리히텐슈타인 li
리투아니아 lt
룩셈부르크 lu
마카오 mo
마케도니아(구 유고살바 공화국) mk
마다가스카르 mg
말라위 mw
말레이시아 my
몰디브 mv
말리 ml
몰타 mt
마셜 제도 mh
마르티니크 mq
모리타니 mr
모리셔스 mu
마요트 yt
멕시코 mx
마이크로네시아 연방 fm
몰도바 공화국 md
모나코 mc
몽골 mn
몬세라 ms
모로코 ma
모잠비크 mz
미얀마 mm
나미비아 na
나우루 nr
네팔 np
네덜란드 nl
네덜란드령 안틸레스 an
뉴칼레도니아 nc
뉴질랜드 nz
니카라과 ni
니제르 ne
나이지리아 ng
니우에 nu
노퍽섬 nf
북마리아나 제도 mp
노르웨이 no
오만 om
파키스탄 pk
팔라우 pw
팔레스타인 점령 지역 ps
파나마 pa
파푸아 뉴기니 pg
파라과이 py
페루 pe
필리핀 ph
핏케언 pn
폴란드 pl
포르투갈 pt
푸에르토리코 pr
카타르 qa
레위니옹 re
루마니아 ro
러시아 연방 ru
르완다 rw
세인트헬레나 sh
세인트키츠네비스 kn
세인트루시아 lc
생피에르 미클롱 pm
세인트 빈센트 그레나딘 vc
사모아 ws
산마리노 sm
상투메 프린시페 st
사우디아라비아 sa
세네갈 sn
세르비아 몬테네그로 cs
세이셸 sc
시에라리온 sl
싱가포르 sg
슬로바키아 sk
슬로베니아 si
솔로몬 제도 sb
소말리아 so
남아프리카공화국 za
사우스조지아 사우스샌드위치 제도 gs
스페인 es
스리랑카 lk
수단 sd
수리남 sr
스발바르 얀마옌 제도 sj
에스와티니 sz
스웨덴 se
스위스 ch
시리아 아랍 공화국 sy
대만 tw
타지키스탄 tj
탄자니아 연합 공화국 tz
태국 th
동티모르 tl
토고 tg
토켈라우 tk
통가 to
트리니다드 토바고 tt
튀니지 tn
터키 tr
투르크메니스탄 tm
터크스 케이커스 제도 tc
투발루 tv
우간다 ug
우크라이나 ua
아랍에미리트 ae
영국 uk
미국 us
마이너 아우틀링 합중국 군도 um
우루과이 uy
우즈베키스탄 uz
바누아투 vu
베네수엘라 ve
베트남 vn
영국령 버진 제도 vg
미국령 버진 제도 vi
월리스 푸투나 wf
서사하라 eh
예멘 ye
잠비아 zm
짐바브웨 zw