XML API 참조

이 페이지에서는 Google Site Search 고객만 사용할 수 있는 Custom Search JSON API의 XML 버전을 설명합니다.

  1. 개요
  2. 프로그래밍 검색 엔진 요청 형식
    1. 요청 개요
    2. 검색어
    3. 요청 매개변수
      1. 샘플 WebSearch 쿼리
      2. 웹검색 검색어 매개변수 정의
      3. 고급검색
      4. 고급 검색어 매개변수
      5. 특수 검색어
      6. 샘플 이미지 쿼리
      7. 이미지 검색어 매개변수
      8. 요청 한도
    4. 쿼리 및 결과 표시 국제화
      1. 문자 인코딩
      2. 인터페이스 언어
      3. 중국어 간체 및 번체 검색
    5. 결과 필터링
      1. 검색결과 자동 필터링
      2. 언어 및 국가 필터링
      3. 세이프서치로 성인용 콘텐츠 필터링하기
  3. XML 결과
    1. Google XML 결과 DTD
    2. XML 응답에 대한 정보
    3. 일반, 이미지, 고급검색 쿼리의 XML 결과
      1. 일반/고급 검색: 샘플 쿼리 및 XML 결과
      2. 일반/고급검색: XML 태그
      3. 이미지 검색어의 XML 결과
      4. 이미지 검색: 샘플 쿼리 및 XML 결과
      5. 이미지 검색: XML 태그

개요

Google WebSearch 서비스를 사용하면 Google Site Search 고객이 자신의 웹사이트에 Google 검색결과를 표시할 수 있습니다. WebSearch 서비스는 간단한 HTTP 기반 프로토콜을 사용하여 검색결과를 제공합니다. 검색 관리자는 검색결과를 요청하는 방법과 이러한 결과를 최종 사용자에게 표시하는 방법을 완전히 제어할 수 있습니다. 이 문서에서는 Google 검색 요청 및 결과 형식의 기술적 세부정보를 설명합니다.

Google WebSearch 결과를 검색하기 위해 애플리케이션에서 Google에 간단한 HTTP 요청을 보냅니다. 그러면 Google에서 검색결과를 XML 형식으로 반환합니다. XML 형식 결과를 사용하면 검색결과가 표시되는 방식을 맞춤설정할 수 있습니다.

WebSearch 요청 형식

요청 개요

Google 검색 요청은 표준 HTTP GET 명령어입니다. 여기에는 검색어와 관련된 매개변수 모음이 포함됩니다. 이러한 매개변수는 요청 URL에 앰퍼샌드 (&) 문자로 구분된 이름=값 쌍으로 포함됩니다. 매개변수에는 검색어와 같은 데이터, HTTP 요청을 실행하는 엔진을 식별하는 고유 엔진 ID (cx)가 포함됩니다. WebSearch 또는 이미지 검색 서비스는 HTTP 요청에 대한 응답으로 XML 결과를 반환합니다.

검색어

대부분의 검색 요청에는 하나 이상의 검색어가 포함됩니다. 검색어는 검색 요청에서 매개변수 값으로 표시됩니다.

검색어로 여러 유형의 정보를 지정하여 Google이 반환하는 검색결과를 필터링하고 구성할 수 있습니다. 쿼리는 다음을 지정할 수 있습니다.

  • 포함하거나 제외할 단어 또는 구문
    • 검색어에 포함된 모든 단어 (기본값)
    • 검색어에 포함된 정확한 문구
    • 검색어에 포함된 단어 또는 구문
  • 검색어를 찾을 문서 내 위치
    • 문서의 모든 위치 (기본값)
    • 문서의 본문에만 표시
    • 문서 제목에만 표시
    • 문서 URL에만
    • 문서의 링크에만 표시
  • 문서 자체에 대한 제한사항
    • 특정 파일 형식의 문서(예: PDF 파일 또는 Word 문서) 포함 또는 제외
  • 검색을 수행하는 대신 주어진 URL에 관한 정보를 반환하는 특수 URL 쿼리
    • 오픈 디렉터리 카테고리, 스니펫, 언어 등 URL에 관한 일반 정보를 반환하는 쿼리
    • URL에 연결되는 웹페이지 집합을 반환하는 검색어
    • 특정 URL과 유사한 웹페이지 집합을 반환하는 검색어

기본 검색

검색어 매개변수 값은 URL 이스케이프 처리되어야 합니다. 검색어의 모든 공백 시퀀스는 더하기 기호 ('+')를 대체합니다. 이에 대해서는 이 문서의 URL 이스케이프 섹션에서 자세히 설명합니다.

검색어는 q 매개변수를 사용하여 WebSearch 서비스에 제출됩니다. 샘플 검색어는 다음과 같습니다.

q=horses+cows+pigs

기본적으로 Google WebSearch 서비스는 검색어에 포함된 모든 용어가 포함된 문서만 반환합니다.

요청 매개변수

이 섹션에는 검색 요청을 실행할 때 사용할 수 있는 매개변수가 나와 있습니다. 매개변수는 두 목록으로 나뉩니다. 첫 번째 목록에는 모든 검색 요청과 관련된 매개변수가 포함됩니다. 두 번째 목록에는 고급검색 요청에만 관련된 매개변수가 포함됩니다.

세 가지 요청 매개변수가 필요합니다.

  • client 매개변수를 google-csbe로 설정해야 합니다.
  • 출력 매개변수는 반환된 XML 결과의 형식을 지정합니다. 결과는 Google DTD 참조 (xml)를 포함하거나 포함하지 않고 (xml_no_dtd) 반환될 수 있습니다. 이 값은 xml_no_dtd로 설정하는 것이 좋습니다. 참고: 이 매개변수를 지정하지 않으면 결과가 XML 대신 HTML로 반환됩니다.
  • 엔진의 고유 ID를 나타내는 cx 매개변수입니다.

위에 언급된 매개변수 이외에 가장 일반적으로 사용되는 요청 매개변수는 다음과 같습니다.

  • num: 요청된 검색결과 수입니다.
  • q: 검색어
  • start: 결과의 시작 색인

샘플 웹 검색 쿼리

아래 예에서는 서로 다른 쿼리 매개변수가 사용되는 방식을 보여주는 몇 가지 WebSearch HTTP 요청을 보여줍니다. 이 문서의 웹 검색 검색어 매개변수 정의 및 고급검색 검색어 매개변수 섹션에 다양한 쿼리 매개변수에 대한 정의가 나와 있습니다.

이 요청은 검색어 'red sox'(q=red+sox)의 처음 10개 결과(start=0&num=10)를 요청합니다. 또한 결과는 캐나다 웹사이트 (cr=countryCA)에서 제공되며 프랑스어 (lr=lang_fr)로 작성되어야 한다고 지정합니다. 마지막으로 쿼리는 client, output, cx 매개변수의 값을 지정하며, 이 세 개는 모두 필요합니다.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

이 예에서는 일부 고급검색 쿼리 매개변수를 사용하여 검색어를 추가로 맞춤설정합니다. 이 요청은 q 매개변수 대신 as_q 매개변수 (as_q=red+sox)를 사용합니다. 또한 as_eq 매개변수를 사용하여 'Yankees'라는 단어가 포함된 문서를 검색 결과 (as_eq=yankees)에서 제외합니다.

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

웹검색 검색어 매개변수 정의

c2coff
설명

선택사항. c2coff 매개변수는 중국어 간체 및 번체 검색 기능을 사용 설정하거나 사용 중지합니다.

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

값 작업
1 사용 중지됨
0 사용 설정됨
예시 q=google&c2coff=1

클라이언트
설명

필수사항: client 매개변수는 google-csbe로 설정해야 합니다.
예시 q=google&client=google-csbe

cr
설명

선택사항. cr 매개변수는 특정 국가에서 발생한 문서로 검색결과를 제한합니다. cr 매개변수 값에 부울 연산자를 사용할 수 있습니다.

Google WebSearch는 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)
  • 웹 서버 IP 주소의 지리적 위치

