XML API 참조 부록

불리언 연산자

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

부울 연산자 정의

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

부울 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)


URL 이스케이프

HTTP 검색 요청을 하려면 Google에서 HTTP 요청을 올바르게 번역하고 적절한 응답을 생성할 수 있도록 특정 규칙을 따라야 합니다.

HTTP URL 스키마는 HTTP URL 요청에 특정 문자만 포함할 수 있도록 지정합니다.

  • 영숫자 문자: (a~z, A~Z, 0~9)
  • 특수문자: $ - _ . | + ! * ' ( )
  • 예약 문자: ; / ? : @ = &

Google에서는 예약 문자를 사용하여 URL을 디코딩하고 일부 특수문자를 사용하여 검색 기능을 요청합니다. 따라서 검색 매개변수 값에서 발생하는 영숫자가 아닌 모든 문자를 URL 이스케이프 처리해야 합니다.

문자열을 URL 이스케이프 처리하려면 각 공백 문자 시퀀스를 하나의 '+' (더하기 기호)로 변환하고 영숫자가 아닌 다른 모든 문자를 해당 문자의 값을 나타내는 16진수 인코딩으로 바꿉니다. 위에 나열된 특수 문자 및 예약 문자의 16진수 인코딩은 다음 표에 나와 있습니다. 이러한 문자는 요청 매개변수 값에서 URL 이스케이프 처리되어야 합니다.

문자 기반이란 16진수
인코딩
$ %24
- %2일
_ %5F
. %2E
+ %20억
! %21
* %2A
" %22
' %27
( %28
) %29
; %30억
/ %2F
? %3F
: %3A
@ %40
= %3D
& %26
| %7C

예시

원본 문자열 URL 이스케이프 문자열
펀치(&judy) 펀치%26judy
오라일리 O%27라일리

URL 이스케이프에 대한 자세한 내용은 W3CIETF 웹사이트를 참조하세요.

결과 압축

Google은 HTTP gzip 압축을 사용하여 검색결과를 압축할 수 있습니다. gzip 알고리즘을 사용하여 압축된 콘텐츠의 압축을 풀면 대역폭을 50~70%까지 절감할 수 있어 응답 시간이 향상될 수도 있습니다.

Google이 결과를 압축 형식으로 반환하도록 요청하려면 다음과 같이 HTTP 검색 요청에 HTTP Accept-Encoding 헤더를 추가합니다.

수락-인코딩: gzip

Google이 gzip 압축을 사용하여 검색결과를 반환하는 경우 반환된 HTTP 헤더에 다음 줄을 포함합니다.

콘텐츠 인코딩: gzip

참고: 위와 같이 응답에 Content-Encoding HTTP 헤더가 없으면 Google은 결과를 압축하지 않은 것입니다.

이 동작은 HTTP 표준에 지정되어 있습니다. HTTP gzip 압축 사용에 대한 추가 정보는 해당 문서를 참조하세요.

국제적 가치

문자 인코딩 스키마

다음 표에는 Google에서 지원하는 문자 인코딩 스키마가 나와 있습니다. ieoe 매개변수에 이 테이블의 처음 두 열 중 하나의 값을 할당할 수 있습니다. 첫 번째 열의 값은 인코딩 스키마의 닉네임이고, 두 번째 열의 값은 인코딩 스키마의 표준 이름입니다. Google은 XML 결과에 표준 이름을 반환하며, 표준 이름은 문서의 HTTP Content-type 헤더에 사용하기 적합합니다.

Google 이름 인코딩 연결된 지원 언어
latin1 ISO-8859-1 서유럽어 (네덜란드어, 덴마크어, 독일어, 스웨덴어, 스페인어, 영어, 이탈리아어, 인도네시아어, 포르투갈어, 프랑스어, 핀란드어, 핀란드어)
latin2 ISO-8859-2 동유럽어 (크로아티아어, 체코어, 헝가리어, 폴란드어, 루마니아어, 세르비아어, 슬로바키아어, 슬로베니아어)
latin3 ISO-8859-3  
latin4 ISO-8859-4 발트어 (에스토니아어, 라트비아어, 리투아니아어)
키릴어 ISO-8859-5 불가리아어, 러시아어
아랍어 ISO-8859-6  
그리스/그리스인 ISO-8859-7 그리스어
히브리 ISO-8859-8 히브리어
latin5 ISO-8859-9  
latin6 ISO-8859-10 아이슬란드어
euc-jp EUC-일본 일본어
euc-kr EUC-대한민국 한국어
Sjis Shift_JIS 일본어
big5 Big5 중국어 번체
gb GB2312 중국어 간체
utf8 UTF-8 전체

지원되는 인터페이스 언어

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

표시 언어 hl 매개변수 값
아프리칸스어 af
알바니아어 sq
암하라어 am
아랍어 ar
아르메니아어 hy
아제르바이잔어 az
벵골어 bn
불가리아어 bg
버마어 my
카탈루냐어 ca
중국어(간체) zh-CN
중국어(번체) zh-TW
크로아티아어 시간
체코어 cs
덴마크어 da
네덜란드어 nl
영어(영국) en-GB
영어 en
에스토니아어 et
필리핀어 fil
핀란드어 fi
프랑스어(캐나다) fr-CA
프랑스어 fr
조지아어 ka
독일어 de
그리스어 el
구자라트어 gu
히브리어 iw
힌디어 hi
헝가리어 hu
아이슬란드어 is
인도네시아어 id
이탈리아어 it
일본어 ja
칸나다어 kn
카자흐어 kk
크메르어 km
한국어 ko
키르기스어 ky
라오어 lo
라트비아어 lv
리투아니아어 lt
마케도니아어 mk
말레이어 밀리초
말라암 ml
마라타어 mr
몽골어 mn
네팔어 ne
노르웨이어(복말) 아니요
페르시아어 fa
폴란드어 pl
포르투갈어(브라질) pt-BR
포르투갈어(포르투갈) pt-PT
펀자브어 pa
루마니아어 ro
러시아어 ru
세르비아어(라틴 문자) sr-Latn
세르비아어 sr
스리랑카어 si
슬로바키아어 sk
슬로베니아어 sl
스페인어(라틴아메리카) es-419
스페인어 es
스와힐리어 sw
스웨덴어 sv
타밀어 ta
텔루구어 te
태국어 th
터키어 tr
우크라이나어 uk
우르두어 ur
우즈베크어 uz
베트남어 vi
웨일즈어 cy