이 매개변수에 유효한 값 목록은 국가 (cr) 매개변수 값 섹션을 참고하세요.
예시 q=Frodo&cr=countryNZ

cx
설명

필수사항: cx 매개변수는 맞춤 검색엔진을 식별하는 고유 코드를 지정합니다. 프로그래밍 검색 엔진에서 검색결과를 검색하려면 cx 매개변수를 사용하여 프로그래밍 검색 엔진을 지정해야 합니다.

cx 매개변수의 값을 찾으려면 엔진의 제어판 > 코드 탭으로 이동한 다음 '이 코드를 검색창을 표시할 페이지에 이 코드 붙여넣기' 아래의 텍스트 영역에서 찾습니다. 검색결과가 Google에서 호스팅하는 페이지에 표시됩니다.
예시 q=Frodo&cx=00255077836266642015:u-scht7a-8i

filter
설명

선택사항. filter 매개변수는 Google 검색결과의 자동 필터링을 활성화하거나 비활성화합니다. Google의 검색결과 필터에 관한 자세한 내용은 이 문서의 자동 필터링 섹션을 참고하세요.

filter 매개변수의 기본값은 1이며 기능이 사용 설정되었음을 나타냅니다. 이 매개변수에 유효한 값은 다음과 같습니다.

값 작업
1 사용 중지됨
0 사용 설정됨

참고: 기본적으로 Google은 모든 검색 결과에 필터링을 적용하여 이러한 결과의 품질을 개선합니다.
예시 q=google&filter=0

gl
설명

선택사항. gl 매개변수 값은 2자리 국가 코드입니다. WebSearch 결과의 경우 gl 매개변수는 출발 국가가 매개변수 값과 일치하는 검색결과를 향상시킵니다. 유효한 값 목록은 국가 코드 섹션을 참조하세요.

WebSearch 요청에 gl 매개변수 값을 지정하면 결과의 관련성이 향상됩니다. 이는 해외 고객에게 특히 그러하며 특히 미국이 아닌 영어권 국가의 고객에게 더욱 그러합니다.
예시

이 요청은 웹 검색 결과에서 영국에서 작성된 문서를 증가시킵니다.
q=pizza&gl=uk

hl
설명

선택사항. hl 매개변수는 사용자 인터페이스의 인터페이스 언어 (호스트 언어)를 지정합니다. 검색결과의 성능과 품질을 개선하려면 이 매개변수를 명시적으로 설정하는 것이 좋습니다.

자세한 내용은 쿼리 및 결과 표시의 인터페이스 언어 섹션을, 지원되는 언어 목록은 지원되는 인터페이스 언어를 참고하세요.
예시

이 요청은 프랑스어로 된 와인 광고를 타겟팅합니다. Vin은 와인을 뜻하는 프랑스어 용어입니다.

q=vin&ip=10.10.10.10&ad=w5&hl=fr

hq
설명

선택사항. hq 매개변수는 논리적 AND 연산자와 결합된 것처럼 지정된 검색어를 쿼리에 추가합니다.

예시

이 요청은 '피자' AND '치즈'를 검색합니다. 표현식은 q=pizza+cheese와 동일합니다.

q=pizza&hq=cheese

ie
설명

선택사항. ie 매개변수는 쿼리 문자열을 해석하는 데 사용해야 하는 문자 인코딩 스키마를 설정합니다. 기본 ie 값은 latin1입니다.

이 매개변수를 사용해야 하는 경우에 대한 설명은 문자 인코딩 섹션을 참조하세요.

가능한 ie 값 목록은 문자 인코딩 스키마 섹션을 참고하세요.
예시 q=google&ie=utf8&oe=utf8
lr
설명

선택사항. lr (언어 제한) 매개변수는 특정 언어로 작성된 문서로 검색결과를 제한합니다.

Google WebSearch는 다음을 분석하여 문서의 언어를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)
  • 문서 내의 언어 메타 태그
  • 문서의 본문 텍스트에 사용되는 기본 언어
  • 보조 언어(있는 경우)의 본문 텍스트에 사용

이 매개변수에 유효한 값 목록은 언어 (lr) 컬렉션 값 섹션을 참조하세요.
예시 q=Frodo&lr=lang_en

num
설명

선택사항. num 매개변수는 반환할 검색결과의 수를 식별합니다.

기본 num 값은 10이고 최댓값은 20입니다. 20개가 넘는 결과를 요청하면 20개의 결과만 반환됩니다.

참고: 총 검색결과 수가 요청된 결과 수보다 적으면 사용 가능한 모든 검색결과가 반환됩니다.
예시 q=google&num=10

oe
설명

선택사항. oe 매개변수는 XML 결과를 디코딩하는 데 사용해야 하는 문자 인코딩 스키마를 설정합니다. 기본 oe 값은 latin1입니다.

이 매개변수를 사용해야 하는 경우에 대한 설명은 문자 인코딩 섹션을 참조하세요.

가능한 oe 값 목록은 문자 인코딩 스키마 섹션을 참고하세요.
예시 q=google&ie=utf8&oe=utf8

출력
설명

필수사항: output 매개변수는 XML 결과의 형식을 지정합니다. 이 매개변수에 유효한 값은 xml 및 xml_no_dtd뿐입니다. 아래 차트는 이러한 매개변수 값의 차이를 설명합니다.

값 출력 형식
xml_no_dtd XML 결과에는 !DOCTYPE 문이 포함되지 않습니다. (권장)
xml XML 결과에는 Google DTD 참조가 포함됩니다. 결과의 두 번째 줄은 결과에 사용되는 문서 정의 유형 (DTD)을 식별합니다. 
    <!DOCTYPE GSP SYSTEM "google.dtd">
예시 output=xml_no_dtd
output=xml

q
설명

선택사항. q 매개변수는 사용자가 입력하는 검색어를 지정합니다. 이 매개변수는 선택사항이지만 검색 결과를 얻으려면 쿼리 매개변수 (as_epq, as_lq, as_oq, as_q) 중 하나 이상에 값을 지정해야 합니다.

q 매개변수 값의 일부로 사용할 수 있는 다양한 특수 쿼리도 있습니다. 이러한 용어의 목록과 정의는 특수 검색어를 참조하세요.

Google 검색 제어 패널에는 q 매개변수를 사용하여 제출된 인기 검색어 보고서가 포함되어 있습니다.

참고: q 매개변수에 지정된 값은 URL로 이스케이프 처리해야 합니다.
예시 q=vacation&as_oq=london+paris

안전
설명

선택사항. safe 매개변수는 검색결과를 성인용 및 포르노 콘텐츠 필터링 방법을 나타냅니다. safe 매개변수의 기본값은 off입니다. 유효한 매개변수 값은 다음과 같습니다.

값 작업
off 세이프서치 사용 중지
medium 세이프서치 사용
high 더 엄격한 버전의 세이프서치 사용

이 기능에 관한 자세한 내용은 세이프서치로 성인용 콘텐츠 필터링 섹션을 참조하세요.
예시 q=adult&safe=high

start
설명

선택사항. start 매개변수는 검색결과에 포함되어야 하는 첫 번째 일치하는 결과를 나타냅니다. start 매개변수는 0부터 시작하는 색인을 사용합니다. 즉, 첫 번째 결과가 0이고 두 번째 결과가 1과 같은 방식입니다.

start 매개변수는 num 매개변수와 함께 사용하여 반환할 검색결과를 결정합니다. 1,000개 이상의 문서가 쿼리와 일치하더라도 쿼리에 대해 1,000개 이하의 결과가 반환되지 않으므로 start를 1,000 이상으로 설정하면 결과가 생성되지 않습니다.
예시 start=10

sort
설명

선택사항. sort 매개변수는 지정된 표현식에 따라 결과가 정렬되도록 지정합니다. 예를 들어 날짜순으로 정렬합니다.
예시

sort=date

ud
설명

선택사항. ud 매개변수는 XML 응답에 검색결과의 IDN으로 인코딩된 URL을 포함해야 하는지 여부를 나타냅니다. IDN (국제 도메인 이름) 인코딩을 사용하면 도메인을 현지 언어를 사용하여 표시할 수 있습니다. 예를 들면 다음과 같습니다.

http://www.花井鮨.com

이 매개변수에 유효한 값은 1 (기본값)입니다. 즉, XML 결과에 IDN으로 인코딩된 URL이 포함되어야 하고 0는 XML 결과에 IDN으로 인코딩된 URL이 포함되어서는 안 된다는 의미입니다. ud 매개변수가 1로 설정된 경우 IDN으로 인코딩된 URL이 XML 결과의 UD 태그에 표시됩니다.

ud 매개변수가 0로 설정된 경우 위 예의 URL은 다음과 같이 표시됩니다.

http://www.xn--elq438j.com.

참고: 이 기능은 베타 기능입니다.
예시 q=google&ud=1

이미지 아래에 나열된 추가 쿼리 매개변수는 고급 검색어와 관련이 있습니다. 고급검색을 제출하면 여러 매개변수의 값 (예: as_eq, as_epq, as_oq 등)이 모두 해당 검색의 검색어에 반영됩니다. 이미지는 Google의 고급검색 페이지를 보여줍니다. 이미지에서는 각 고급검색 매개변수의 이름이 해당 매개변수가 해당하는 페이지의 필드 내부 또는 옆에 red 텍스트로 기록됩니다.



고급검색 검색어 매개변수

as_dt
설명

선택사항. as_dt 매개변수는 as_sitesearch 매개변수에 이름이 지정된 사이트의 결과를 포함할지 또는 제외할지를 제어합니다. 값 i과 e는 각각 포함과 제외를 나타냅니다.
예시 as_dt=i,as_dt=e

as_epq
설명

선택사항. as_epq 매개변수는 검색결과의 모든 문서에 포함되어야 하는 구문을 식별합니다. 구문 검색 검색어를 사용하여 구문을 검색할 수도 있습니다.
예시 as_epq=abraham+lincoln

as_eq
설명

선택사항. as_eq 매개변수는 검색결과의 어떤 문서에도 표시되어서는 안 되는 단어 또는 구문을 식별합니다. 또한 제외 검색어를 사용하여 특정 단어나 구문이 일련의 검색 결과 중 문서에 나타나지 않도록 할 수 있습니다.
예시

q=bass&as_eq=music.

as_lq
설명

선택사항. as_lq 매개변수는 모든 검색결과에 특정 URL로 연결되는 링크가 포함되어야 함을 지정합니다. 이 유형의 쿼리에 link: 검색어를 사용할 수도 있습니다.

예시

as_lq=www.google.com

as_nlo
설명

선택사항. as_nlo 매개변수는 검색 범위의 시작 값을 지정합니다. as_nlo 및 as_nhi를 사용하여 쿼리에 as_nlo...as_nhi의 포괄적인 검색 범위를 추가합니다.

예시

다음은 검색 범위를 5에서 10까지 설정합니다.

as_nlo=5&as_nhi=10
as_nhi
설명

선택사항. as_nhi 매개변수는 검색 범위의 끝 값을 지정합니다. as_nlo 및 as_nhi를 사용하여 쿼리에 as_nlo...as_nhi의 포괄적인 검색 범위를 추가합니다.
예시

다음은 검색 범위를 5에서 10까지 설정합니다.

as_nlo=5&as_nhi=10
as_oq
설명

선택사항. as_oq 매개변수는 문서에서 확인할 추가 검색어를 제공하며, 검색결과의 각 문서에는 추가 검색어가 하나 이상 포함되어야 합니다. 이 유형의 쿼리에 부울 OR 쿼리를 사용할 수도 있습니다.
예시

q=vacation&as_oq=London+Paris

as_q
설명

선택사항. as_q 매개변수는 문서에서 확인할 검색어를 제공합니다. 또한 이 매개변수는 사용자가 검색결과 집합 내에서 검색할 추가 검색어를 지정하는 데 일반적으로 사용됩니다.
예시

q=president&as_q=John+Adams

as_qdr
설명

선택사항. as_qdr 매개변수는 지정된 기간 (빠른 기간)의 검색결과를 요청합니다. 다음과 같은 값이 지원됩니다.

d[number]는 지정된 지난 일수의 결과를 요청합니다.
w[number]는 지정된 수의 지난 몇 주에서 결과를 요청합니다.
m[number]는 지정된 수의 지난 개월 수에서 결과를 요청합니다.
y[number]는 지정된 지난 연도의 결과를 요청합니다.
예시

이 예에서는 지난해의 결과를 요청합니다.

as_qdr=y

이 예에서는 지난 10일간의 결과를 요청합니다.

as_qdr=d10
as_sitesearch
설명

선택사항. as_sitesearch 매개변수를 사용하면 모든 검색결과가 특정 사이트의 페이지여야 한다고 지정할 수 있습니다. as_dt 매개변수를 설정하여 검색 결과에서 특정 사이트의 페이지를 제외할 수도 있습니다.
예시

q=vacation&as_sitesearch=www.google.com

특수 검색어

Google WebSearch에서는 Google 검색엔진의 추가 기능에 액세스하는 몇 가지 특수 검색어를 사용할 수 있습니다. 이러한 특수 쿼리는 q 요청 매개변수의 값에 포함되어야 합니다. 다른 검색어와 마찬가지로 특수 검색어는 URL로 이스케이프 처리되어야 합니다. 여러 특수 검색어에는 콜론 (:)이 포함됩니다. 이 문자도 URL 이스케이프되어야 하며 URL 이스케이프된 값은 %3A입니다.

뒤로 링크[link:]
설명

link: 검색어는 특정 URL로 연결되는 웹페이지 집합을 검색합니다. 검색어는 link: 검색어와 URL 사이에 공백 없이 link:URL 형식이어야 합니다.

link:의 URL 이스케이프 버전은 link%3A입니다.

as_lq 요청 매개변수를 사용하여 link: 요청을 제출할 수도 있습니다.

참고: link:를 사용할 때는 다른 쿼리를 지정할 수 없습니다.
예시

http://www.google.com/search?q=link%3Awww.example.com

불리언 OR 검색 [ OR ]
설명

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

as_oq 요청 매개변수를 사용하여 일련의 검색어로 포함된 검색어를 제출할 수도 있습니다.

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

런던 또는 파리 검색:

사용자 입력: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

검색어 제외 [-]
설명

제외 (-) 쿼리는 특정 검색 요청의 결과를 특정 단어 또는 구문이 포함되지 않은 문서로 제한합니다. 제외 검색어를 사용하려면 일치 문서에서 제외할 단어나 구문을 '-' (빼기 기호)로 시작합니다.

-의 URL 이스케이프 버전은 %2D입니다.

제외 검색어는 검색어에 두 가지 이상의 의미가 있는 경우에 유용합니다. 예를 들어 '베이스'라는 단어는 물고기나 음악에 관한 결과를 반환할 수 있습니다. 물고기에 관한 문서를 찾고 있다면 제외 검색어를 사용하여 검색결과에서 음악에 관한 문서를 제외할 수 있습니다.

또한 as_eq 요청 매개변수를 사용하여 특정 단어 또는 구문과 일치하는 문서를 검색결과에서 제외할 수 있습니다.
예시 사용자 입력: bass -music
검색어: q=bass+%2Dmusic

파일 형식 제외[ -filetype: ]
설명

-filetype: 검색어는 '.pdf', '.doc'와 같은 특정 파일 확장자가 있는 문서를 검색결과에서 제외합니다. 검색어는 -filetype: 검색어와 지정된 확장자 사이에 공백 없이 -filetype:EXTENSION 형식이어야 합니다.

-filetype:의 URL 이스케이프 버전은 %2Dfiletype%3A입니다.