언어 컬렉션 값

다음 값을 사용하여 lr 쿼리 매개변수를 사용하는 언어 필터를 지정할 수 있습니다.

언어 lr 매개변수 값
아랍어 lang_ar
불가리아어 lang_bg
카탈로니아어 lang_ca
중국어(간체) lang_zh-CN
중국어(번체) lang_zh-TW
크로아티아어 lang_hr
체코어 lang_cs
덴마크어 lang_da
네덜란드어 lang_nl
영어 lang_en
에스토니아어 lang_et
핀란드어 lang_fi
프랑스어 lang_fr
독일어 lang_de
그리스어 lang_el
히브리어 lang_iw
헝가리어 lang_hu
아이슬란드어 lang_is
인도네시아어 lang_id
이탈리아어 lang_it
일본어 lang_ja
한국어 lang_ko
라트비아어 lang_lv
리투아니아어 lang_lt
노르웨이어 lang_no
폴란드어 lang_pl
포르투갈어 lang_pt
루마니아어 lang_ro
러시아어 lang_ru
세르비아어 lang_sr
슬로바키아어 lang_sk
슬로베니아어 lang_sl
스페인어 lang_es
스웨덴어 lang_sv
튀르키예어 lang_tr

국가 컬렉션 값

다음 값을 사용하여 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
알바니아
알제리 dz
아메리칸 사모아 이렇게
안도라 광고
앙골라 ao
앵귈라 ai
남극 aq
앤티가 바부다 ag
아르헨티나 ar
아르메니아 am
아루바 aw
오스트레일리아 au
오스트리아 at
아제르바이잔 az
바하마 bs
바레인 bh
방글라데시 bd
바베이도스 bb
벨라루스 필터링 기준:
벨기에 be
벨리즈 BZ
베냉 비제이
버뮤다 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
크로아티아 시간
쿠바 cu
키프로스 cy
체코 cz
덴마크 dk
지부티 DJ
도미니카 DM
도미니카 공화국 포함된
에콰도르 ec
이집트 eg
엘살바도르 sv
적도 기니 gq
에리트레아 er
에스토니아 ee
에티오피아 et
포클랜드 제도(말비나스) fk
페로 제도 fo
피지 fj
핀란드 fi
프랑스 fr
프랑스령 기아나 여친
프랑스령 폴리네시아 pf
프랑스령 남부 지역 tf
가봉 ga
감비아 gm
조지아 ge
독일 de
가나 gh
지브롤터
그리스 gr
그린란드 gl
그레나다 gd
과들루프 gp
gu
과테말라 gt
기니 gn
기니비사우 gw
가이아나
아이티 ht
허드 맥도날드 군도
바티칸 시국 va
온두라스 hn
홍콩 hk
헝가리 hu
아이슬란드 다음과 일치:
인도 in
인도네시아 id
이란 이슬람 공화국 IR
이라크 iq
아일랜드 ie
이스라엘 il
이탈리아 있습니다
자메이카 JM
일본 jp
요르단 jo
카자흐스탄 kz
케냐 ke
키리바시 ki
북한(조선 민주주의 인민공화국) kp
대한민국 kr
쿠웨이트 kw
키르기스스탄 kg
라오스 la
라트비아 lv
레바논 lb
레소토 ls
라이베리아 lr
리비아 아랍 인민공화국 ly
리히텐슈타인 li
리투아니아 lt
룩셈부르크 lu
마카오
마케도니아(구 유고살바 공화국) mk
마다가스카르 mg
말라위 mw
말레이시아 my
몰디브 mv
말리 ml
몰타 mt
마셜 제도 mh
마르티니크 mq
모라타니 mr
모리셔스 mu
마요트 yt
멕시코 mx
미크로네시아 연방 fm
몰도바 공화국 md
모나코 Mc
몽골 mn
몬트세랫 밀리초
모로코 ma
모잠비크 mz
미얀마 mm
나미비아 해당 사항 없음
나우루 노르웨이어
네팔 np
네덜란드 nl
네덜란드령 앤틸리스 이 크기로
뉴 칼레도니아 nc
뉴질랜드 nz
니카라과 ni
니제르 ne
나이지리아 ng
니우에
노퍽섬 nf
북마리아나 제도 mp
노르웨이 아니요
오만 om
파키스탄 pk
팔라우 pw
팔레스타인 점령지역 ps
파나마 pa
파푸아뉴기니 페이지
파라과이 py
페루 pe
필리핀 ph
핏케언 pn
폴란드 pl
포르투갈 파인트
푸에르토리코 pr
카타르 qa
레위니옹
루마니아 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
미국령 군소 제도
우루과이 uy
우즈베키스탄 uz
바누아투 Vu
베네수엘라 ve
베트남 vn
영국령 버진군도 vg
미국령 버진군도 vi
왈리스 푸투나 wf
서부 사하라
예멘
잠비아 zm
짐바브웨 Zw