참고: 쿼리에 -filetype: 검색어를 더 추가하여 검색결과에서 여러 파일 형식을 제외할 수 있습니다. 검색결과에서 제외해야 하는 파일 확장자마다 검색어에 하나의 -filetype: 검색어가 있어야 합니다.

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 (문서)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft 쓰기 (쓰기)
  • 서식 있는 텍스트 형식 (rtf)
  • Shock웨이브 플래시 (swf)
  • 텍스트 (ans, txt).

향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 목록은 파일 형식 FAQ에서 언제든지 확인할 수 있습니다.
예시

이 예시에서는 'Google'이 언급되지만 PDF 문서가 아닌 문서를 반환합니다.
q=Google+%2Dfiletype%3Apdf

이 예시에서는 'Google'이 언급되지만 PDF와 Word 문서는 모두 제외된 문서를 반환합니다.
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

파일 형식 필터링[ filetype: ]
설명

filetype: 검색어는 특정 파일 확장자가 '.pdf', '.doc'인 문서로 검색 결과를 제한합니다. 검색어는 filetype: 검색어와 지정된 확장자 사이에 공백 없이 filetype:EXTENSION 형식으로 지정해야 합니다.

filetype:의 URL 이스케이프 버전은 filetype%3A입니다.

쿼리에 filetype: 검색어를 더 추가하여 검색 결과를 여러 파일 확장자 중 하나와 일치하는 문서로 제한할 수 있습니다. 검색결과에 포함되어야 하는 각 파일 확장자마다 검색어에 하나의 filetype: 검색어가 있어야 합니다. 여러 개의 filetype: 검색어는 OR 검색어를 사용하여 구분해야 합니다.

기본적으로 검색결과에는 파일 확장자에 상관없이 문서가 포함됩니다.

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 (문서)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft 쓰기 (쓰기)
  • 서식 있는 텍스트 형식 (rtf)
  • Shock웨이브 플래시 (swf)
  • 텍스트 (ans, txt).

향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 목록은 파일 형식 FAQ에서 언제든지 확인할 수 있습니다.
예시

이 예에서는 'Google'이 언급된 PDF 문서를 반환합니다.
q=Google+filetype%3Apdf

이 예시에서는 'Google'이 언급된 PDF 및 Word 문서를 반환합니다.
q=Google+filetype%3Apdf+OR+filetype%3Adoc

검색어 포함 [+]
설명

포함 (+) 검색어는 검색결과에 포함된 모든 문서에서 단어 또는 구문이 있어야 함을 지정합니다. 포함 검색어를 사용하려면 모든 검색결과에 포함되어야 하는 단어나 구문을 '+' (더하기 기호)로 시작합니다.

URL 이스케이프 처리된 +의 버전 (더하기 기호)은 %2B입니다.

Google에서 검색결과를 식별하기 전에 일반적으로 삭제하는 일반적인 단어 앞에 +를 사용해야 합니다.
예시 사용자 입력: Star Wars Episode +I
검색어: q=Star+Wars+Episode+%2BI

링크 전용 검색, 모든 검색어 [ allinlinks: ]
설명

allinlinks: 검색어를 사용하려면 검색결과의 문서에 URL 링크의 모든 검색어가 포함되어야 합니다. 검색어는 allinlinks: 다음에 검색어에 포함된 단어로 형식이 지정되어야 합니다.

검색어에 allinlinks: 검색어가 포함된 경우 Google은 문서의 다른 텍스트, 문서 제목, 각 문서의 URL을 무시하고 검색어에 포함된 단어의 URL 링크만 확인합니다. 문서 URL은 문서에 포함된 URL 링크와 다릅니다.

allinlinks:의 URL 이스케이프 버전은 allinlinks%3A입니다.
예시 사용자 입력:allinlinks: Google search
검색어:q=allinlinks%3A+Google+search

구문검색
설명

구문 검색 (") 검색어를 사용하면 구문을 따옴표로 묶거나 하이픈으로 연결하여 전체 구문을 검색할 수 있습니다.

" (따옴표)의 URL 이스케이프 버전은 %22입니다.

구문검색은 유명한 인용문이나 고유명을 검색할 때 특히 유용합니다.

as_epq 요청 매개변수를 사용하여 구문 검색을 제출할 수도 있습니다.
예시 사용자 입력:"Abraham Lincoln"
검색어: q=%22Abraham+Lincoln%22

텍스트 전용 검색, 모든 검색어 [allintext:]
설명

allintext: 검색어를 사용하려면 검색결과의 각 문서에 문서 본문에 검색어의 모든 단어가 포함되어야 합니다. 쿼리는 allintext: 다음에 검색어에 포함된 단어로 형식이 지정되어야 합니다.

검색어에 allintext: 검색어가 포함된 경우 Google은 문서의 본문 텍스트에서만 검색어에 포함된 단어를 확인하며 문서, 문서 제목, 문서 URL의 링크는 무시합니다.

allintext:의 URL 이스케이프 버전은 allintext%3A입니다.
예시 이 예에서는 검색결과에 포함된 모든 문서의 본문에 'Google' 및 'search'라는 단어가 나타나야 함을 지정합니다.
사용자 입력:allintext:Google search
검색어:q=allintext%3AGoogle+search

제목 검색, 단일 검색어 [intitle:]
설명

intitle: 검색어는 문서 제목에 특정 단어가 포함된 문서로 검색결과를 제한합니다. 검색어는 intitle: 검색어와 다음 단어 사이에 공백 없이 intitle:단어 형식이어야 합니다.

참고: 문서 제목에 포함되어야 하는 각 단어 앞에 intitle: 검색어를 넣으면 이 단어를 두 개 이상 지정할 수 있습니다. allintitle: 검색어를 사용하여 검색결과에 표시되는 문서의 제목에 모든 검색어가 포함되어야 한다고 지정할 수도 있습니다.

intitle:의 URL 이스케이프 버전은 intitle%3A입니다.
예시

이 예에서는 검색결과에 표시되는 모든 문서의 제목에 'Google'이라는 단어가 표시되어야 하고 'search'라는 단어가 해당 문서의 제목, URL, 링크 또는 본문 텍스트에 나타나도록 지정합니다.
사용자 입력:intitle:Google search
검색어:q=intitle%3AGoogle+search

제목 검색, 모든 검색어[allintitle:]
설명

allintitle: 검색어는 문서 제목에 있는 모든 검색어가 포함된 문서로 검색결과를 제한합니다. allintitle: 검색어를 사용하려면 검색어 시작 부분에 'allintitle:'을 포함하세요.

참고: allintitle:를 검색어 시작 부분에 넣는 것은 검색어의 각 단어 앞에 intitle:을 넣는 것과 같습니다.

URL 이스케이프 처리된 allintitle: 버전은 allintitle%3A입니다.
예시

이 예에서는 검색결과의 모든 문서 제목에 'Google'과 '검색'이라는 단어가 나타나도록 지정합니다.
사용자 입력: allintitle: Google search
검색어: q=allintitle%3A+Google+search

URL 검색, 단일 검색어 [inurl:]
설명

inurl: 검색어는 문서 URL에 특정 단어가 포함된 문서로 검색결과를 제한합니다. 검색어는 inurl: 검색어와 다음 단어 사이에 공백 없이 inurl:word 형식이어야 합니다.

inurl: 검색어는 구두점을 무시하고 inurl: 연산자 다음에 오는 첫 번째 단어만 사용합니다. 문서 URL에 포함되어야 하는 단어를 두 개 이상 지정하려면 각 단어 앞에 inurl: 검색어를 입력합니다. allinurl: 검색어를 사용하여 검색결과에 표시되는 문서의 URL에 모든 검색어가 포함되어야 한다고 지정할 수도 있습니다.

inurl:의 URL 이스케이프 버전은 inurl%3A입니다.
예시

이 예에서는 검색결과에 포함된 문서의 URL에 'Google'이라는 단어가 표시되어야 하고 문서의 제목, URL, 링크 또는 본문 텍스트에 'search'라는 단어가 나타나야 한다고 지정합니다.
사용자 입력: inurl:Google search
검색어: q=inurl%3AGoogle+search

URL 검색, 모든 용어 [allinurl:]
설명

allinurl: 검색어는 문서 URL에 있는 모든 검색어가 포함된 문서로 검색결과를 제한합니다. allinurl: 검색어를 사용하려면 검색어 시작 부분에 allinurl:을 포함합니다.

allinurl: 검색어는 구두점을 무시하므로 URL 구성요소가 아닌 단어에서만 작동합니다. 예를 들어 allinurl: uk/scotland는 URL에 'uk'와 'scotland'가 포함된 문서로 결과를 제한하지만 이 두 단어를 특정 순서로 표시하거나 슬래시로 구분할 필요는 없습니다.

allinurl:의 URL 이스케이프 버전은 allinurl%3A입니다.
예시

이 예에서는 검색결과의 모든 문서의 URL에 'Google'과 'search'라는 단어가 나타나도록 지정합니다.
사용자 입력: allinurl: Google search
검색어: q=allinurl%3A+Google+search


웹 문서 정보 [info:]
설명

info: 검색어는 URL이 Google의 검색 색인에 포함되어 있는 한 URL에 대한 일반적인 정보를 가져옵니다. 검색어는 info: 검색어와 URL 사이에 공백 없이 info:URL 형식이어야 합니다.

URL 이스케이프 처리된 info: 버전은 info%3A입니다.

참고: info:를 사용할 때는 다른 쿼리를 지정할 수 없습니다.
예시 사용자 입력: info:www.google.com
검색어: q=info%3Awww.google.com

샘플 이미지 쿼리

아래 예에서는 여러 쿼리 매개변수가 사용되는 방식을 보여주는 몇 가지 이미지 HTTP 요청을 보여줍니다. 다양한 검색어 매개변수에 대한 정의는 이 문서의 이미지 검색어 매개변수 정의 섹션에 나와 있습니다.

이 요청은 filetype .png의 검색어 'monkey'(q=monkey)에 대한 처음 5개 결과(start=0&num=5)를 요청합니다. 마지막으로 쿼리는 client, output, cx 매개변수의 값을 지정합니다. 세 매개변수 모두 필요합니다.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

이미지 검색어 매개변수

as_filetype
설명

선택사항. 지정된 유형의 이미지를 반환합니다. 허용되는 값은 bmp, gif, png, jpg, svg입니다.
예시 q=google&as_filetype=png

이미지
설명

선택사항. 지정된 크기의 이미지를 반환합니다. 여기에서 size는 다음 중 하나일 수 있습니다.

  • icon (소형)
  • small|medium|large|xlarge (중간)
  • xxlarge (크게)
  • huge (초대형)

예시 q=google&as_filetype=png&imgsz=icon

이미지 유형
설명

선택사항. 유형의 이미지를 반환합니다. 다음 중 하나일 수 있습니다.

  • clipart (클립아트)
  • face (얼굴)
  • lineart (선형)
  • news (뉴스)
  • photo (사진)
예시 q=google&as_filetype=png&imgtype=photo

이미지 c
설명

선택사항. 흑백, 그레이 스케일 또는 컬러 이미지를 반환합니다.

  • mono (흑백)
  • gray (그레이 스케일)
  • color (색상)
예시 q=google&as_filetype=png&imgc=gray

이미지 색상
설명

선택사항. 특정 주요 색상의 이미지를 반환합니다.

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
예시 q=google&as_filetype=png&imgcolor=yellow

as_rights
설명

선택사항. 라이선스를 기반으로 한 필터입니다. 지원되는 값은 다음과 같습니다.

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
예시 q=cats&as_filetype=png&as_rights=cc_attribute

요청 한도

아래 차트에는 Google에 보내는 검색 요청의 제한사항이 나와 있습니다.

구성요소 한도 설명
검색 요청 길이 2,048바이트  
검색어 수 10 q, as_epq, as_eq, as_lq, as_oq, as_q와 같은 매개변수에 용어를 포함합니다.
알림당 결과 수 20 num 매개변수를 20보다 큰 숫자로 설정하면 20개의 결과만 반환됩니다. 더 많은 결과를 얻으려면 여러 요청을 보내고 요청할 때마다 start 매개변수의 값을 증가시켜야 합니다.

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

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

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

문자 인코딩

서버는 웹페이지와 같은 데이터를 브라우저와 같은 사용자 에이전트에 인코딩된 바이트 시퀀스로 전송합니다. 그런 다음 사용자 에이전트는 바이트를 일련의 문자로 디코딩합니다. WebSearch 서비스에 요청을 보낼 때 검색어와 수신하는 XML 응답에 모두 인코딩 스킴을 지정할 수 있습니다.

ie 요청 매개변수를 사용하여 HTTP 요청에 있는 문자의 인코딩 메커니즘을 지정할 수 있습니다. oe 매개변수를 사용하여 Google에서 XML 응답을 인코딩하는 데 사용해야 하는 인코딩 스키마를 지정할 수도 있습니다. ISO-8859-1 (또는 latin1) 이외의 인코딩 스키마를 사용하는 경우 ie 및 oe 매개변수에 올바른 값을 지정해야 합니다.

참고: 여러 언어로 검색 기능을 제공하는 경우 ie 및 oe 매개변수에 utf8 (UTF-8) 인코딩 값을 사용하는 것이 좋습니다.

ie 및 oe 매개변수에 사용할 수 있는 값의 전체 목록은 문자 인코딩 스키마 부록을 참조하세요.

문자 인코딩에 관한 자세한 내용은 http://www.w3.org/TR/REC-html40/charset.html을 참고하세요.

인터페이스 언어

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

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

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

특정 언어로 작성된 문서 검색

lr 요청 매개변수를 사용하여 검색결과를 특정 언어 또는 여러 언어로 작성된 문서로 제한할 수 있습니다.

lr 매개변수는 부울 연산자를 지원하므로 검색결과에 포함하거나 제외할 언어를 여러 개 지정할 수 있습니다.

다음 예시에서는 부울 연산자를 사용하여 다양한 언어로 문서를 요청하는 방법을 보여줍니다.

일본어로 작성된 문서의 경우:

lr=lang_jp

이탈리아어 또는 독일어로 작성된 문서:

lr=lang_it|lang_de

헝가리어 또는 체코어로 작성되지 않은 문서의 경우:

lr=(-lang_hu).(-lang_cs)

lr 매개변수에 사용 가능한 값의 전체 목록은 언어 컬렉션 값 섹션을, 이러한 연산자 사용에 관한 자세한 내용은 부울 연산자 섹션을 참고하세요.

중국어 간체와 중국어 번체는 중국어의 두 가지 쓰기 변형입니다. 동일한 개념이 각 변형에서 다르게 작성될 수 있습니다. 대안 중 하나의 검색어가 입력되면 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 웹 검색은 다음과 같은 다양한 방법으로 검색결과를 필터링합니다.

검색결과 자동 필터링

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

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

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

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

언어 및 국가 필터링

Google WebSearch 서비스는 모든 웹 문서의 마스터 색인에서 결과를 반환합니다. 마스터 색인에는 언어와 출신 국가 등 특정 속성별로 그룹화된 문서의 하위 컬렉션이 포함됩니다.

lr 및 cr 요청 매개변수를 사용하여 검색결과를 각각 특정 언어로 작성되었거나 특정 국가에서 시작된 문서의 하위 컬렉션으로 제한할 수 있습니다.

Google WebSearch는 다음을 분석하여 문서의 언어를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)
  • 문서 내의 언어 메타 태그
  • 문서의 본문 텍스트에 사용되는 기본 언어


또한 lr 매개변수의 정의, 특정 언어로 작성된 문서 검색 섹션, lr 매개변수 값으로 사용할 수 있는 언어 컬렉션 값 섹션에서 언어별 결과 제한 방법을 자세히 알아보세요.

Google WebSearch는 다음을 분석하여 문서의 국가를 결정합니다.

  • 문서 URL의 최상위 도메인 (TLD)
  • 웹 서버 IP 주소의 지리적 위치

출발 국가별 결과를 제한하는 방법에 대한 자세한 내용은 cr 매개변수 및 cr 매개변수의 값으로 사용할 수 있는 Country Collection Values의 정의를 참고하세요.

참고: 언어 값과 국가 값을 결합하여 검색결과를 맞춤설정할 수 있습니다. 예를 들어 프랑스어로 작성된 문서를 프랑스 또는 캐나다에서 요청하거나 네덜란드에서 영어로 작성되지 않은 문서를 요청할 수 있습니다. lr 및 cr 매개변수는 모두 부울 연산자를 지원합니다.

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

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

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

세이프서치는 다음 언어로 제공됩니다.

네덜란드어
영어
프랑스어
독일어 		이탈리아어
포르투갈어 (브라질)
스페인어
중국어 번체

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

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

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

세이프서치를 활성화한 상태에서 검색결과에 불쾌감을 주는 콘텐츠가 포함된 사이트를 발견했다면 safesearch@google.com으로 사이트 URL을 이메일로 보내주세요. Google에서 사이트를 조사하도록 하겠습니다.

XML 결과

Google XML 결과 DTD

Google은 동일한 DTD를 사용하여 모든 검색결과 유형의 XML 형식을 설명합니다. 많은 태그와 속성이 모든 검색 유형에 적용할 수 있습니다. 하지만 일부 태그는 특정 검색 유형에만 적용할 수 있습니다. 따라서 DTD의 정의는 이 문서에 제공된 정의보다 덜 제한적일 수 있습니다.

이 문서에서는 WebSearch와 관련된 DTD의 이러한 측면을 설명합니다. DTD를 살펴보면 WebSearch를 사용 중이라면 여기에 문서화되지 않은 태그와 속성을 무시해도 됩니다. DTD와 문서의 정의가 다르다면 그 사실이 이 문서에 설명되어 있습니다.

Google은 최신 DTD에 관한 참조와 함께 또는 참조 없이 XML 결과를 반환할 수 있습니다. DTD는 검색 관리자와 XML 파서가 Google의 XML 결과를 이해하는 데 도움이 되는 가이드입니다. Google의 XML 문법은 수시로 변경될 수 있으므로 DTD를 사용하여 각 XML 결과를 검증하도록 파서를 구성하면 안 됩니다.

또한 검색 요청을 제출할 때마다 DTD를 가져오도록 XML 파서를 구성하면 안 됩니다. Google은 DTD를 드물게 업데이트하므로 이러한 요청으로 인해 불필요한 지연 및 대역폭 요구사항이 발생합니다.

XML 결과를 얻으려면 xml_no_dtd 출력 형식을 사용하는 것이 좋습니다. 검색 요청에 xml 출력 형식을 지정하는 경우 유일한 차이점은 XML 결과에 다음 줄이 포함되는 것입니다.

<!DOCTYPE GSP SYSTEM "google.dtd">

최신 DTD는 http://www.google.com/google.dtd에서 액세스할 수 있습니다.

현재 DTD의 일부 기능은 사용 가능하지 않거나 지원되지 않을 수 있습니다.

XML 응답 정보

  • XML 태그 정의에 달리 명시되지 않는 한 모든 요소 값은 표시하기에 적합한 유효한 HTML입니다.
  • 일부 요소 값은 표시하기 전에 HTML로 인코딩해야 하는 URL입니다.
  • XML 파서는 문서화되지 않은 속성과 태그를 무시해야 합니다. 이렇게 하면 Google에서 XML 출력에 기능을 더 추가해도 애플리케이션을 수정하지 않고도 계속 사용할 수 있습니다.
  • 특정 문자가 XML 태그에 값으로 포함된 경우 이스케이프 처리되어야 합니다. XML 프로세서는 이러한 항목을 다시 적절한 문자로 변환해야 합니다. 항목을 올바르게 변환하지 않으면 예를 들어 브라우저에서 & 문자를 '&amp;로 렌더링할 수 있습니다. XML 표준에는 이러한 문자가 설명되어 있습니다. 이러한 문자는 아래 표에 재현되어 있습니다.

    문자 기반이란 이스케이프 처리된 양식 항목 문자 코드
    앰퍼샌드 & &amp; &#38;
    작은따옴표 ' &apos; &#39;
    큰따옴표 " &quot; &#34;
    초과 > &gt; &#62;
    미만 < &lt; &#60;

일반 및 고급 검색어의 XML 결과

일반/고급 검색: 샘플 쿼리 및 XML 결과

이 샘플 WebSearch 요청은 검색어 'socer'(q=socer)에 관한 결과 10개(num=10)를 요청합니다. 'soccer'는 이 예에서 의도적으로 철자가 틀린 단어입니다.

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i

이 요청은 아래의 XML 결과를 반환합니다. XML 결과에는 결과에 포함되지 않은 특정 태그가 표시되는 위치를 나타내는 여러 주석이 있습니다.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

일반/고급검색: XML 태그

일반 검색 요청과 고급검색 요청에 대한 XML 응답은 둘 다 동일한 XML 태그 집합을 사용합니다. 이러한 XML 태그는 위의 XML 예에 나와 있으며 아래 표에 설명되어 있습니다.

아래의 XML 태그는 태그 이름을 기준으로 알파벳순으로 나열되며 각 태그 정의에는 태그에 관한 설명이 포함되어 있습니다. 예를 들어 태그가 XML 결과에 표시되는 방식과 태그 콘텐츠의 형식을 보여줍니다. 태그가 다른 XML 태그의 하위 태그이거나 태그에 하위 태그 또는 자체 속성이 있는 경우에는 해당 정보가 태그의 정의 표에도 제공됩니다.

아래 정의의 일부 하위 태그 옆에 특정 기호가 표시될 수 있습니다. 이러한 기호와 기호의 의미는 다음과 같습니다.

? = 선택적 하위 태그
* = 0개 이상의 하위 태그 인스턴스
+ = 1개 이상의 하위 태그 인스턴스
A B C D F H 나 좌 M N 소 Q R S T U X

anchor_text
정의

<anchor_text> 태그는 검색결과 집합과 연결된 상세검색 라벨을 식별하기 위해 사용자에게 표시해야 하는 텍스트를 지정합니다. 상세검색 라벨은 영숫자가 아닌 문자를 밑줄로 대체하므로 사용자 인터페이스에 <label> 태그의 값을 표시해서는 안 됩니다. 대신 <anchor_text> 태그의 값을 표시해야 합니다.

예 <anchor_text>골프 코스</anchor_text>
하위 태그: FacetItem
콘텐츠 형식 텍스트

차단
정의

이 태그는 프로모션 결과의 본문 줄에 블록의 내용을 캡슐화합니다. 각 블록에는 하위 태그 T, U, L이 있습니다. 비어 있지 않은 T 태그는 블록에 텍스트가 포함되어 있음을 나타냅니다. 비어 있지 않은 U 태그와 L 태그는 블록에 링크가 포함되어 있음을 나타냅니다 (URL이 U 하위 태그에 있고 앵커 텍스트가 L 하위 태그에 있음).
하위 태그 T, U, L
하위 태그: BODY_LINE
콘텐츠 형식 비어 있음

BODY_LINE
정의

이 태그는 승격된 결과 본문에 있는 줄의 내용을 캡슐화합니다. 각 본문 줄은 여러 개의 BLOCK 태그로 구성되며, 이 태그는 일부 텍스트 또는 URL과 앵커 텍스트가 있는 링크를 포함합니다.
하위 태그 차단*
하위 태그: SL_MAIN
콘텐츠 형식 비어 있음

C
정의

<C> 태그는 WebSearch 서비스가 이 검색결과 URL의 캐시된 버전을 검색할 수 있음을 나타냅니다. XML API를 통해 캐시된 페이지를 검색할 수는 없지만 이 콘텐츠를 사용하기 위해 사용자를 www.google.com으로 리디렉션할 수는 있습니다.
속성
이름 형식 설명
SZ 텍스트 (정수 + 'k') 검색 결과의 캐시된 버전의 크기를 KB ('k') 단위로 제공합니다.
CID 텍스트 Google 캐시에 있는 문서를 식별합니다. 캐시에서 문서를 가져오려면 다음과 같이 작성된 검색어를 전송합니다.
cache:CIDtext:escapedURL

이스케이프 처리된 URL은 UE 태그에서 사용할 수 있습니다.
예 <C SZ="6k" CID="kvOXK_cYSSgJ" />
하위 태그: HAS
콘텐츠 형식 비어 있음

C2C
정의 <C2C> 태그는 결과가 중국어 번체 언어 페이지를 참조함을 나타냅니다. 이 태그는 중국어 간체 및 번체 검색을 사용 설정한 경우에만 표시됩니다. 이 기능을 사용 설정 및 중지하는 방법에 대한 자세한 내용은 c2coff 쿼리 매개변수 정의를 참조하세요.
콘텐츠 형식 텍스트

컨텍스트
정의

<Context> 태그는 검색결과 집합과 연결된 상세검색 라벨의 목록을 요약합니다.
예 <Context>
하위 태그 title, Facet+
콘텐츠 형식 컨테이너

크롤링 날짜
정의

<CRAWLDATE> 태그는 페이지가 마지막으로 크롤링된 날짜를 식별합니다. 모든 검색결과 페이지에 CRAWLDATE가 반환되지는 않습니다.
예 <CRAWLDATE>2005년 5월 21일</CRAWLDATE>
하위 태그: R
콘텐츠 형식 텍스트

DI
정의

<DI> 태그는 단일 검색결과에 대한 오픈 디렉터리 프로젝트(ODP) 카테고리 정보를 요약합니다.
예 <DI>
하위 태그 DT?, DS를 사용하나요?
하위 태그: HAS
콘텐츠 형식 비어 있음

DS
정의

<DS> 태그는 ODP 디렉터리의 단일 카테고리에 대해 나열된 요약을 제공합니다.
예 <DS>&lt;b&gt;축구&lt;/b&gt; 이력서를 인터넷에 직접 게시하세요.</DS>
하위 태그: DI
콘텐츠 형식 텍스트 (HTML을 포함할 수 있음)

DT
정의

<DT> 태그는 ODP 디렉터리에 나열된 단일 카테고리의 제목을 제공합니다.
예 <DT>SoccerConnection.net</DT>
하위 태그: DI
콘텐츠 형식 텍스트 (HTML을 포함할 수 있음)

패싯
정의

<Facet> 태그에는 <FacetItem> 태그의 논리적 그룹화가 포함됩니다. 이러한 그룹은 프로그래밍 검색 엔진 XML 사양 형식을 사용하여 만들 수 있습니다. 이러한 그룹을 만들지 않으면 results_xml_tag_Context><Context> 태그에 최대 4개의 <Facet> 태그가 포함됩니다. 각 <Facet> 태그 내의 항목은 표시를 위해 그룹화되지만 논리적 관계는 없을 수 있습니다.
예 <Facet>
하위 태그 FacetItem+, title+
하위 태그: 컨텍스트
콘텐츠 형식 컨테이너

FacetItem
정의

<FacetItem> 태그는 검색결과 집합과 연결된 상세검색 라벨에 관한 정보를 요약합니다.
예 <FacetItem>
하위 태그 label, anchor_text+
하위 태그: 패싯
콘텐츠 형식 FacetItem

FI
정의 <FI> 태그는 검색에 대해 문서 필터링이 수행되었는지 여부를 나타내는 플래그 역할을 합니다. Google의 검색결과 필터에 관한 자세한 내용은 이 문서의 자동 필터링 섹션을 참고하세요.
예 <FI />
하위 태그: RES
콘텐츠 형식 비어 있음

GSP
정의

<GSP> 태그는 Google XML 검색결과에 반환된 모든 데이터를 캡슐화합니다. 'GSP'는 'Google 검색 프로토콜'의 약어입니다.
속성
이름 형식 설명
모두 텍스트 (정수) VER 속성은 검색결과 출력의 버전을 지정합니다. 현재 출력 버전은 '3.2'입니다.
예 <GSP VER="3.2">
하위 태그 PARAM+, Q, RES?, TM
콘텐츠 형식 비어 있음

HAS
정의 <HAS> 태그는 특정 URL에서 지원되는 모든 특수 검색 요청 매개변수에 관한 정보를 캡슐화합니다.

참고: WebSearch의 <HAS> 정의는 DTD보다 더 제한적입니다.

하위 태그 DI?, L?, C?, RT?
하위 태그: R

ISURL
정의 연결된 검색어가 URL인 경우 Google에서는 <ISURL> 태그를 반환합니다.
하위 태그: GSP
콘텐츠 형식 비어 있음

L
정의 <L> 태그가 있으면 WebSearch 서비스가 이 검색결과 URL에 연결되는 다른 사이트를 찾을 수 있음을 나타냅니다. 이러한 사이트를 찾으려면 link: 특수 검색어를 사용합니다.
하위 태그: HAS
콘텐츠 형식 비어 있음

라벨
정의

<label> 태그는 수신하는 검색결과를 필터링하는 데 사용할 수 있는 상세검색 라벨을 지정합니다. 상세검색 라벨을 사용하려면 다음 예와 같이 Google에 보내는 HTTP 요청의 q 매개변수 값에 more:[[label tag value]] 문자열을 추가하세요. 이 값은 검색어를 Google에 보내기 전에 URL 이스케이프 처리해야 합니다.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

참고: <label> 태그는 검색결과의 특정 URL과 연결된 상세검색 라벨을 식별하는 <Label> 태그와 다릅니다.
예 <label>골프코스</label>
하위 태그: FacetItem
콘텐츠 형식 텍스트

한국어
정의

<LANG> 태그에는 Google에서 가장 근접한 검색 결과 언어가 포함됩니다.
예 <LANG>en</LANG>
하위 태그: R
콘텐츠 형식 텍스트

M
정의

<M> 태그는 검색의 총 예상 결과 수를 식별합니다.

참고: 이 추정치는 정확하지 않을 수 있습니다.

예 <M>16200000</M>
하위 태그: RES
콘텐츠 형식 텍스트

NB
정의

<NB> 태그는 결과 집합의 탐색 정보(검색결과의 다음 페이지 또는 이전 검색결과 페이지로 연결되는 링크)를 요약합니다.

참고: 이 태그는 더 많은 결과가 있는 경우에만 존재합니다.
예 <NB>
하위 태그 NU?, PU는 어떤가요?
하위 태그: RES
콘텐츠 형식 비어 있음

NU
정의

<NU> 태그에는 다음 검색결과 페이지로 연결되는 상대 링크가 포함됩니다.
예 <NU>/search?q=flowers&num=10&hl=ko&ie=UTF-8
&output=xml&client=test&start=10</NU>
하위 태그: NB
콘텐츠 형식 텍스트 (상대 URL)

PARAM
정의

<PARAM> 태그는 XML 결과와 연결된 HTTP 요청에 제출된 입력 매개변수를 식별합니다. 매개변수에 대한 정보는 이름, 값, 원본_값 등의 태그 속성에 포함되며 HTTP 요청에 제출된 매개변수마다 1개의 PARAM 태그가 있습니다.
속성
이름 형식 설명
name 텍스트 입력 매개변수 이름입니다.
value HTML 입력 매개변수 값의 HTML 형식 버전입니다.
original_value 텍스트 입력 매개변수 값의 원래 URL 이스케이프 처리된 버전입니다.
예 <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
하위 태그: GSP
콘텐츠 형식 복잡함

PU
정의

<PU> 태그는 검색결과의 이전 페이지에 대한 상대 링크를 제공합니다.
예 <PU>/search?q=flowers&num=10&hl=ko&output=xml
&client=test&start=10</PU>
하위 태그: NB
콘텐츠 형식 텍스트 (상대 URL)

Q
정의

<Q> 태그는 XML 결과와 연결된 HTTP 요청에 제출된 검색어를 식별합니다.
예

<Q>pizza</Q>
하위 태그: GSP
콘텐츠 형식 텍스트

R
정의

<R> 태그는 개별 검색결과의 세부정보를 캡슐화합니다.

참고: WebSearch의 <R> 태그 정의는 DTD보다 더 제한적입니다.

속성
이름 형식 설명
구매 불가 텍스트 (정수) 이 검색결과의 색인 (1부터 시작)을 나타냅니다.
마임 텍스트 검색결과의 MIME 유형을 나타냅니다.
하위 태그 U, UE, T?, CRAWLDATE, S?, Lang?, HAS
하위 태그: RES

레지
정의

<RES> 태그는 개별 검색결과 집합과 이러한 결과에 대한 세부정보를 요약합니다.
속성
이름 형식 설명
SN 텍스트 (정수) 이 결과 집합에 반환된 첫 번째 검색결과의 색인 (1부터 시작)을 나타냅니다.
KO 텍스트 (정수) 이 결과 집합에서 반환된 마지막 검색결과의 색인 (1부터 시작)을 나타냅니다.
예 <RES SN="1" EN="10">
하위 태그 M, FI?, XT?, NB?, R*
하위 태그: GSP
콘텐츠 형식 비어 있음

S
정의

<S> 태그에는 굵게 강조 표시된 검색어를 보여주는 검색결과의 발췌문이 포함됩니다. 적절한 텍스트 줄바꿈을 위해 발췌 부분에 줄바꿈이 포함됩니다.
예 <S>워싱턴 (CNN) -- 부시 대통령 사법 지명부를 상대로 한 상원 교정을 종결하기 위한 입찰을 통해 5명의 후보가 최종 투표에 진출하고 상원 의회에서는 상원의 교섭을 막을 수 있었다.
하위 태그: R
콘텐츠 형식 텍스트 (HTML)

SL_MAIN
정의

이 태그는 프로모션 결과의 콘텐츠를 요약합니다. 프로모션을 파싱하는 데 사용합니다. 제목 링크의 앵커 텍스트와 URL은 각각 T와 U 하위 태그에 포함되어 있습니다. 본문 텍스트 줄과 링크는 BODY_LINE 하위 태그에 포함되어 있습니다.
하위 태그 BODY_LINE*, T, U
하위 태그: SL_RESULTS
콘텐츠 형식 비어 있음

SL_RESULTS
정의

프로모션 결과의 컨테이너 태그입니다. 검색결과에 프로모션이 표시될 때마다 이 중 하나가 표시됩니다. SL_MAIN 하위 태그에는 기본 결과 데이터가 포함됩니다.
하위 태그 SL_MAIN*
하위 태그: R
콘텐츠 형식 비어 있음

맞춤법
정의

<Spelling> 태그는 제출된 쿼리의 대체 맞춤법 제안을 캡슐화합니다. 이 태그는 검색결과의 첫 번째 페이지에만 표시됩니다. 맞춤법 제안은 한국어, 영어, 중국어, 일본어로 제공됩니다.

참고: Google은 gl 매개변수 값이 소문자인 쿼리의 경우에만 맞춤법 추천을 반환합니다.
예 <Spelling>
하위 태그 제안
하위 태그: GSP
콘텐츠 형식 비어 있음

추천
정의 <Suggestion> 태그에는 제출된 쿼리에 대한 대체 맞춤법 제안이 포함됩니다. 태그의 콘텐츠를 사용하여 검색 사용자에게 대체 맞춤법을 추천할 수 있습니다. q 속성의 값은 검색어로 사용할 수 있는 URL 이스케이프된 맞춤법 제안입니다.
속성
이름 방식 설명
q 텍스트 q 속성은 맞춤법 추천의 URL 이스케이프 처리된 버전을 지정합니다.
예 <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion>
하위 태그: 맞춤법
콘텐츠 형식 텍스트 (HTML)

T
정의 <T> 태그에는 결과의 제목이 포함됩니다.
예 <T>아미시 이스트 코스트 피자 전문점</T>
하위 태그: R
콘텐츠 형식 텍스트 (HTML)

제목
정의

<Context>의 하위 요소로서 <title> 태그에는 프로그래밍 검색 엔진의 이름이 포함됩니다.

<Facet>의 하위 요소로서 <title> 태그는 패싯 모음의 제목을 제공합니다.
예

<Context>의 하위 요소로: <title>내 검색엔진</title>

<Facet>의 하위 요소: <title>facet title</title>
하위 태그: 컨텍스트, 패싯
콘텐츠 형식 텍스트

TM
정의

<TM> 태그는 초 단위로 측정된 검색결과를 반환하는 데 필요한 총 서버 시간을 식별합니다.
예 <TM>0.100445</TM>
하위 태그: GSP
콘텐츠 형식 텍스트 (부동 소수점 수)

TT
정의 <TT> 태그는 검색 팁을 제공합니다.
예 <TT>&lt;i&gt;도움말: 대부분의 브라우저에서 Return 키를 누르면 검색 버튼을 클릭하는 것과 동일한 결과가 나타납니다.&lt;/i&gt;</TT>
하위 태그: GSP

U
정의 <U> 태그는 검색결과의 URL을 제공합니다.
예 <U>http://www.dominos.com/</U>
하위 태그: R
콘텐츠 형식 텍스트 (절대 URL)

UD
정의

<UD> 태그는 검색결과에 IDN으로 인코딩된 (국제 도메인 이름) URL을 제공합니다. 이 값을 사용하면 현지 언어를 사용하여 도메인을 표시할 수 있습니다. 예를 들어 IDN으로 인코딩된 URL http://www.%E8%8A%B1%E4%BA%95.com은 디코딩되어 http://www.일정에 맞게鮨.com으로 표시할 수 있습니다. 이 <UD> 태그는 ud 매개변수가 포함된 요청의 검색결과에만 포함됩니다.

참고: 이 기능은 베타 기능입니다.
예 <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
하위 태그: R
콘텐츠 형식 텍스트 (IDN으로 인코딩된 URL)

UE
정의 <UE> 태그는 검색결과의 URL을 제공합니다. 이 값은 URL에서 쿼리 매개변수로 전달하기에 적합하도록 URL 이스케이프 처리됩니다.
예 <UE>http://www.dominos.com/</UE>
하위 태그: R
콘텐츠 형식 텍스트 (URL로 이스케이프 처리된 URL)

득점
정의 <XT> 태그는 M 태그에 의해 지정된 예상 총 결과 수가 실제로 정확한 총 결과 수를 나타낸다는 것을 나타냅니다. 자세한 내용은 이 문서의 자동 필터링 섹션을 참조하세요.
예 <XT />
하위 태그: RES
콘텐츠 형식 비어 있음


이미지 검색어의 XML 결과

이 샘플 이미지 요청은 검색어 'monkey'(q=monkey)에 관한 결과 5개(num=5)를 요청합니다. 

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

이 요청은 아래의 XML 결과를 반환합니다. 


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

이미지 검색: XML 태그

아래 표는 이미지 검색어의 XML 응답에 사용되는 추가 XML 태그를 보여줍니다.

아래 정의의 일부 하위 태그 옆에 특정 기호가 표시될 수 있습니다. 이러한 기호와 기호의 의미는 다음과 같습니다.

? = 선택적 하위 태그
* = 0개 이상의 하위 태그 인스턴스
+ = 1개 이상의 하위 태그 인스턴스

골목
정의

<RG> 태그는 개별 이미지 검색결과의 세부정보를 포함합니다.
속성
이름 형식 설명
구매 불가 텍스트 (정수) 이 검색결과의 색인 (1부터 시작)을 나타냅니다.
마임 텍스트 검색결과의 MIME 유형을 나타냅니다.
하위 태그: RES
RU
정의

<RU tag> 태그에는 각 이미지 검색결과의 세부정보가 포함됩니다.
하위 태그: R