이 페이지에서는 다음과 같은 경우에만 사용할 수 있는 Custom Search JSON API의 XML 버전을 참조합니다. Google Site Search 고객.
- 개요
- 프로그래밍 검색 엔진 요청 형식
<ph type="x-smartling-placeholder">
- </ph>
- 요청 개요
- 검색어
- 요청 매개변수 <ph type="x-smartling-placeholder">
- 쿼리 및 결과 국제화 프레젠테이션
<ph type="x-smartling-placeholder">
- </ph>
- 문자 인코딩
- 인터페이스 언어
- 중국어 간체 및 번체 검색
- 결과 필터링 <ph type="x-smartling-placeholder">
- XML 결과
<ph type="x-smartling-placeholder">
- </ph>
- Google XML 결과 DTD
- XML 응답 정보
- 일반, 이미지, 이미지에 대한 XML 결과 고급검색 검색어 <ph type="x-smartling-placeholder">
개요
Google WebSearch 서비스를 사용하면 Google Site Search를 사용할 수 있습니다. 자신의 웹사이트에 Google 검색 결과를 표시할 수 있습니다. 이 WebSearch 서비스는 단순한 HTTP 기반 프로토콜을 사용하여 있습니다. 검색 관리자는 검색 방식을 완전히 제어할 수 있습니다. 사용자에게 그러한 결과를 제시하는 방식이 있습니다. 이 문서에서는 Google 검색 요청 및 결과 형식
Google WebSearch 결과를 검색하기 위해 애플리케이션은 Google에 전송합니다. 그런 다음 Google은 검색결과를 XML 형식으로 반환합니다. 형식으로 입력합니다. XML 형식 결과를 사용하면 검색결과가 표시되는 방식
웹 검색 요청 형식
요청 개요
Google 검색 요청은 표준 HTTP GET 명령어입니다. 그것은
에 관련 있는 매개변수 모음이
쿼리합니다. 이 매개변수는 요청 URL에 name=value로 포함됩니다.
앰퍼샌드 (&) 문자로 구분되어 있습니다. 매개변수
고유 엔진 ID (cx)와 같은 데이터를 기반으로
HTTP 요청을 전송하는 엔진입니다. 웹 검색 또는 이미지 검색 서비스는
XML은 HTTP 요청에 대한 응답으로 발생합니다.
검색어
대부분의 검색 요청에는 하나 이상의 검색어가 포함됩니다. 검색어 검색 요청에서 매개변수 값으로 표시됩니다.
검색어는 여러 유형의 정보를 지정하여 Google이 반환하는 검색결과를 구성할 수 있습니다. 쿼리는 다음을 지정할 수 있습니다.
- 포함할 단어 또는 구문 또는
제외
<ph type="x-smartling-placeholder">
- </ph>
- 검색어에 포함된 모든 단어 (기본값)
- 검색어의 정확한 구문
- 검색어에 포함된 단어 또는 구문
- 문서에서
검색어
<ph type="x-smartling-placeholder">
- </ph>
- 문서 내 모든 위치 (기본값)
- 문서 본문에만
- 문서 제목에만
- 문서 URL에만
- 문서의 링크에서만
- 문서 자체에 대한 제한사항
<ph type="x-smartling-placeholder">
- </ph>
- 특정 파일 형식의 문서 포함 또는 제외 (예: PDF 파일 또는 Word 문서)
- 특수 URL 쿼리는
검색하지 않고 주어진 URL에 대한 정보를 얻을 수 있습니다.
<ph type="x-smartling-placeholder">
- </ph>
- 다음과 같은 URL에 대한 일반 정보를 반환하는 검색어 오픈 디렉터리 카테고리, 스니펫 또는 언어
- URL로 연결되는 일련의 웹페이지를 반환하는 검색어
- 지정된 URL과 유사한 일련의 웹페이지를 반환하는 검색어
기본 검색
검색어 매개변수 값은 URL 이스케이프되어야 합니다. 참고: 는 검색 쿼리 이에 대해서는 이 문서의 URL 이스케이프 섹션에서 자세히 설명합니다.
검색어는 q 매개변수 가 샘플 검색어는 다음과 같습니다.
q=horses+cows+pigs
기본적으로 Google WebSearch 서비스는 검색어에 포함된 모든 단어를 포함
요청 매개변수
이 섹션에는 검색 요청을 수행합니다. 매개변수는 두 개의 목록으로 분할됩니다. 첫 번째 목록에는 모든 검색 요청과 관련된 매개변수가 포함됩니다. 두 번째 목록에는 입니다 고급검색 요청과 관련된 내용만 볼 수 있습니다.
다음 세 가지 요청 매개변수가 필요합니다.
- client 매개변수는
google-csbe로 설정해야 합니다. - output 매개변수는
반환된 XML 결과의 형식입니다. 결과는 (xml)을 사용하여 반환될 수 있습니다.
또는 Google의 DTD를 참조 (
xml_no_dtd)하지 않습니다. 권장 조치 이 값을xml_no_dtd로 설정합니다. 참고: 이 매개변수를 지정하지 않으면 .
- 고유한 ID를 나타내는 cx 매개변수
엔진의 ID입니다.
이 매개변수 외에 가장 일반적으로 사용되는 요청 매개변수는 다음과 같습니다.
샘플 웹 검색어
아래 예는 다양한 쿼리 매개변수가 사용되는 방식을 보여줍니다. 에 대한 정의 웹검색(WebSearch) 검색어(WebSearch) 검색어(WebSearch Query) 쿼리’ 매개변수 정의 및 고급 검색어 이 문서의 매개변수 섹션입니다.
이 요청에서 처음 10개의 결과 (start=0&num=10)를 요청합니다.
'레드삭스'라는 검색어에 대한 결과 (q=red+sox). 또한
는 결과를 캐나다 웹사이트 (cr=countryCA)에서 가져와야 함을 지정합니다.
프랑스어 (lr=lang_fr)로 작성해야 합니다. 마지막으로
클라이언트, 출력의 값을 지정합니다.
및 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
이 예에서는 일부 고급검색 검색어를 사용합니다.
매개변수를 사용하여 검색어를 추가로 맞춤설정할 수 있습니다. 이 요청은 as_q
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 매개변수는 간소화된 API를 활성화 또는 비활성화합니다. 중국어 번체 검색 기능을 지원합니다. 이 매개변수의 기본값은
|
||||||
| 예시 | q=google&c2coff=1 |
||||||
| 클라이언트 | |
|---|---|
| 설명 | 필수사항: |
| 예시 | q=google&client=google-csbe |
| cr | |
|---|---|
| 설명 | 선택사항. Google 웹 검색은 분석:
국가 (cr) 매개변수 참조 Values 섹션을 참조하세요. |
| 예시 | q=Frodo&cr=countryNZ |
| cx | |
|---|---|
| 설명 | 필수사항: |
| 예시 | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
| filter | |||||||
|---|---|---|---|---|---|---|---|
| 설명 | 선택사항. filter 매개변수는 활성화 또는 Google 검색결과의 자동 필터링을 비활성화합니다. 이 문서의 자동 필터링 섹션을 참조하세요. 문서를 참조하세요.
참고: 기본적으로 Google은 검색결과의 품질을 개선할 수 있습니다. |
||||||
| 예시 | q=google&filter=0 |
||||||
| gl | |
|---|---|
| 설명 | 선택사항. WebSearch 요청에서 |
| 예시 | 이 요청은 영국에서 작성된 문서의
웹검색 결과: |
| hl | |
|---|---|
| 설명 | 선택사항. 쿼리 국제화의 인터페이스 언어 섹션을 참조하세요. 및 결과 프레젠테이션에서 자세한 내용과 지원되는 인터페이스 언어를 확인하세요. 를 참조하세요. |
| 예시 | 이 요청은 프랑스어 와인에 대한 광고를 타겟팅합니다. (Vin은 와인을 뜻하는 프랑스어 용어). q=vin&ip=10.10.10.10&ad=w5&hl=fr |
| hq | |
|---|---|
| 설명 | 선택사항. |
| 예시 | '피자'를 검색합니다. AND '치즈'가 포함됩니다. 표현식은
|
| ie | |
|---|---|
| 설명 | 선택사항. 이 매개변수를 사용해야 하는 경우에 대한 토론은 문자 인코딩 섹션을 참조하세요. 자세한 내용은 문자 인코딩
가능한 |
| 예시 | q=google&ie=utf8&oe=utf8 |
| lr | |
|---|---|
| 설명 | 선택사항. Google 웹 검색은 분석:
언어 ( |
| 예시 | q=Frodo&lr=lang_en |
| num | |
|---|---|
| 설명 | 선택사항. 기본 참고: 총 검색 결과 수가 적은 경우 요청 수보다 많으면 사용 가능한 모든 검색 결과가 반환됩니다. |
| 예시 | q=google&num=10 |
| oe | |
|---|---|
| 설명 | 선택사항. 이 매개변수를 사용해야 하는 경우에 대한 토론은 문자 인코딩 섹션을 참조하세요. 자세한 내용은 문자 인코딩
가능한 |
| 예시 | q=google&ie=utf8&oe=utf8 |
| output | |||||||
|---|---|---|---|---|---|---|---|
| 설명 | 필수사항:
|
||||||
| 예시 | output=xml_no_dtd |
||||||
| q | |
|---|---|
| 설명 | 선택사항. 특정 검색어를 검색하는 데 사용할 수 있는
Google 검색 제어판에서는 상단에 있는
참고: q 매개변수에 지정된 값은 URL 이스케이프 처리되어야 합니다. |
| 예시 | q=vacation&as_oq=london+paris |
| 안전 | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| 설명 | 선택사항.
자세한 내용은 성인용 콘텐츠 필터링 사용 섹션을 참조하세요. |
||||||||
| 예시 | q=adult&safe=high |
||||||||
| 시작 | |
|---|---|
| 설명 | 선택사항.
|
| 예시 | start=10 |
| 정렬 | |
|---|---|
| 설명 | 선택사항. |
| 예시 |
|
| ud | |
|---|---|
| 설명 | 선택사항. http://www.花井鮨.com 이 매개변수에 유효한 값은
http://www.xn--elq438j.com. 참고: 이 기능은 베타 기능입니다. |
| 예시 | q=google&ud=1 |
고급검색
이미지 아래에 나열된 추가 쿼리 매개변수는 고급 검색어와 관련이 있습니다. 고급검색을 제출할 때 여러 매개변수의 값 (예: as_eq, as_epq, as_oq 등)이 모두 쿼리에 고려됩니다. 표시됩니다. Google의 고급검색 페이지를 보여주는 이미지입니다. 이미지에서 각 객체의 이름은 고급검색 매개변수가 내부 또는 옆에 빨간색 텍스트로 작성되어 있습니다. 이 매개변수에 해당하는 페이지의 필드입니다.
고급 검색어 매개변수
| as_dt | |
|---|---|
| 설명 | 선택사항. |
| 예시 | as_dt=i,as_dt=e |
| as_epq | |
|---|---|
| 설명 | 선택사항. |
| 예시 | as_epq=abraham+lincoln |
| as_eq | |
|---|---|
| 설명 | 선택사항. |
| 예시 |
|
| as_lq | |
|---|---|
| 설명 | 선택사항. |
| 예시 |
|
| as_nlo | |
|---|---|
| 설명 | 선택사항. |
| 예시 | 다음은 5에서 10까지 검색 범위를 설정합니다.
|
| as_nhi | |
|---|---|
| 설명 | 선택사항. |
| 예시 | 다음은 5에서 10까지 검색 범위를 설정합니다.
|
| as_oq | |
|---|---|
| 설명 | 선택사항. |
| 예시 |
|
| as_q | |
|---|---|
| 설명 | 선택사항. |
| 예시 |
|
| as_qdr | |
|---|---|
| 설명 | 선택사항.
|
| 예시 |
이 예에서는 지난해의 결과를 요청합니다.
이 예에서는 지난 10일간의 결과를 요청합니다.
|
| as_sitesearch | |
|---|---|
| 설명 | 선택사항. |
| 예시 |
|
특수 검색어
Google WebSearch를 사용하면 검색어에 해당하는 몇 가지 특수 검색어를 사용할 수 있습니다.
Google 검색엔진의 추가 기능에 액세스 이러한
특수 검색어가 q 요청 매개변수의 값에 포함되어야 합니다. 다른 검색어와 마찬가지로
특수 검색어는 URL 이스케이프되어야 합니다. 가
특정 검색어의 개수에는 콜론 (:)이 포함됩니다. 이 캐릭터
URL 이스케이프 처리되어야 합니다. URL 이스케이프 값은 %3A입니다.
| 이전 링크[link:] | |
|---|---|
| 설명 |
또한 as_lq 요청을 사용하여
매개변수를 사용하여 참고: 키워드 플래너를 사용할 때는 다른 검색어를 지정할 수 없습니다.
|
| 예시 |
|
| 불리언 OR 검색 [ 또는 ] | |
|---|---|
| 설명 |
as_oq 요청을 사용할 수도 있습니다. 매개변수를 사용하여 검색어 집합에 포함된 모든 검색어에 대한 검색을 제출할 수 있습니다. 참고: 검색 요청이 는 검색어 "런던+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 |
| 검색어 제외 [-] | |
|---|---|
| 설명 | 제외 (
제외 검색어는 검색어에 더 많은 검색어가 뜻하지 않습니다. 예를 들어 'bass'라는 단어는 결과를 반환할 수 있음 물고기나 음악에 관한 것이죠. 다음에 관한 문서를 찾는 경우 검색 결과에서 음악에 대한 문서를 제외할 수 있습니다. '제외' 검색어를 사용할 수도 있습니다. as_eq 요청을 사용할 수도 있습니다. 특정 단어 또는 구문과 일치하는 문서를 제외하는 매개변수 검색결과만 표시됩니다. |
| 예시 | 사용자 입력: bass -music검색어: q=bass+%2Dmusic |
| 파일 형식 제외 [ -filetype: ] | |
|---|---|
| 설명 |
참고: 여러 개의 광고 단위를
검색 결과에서 Google에서 지원하는 파일 형식은 다음과 같습니다.
향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 Google의 파일 형식 FAQ에서 언제든지 목록을 확인할 수 있습니다. |
| 예시 | 이 예시에서는 'Google'이 언급된 문서를 반환합니다. 하지만 그건
은(는) PDF 문서가 아닙니다. 이 예시에서는 'Google'이 언급된 문서를 반환합니다. 그러나
PDF 및 Word 문서 모두 제외: |
| 파일 형식 필터링 [ filetype: ] | |
|---|---|
| 설명 |
검색을 제한할 수 있습니다.
여러 파일 확장자 중 하나와 일치하는 문서에 검색 결과를
기본적으로 검색결과는 문서를 포함할 수 있습니다. Google에서 지원하는 파일 형식은 다음과 같습니다.
향후 더 많은 파일 형식이 추가될 수 있습니다. 최신 Google의 파일 형식 FAQ에서 언제든지 목록을 확인할 수 있습니다. |
| 예시 | 다음 예는 'Google'이 언급된 PDF 문서를 반환합니다. 이 예시에서는 다음을 언급하는 PDF 및 Word 문서를 반환합니다.
"Google": |
| 검색어 포함 [+] | |
|---|---|
| 설명 | 포함 (+) 검색어는 검색 결과에 포함된 모든 문서에서 이루어져야 합니다. 제외해야 하는 단어 또는 구문 앞에 '+' 기호가 있는 모든 검색결과에 포함 (더하기 기호)를 입력합니다.
Google에서 검색하려고 하는 일반적인 단어 앞에는 |
| 예시 | 사용자 입력: Star Wars Episode +I검색어: q=Star+Wars+Episode+%2BI |
| 링크 전용 검색, 모든 검색어[ allinlinks: ] | |
|---|---|
| 설명 |
검색어에
|
| 예시 | 사용자 입력:allinlinks: Google search검색어: q=allinlinks%3A+Google+search |
| 구문검색 | |
|---|---|
| 설명 | 구문검색(") 검색어를 사용하면 구문을 큰따옴표로 묶거나 하이픈으로 연결할 수 있습니다
구문검색은 유명한 인용문이나 고유 명사 포함 as_epq 요청도 사용할 수 있습니다. 매개변수를 사용하여 구문검색을 제출할 수 있습니다. |
| 예시 | 사용자 입력:"Abraham Lincoln"검색어: q=%22Abraham+Lincoln%22 |
| 텍스트 전용 검색, 모든 검색어 [allintext:] | |
|---|---|
| 설명 |
검색어에
|
| 예시 | 이 예는
'Google' 및 'search' 포함된 모든 문서의 본문에 표시되어야 합니다.
검색결과: 사용자 입력: allintext:Google search검색어: q=allintext%3AGoogle+search |
| 제목 검색, 단일 검색어 [intitle:] | |
|---|---|
| 설명 |
참고:
모든 단어 앞에
앞에
|
| 예시 | 이 예에서는 'Google'이라는 단어가 는
검색결과에 표시된 모든 문서의 제목 및
"검색" 제목, URL, 링크 또는 본문 텍스트의 어디에든 표시해야 함
다음 문서 중 |
| 제목 검색, 모든 용어 [allintitle:] | |
|---|---|
| 설명 |
참고: 검색어 앞에
|
| 예시 | 이 예에서는 'Google'이라는 단어가 및 'search'
|
| URL 검색, 단일 검색어 [inurl:] | |
|---|---|
| 설명 |
|
| 예시 | 이 예에서는 'Google'이라는 단어가 는
검색 결과에 표시된 문서의 URL 및 'search'라는 단어
제목, URL, 링크 또는 본문의 어디에나 나타나야 합니다.
문서: |
| URL 검색, 모든 검색어[allinurl:] | |
|---|---|
| 설명 |
|
| 예시 | 이 예에서는 'Google'이라는 단어가 및 'search'
이 속성은 검색결과에 표시된 모든 문서의 URL에 포함되어야 합니다. |
| 웹 문서 정보 [info:] | |
|---|---|
| 설명 |
참고: 키워드 플래너를 사용할 때는 다른 검색어를 지정할 수 없습니다.
|
| 예시 | 사용자 입력: info:www.google.com검색어: q=info%3Awww.google.com |
샘플 이미지 쿼리
아래 예에서는 다양한 쿼리 매개변수가 사용되는 방식을 보여주는 두 가지 이미지 HTTP 요청을 보여줍니다. 다양한 쿼리 매개변수에 대한 정의는 이 문서의 이미지 쿼리 매개변수 정의 섹션에 제공됩니다.
이 요청은 'monkey'라는 검색어에 대한 처음 5개의 결과 (start=0&num=5)를 요청합니다. (q=monkey), 파일 형식 .png 마지막으로 쿼리는 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 | |
|---|---|
| 설명 | 선택사항. 지정된 유형의 이미지를 반환합니다. 허용되는 값은 |
| 예시 | q=google&as_filetype=png |
| imgsz | |
|---|---|
| 설명 | 선택사항. 지정된 크기의 이미지를 반환합니다. 여기서 크기는 다음 중 하나일 수 있습니다.
|
| 예시 | q=google&as_filetype=png&imgsz=icon |
| 이미지 유형 | |
|---|---|
| 설명 | 선택사항. 다음 중 하나일 수 있는 유형의 이미지를 반환합니다.
|
| 예시 | q=google&as_filetype=png&imgtype=photo |
| imgc | |
|---|---|
| 설명 | 선택사항. 흑백, 그레이 스케일 또는 컬러 이미지를 반환합니다.
|
| 예시 | q=google&as_filetype=png&imgc=gray |
| imgcolor | |
|---|---|
| 설명 | 선택사항. 특정 주요 색상의 이미지를 반환합니다.
|
| 예시 | q=google&as_filetype=png&imgcolor=yellow |
| as_rights | |
|---|---|
| 설명 | 선택사항. 라이선스를 기반으로 합니다. 지원되는 값은 다음과 같습니다.
|
| 예시 | 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 검색 사용 매개변수). 문서만 포함하도록 결과를 필터링할 수도 있습니다. 볼 수 있습니다
다음 섹션에서는 여러 언어:
문자 인코딩
서버는 웹페이지와 같은 데이터를 인코딩된 바이트 시퀀스로 표현됩니다. 그런 다음 사용자 에이전트는 문자 시퀀스로 변환합니다. Search Console 서비스를 사용하는 경우 두 URL 모두에 대한 인코딩 스키마를 지정할 수 수신한 XML 응답을 확인합니다.
ie 요청 매개변수를 사용하여
인코딩 메커니즘을 지정합니다. 다음과 같은 작업을 할 수 있습니다.
또한 oe 매개변수를 사용하여 인코딩을 지정합니다.
Google이 XML 응답을 인코딩하는 데 사용해야 하는 스키마입니다. 만약
ISO-8859-1 (또는 latin1) 이외의 인코딩 스키마를 사용하는 경우 올바른 값을 지정해야 합니다.
(ie 및 oe 매개변수용)
참고: 여러 검색어에 대해 검색 기능을 제공하는 경우
utf8 (UTF-8) 인코딩 값을 사용하는 것이 좋습니다.
ie 및 oe 매개변수 모두에 적용됩니다.
자세한 내용은 캐릭터 인코딩 스킴 부록을 참조하세요. ie 및 oe 매개변수에 사용할 수 있습니다.
문자 인코딩에 대한 일반적인 내용은 http://www.w3.org/TR/REC-html40/charset.html을 참조하세요.
인터페이스 언어
hl 요청 매개변수를 사용하여 그래픽 인터페이스의 언어를 식별할 수 있습니다. hl 매개변수 값은 특히 언어 제한 (lr 매개변수 사용)이 명시적으로 지정되지 않은 경우 국제 쿼리 이러한 이 경우 hl 매개변수가 검색결과를 촉진할 수 있습니다. 사용자의 입력 언어와 동일한 언어로 작성해야 합니다.
hl 매개변수를 명시적으로 설정하는 것이 좋습니다. Google에서 가장 높은 품질을 선택합니다. 검색결과를 확인할 수 있습니다.
지원되는 인터페이스를 참조하세요. hl 매개변수에 유효한 값의 전체 목록을 보려면 언어 섹션을 참조하세요.
특정 언어로 작성된 문서 검색
lr 요청 매개변수를 사용하여 특정 문서로 작성된 문서로 검색결과를 제한 언어 또는 언어 집합일 수 있습니다.
lr 매개변수는 다음의 부울 연산자를 지원합니다. 검색에 포함 (또는 제외)되어야 하는 여러 언어 있습니다.
다음 예는 부울 연산자를 사용하여 사용할 수 있습니다.
일본어로 작성된 문서의 경우:
lr=lang_jp
이탈리아어 또는 독일어로 작성된 문서의 경우:
lr=lang_it|lang_de
헝가리어 또는 체코어로 작성되지 않은 문서의 경우:
lr=(-lang_hu).(-lang_cs)
자세한 내용은 언어 컬렉션 lr 매개변수 및 부울에 사용 가능한 값의 전체 목록을 보려면 Values(값) 섹션을 참조하세요. 연산자 섹션을 참조하세요. 연산자가 있습니다.
중국어 간체 및 번체 검색
중국어 간체와 번체는 두 가지 쓰기 변형입니다 더 빠릅니다. 같은 개념이 아래 확인할 수 있습니다 변형 중 하나에서 쿼리를 입력하면 Google은 WebSearch 서비스는 두 있습니다.
이 기능을 사용하려면 다음 안내를 따르세요.
- c2coff 요청 매개변수를 0
으로 설정합니다. 및 - 다음 중 한 가지 방법을 사용합니다.
다음 예는 결과 요청에 포함할 쿼리 매개변수를 보여줍니다. 중국어 간체와 번체로 제공됩니다. ( 클라이언트는 예시에 포함되지 않습니다.)
search?hl=zh-CN
&lr=lang_zh-TW|lang_zh-CN
&c2coff=0
결과 필터링
Google 웹 검색은 검색을 필터링하는 다양한 방법을 제공합니다. 결과:
검색결과 자동 필터링
Google은 최상의 검색 결과를 제공하기 위해 두 가지 기술을 사용하여 일반적으로 바람직하지 않은 것으로 간주되는 경우는 다음과 같습니다.
-
중복 콘텐츠: 여러 문서에 해당 집합에서 가장 관련성이 높은 문서만 포함할 수 있습니다.
-
호스트 크라우딩: Google에서 해당 사이트의 일부 검색결과를 표시하지 않을 수도 있고,
에서 더 낮은 결과 표시 더 높은 순위를 차지할 수 있습니다.
일반적인 검색 요청에 대해서는 이러한 필터를 사용 설정해 두는 것이 좋습니다. 필터가 대부분의 검색 품질을 크게 향상시키므로 있습니다. 하지만 filter 쿼리 매개변수를 0으로 설정하면 검색 요청을 수행합니다.
언어 및 국가 필터링
Google WebSearch 서비스는 모든 웹 문서에서 확인할 수 있습니다 마스터 색인은 언어를 포함한 특정 속성별로 그룹화된 문서 출신 국가를 명시해야 합니다.
lr 및 cr 요청 매개변수를 사용하여 특정 언어로 작성되었거나 출발점이 된 특정 국가에만 적용됩니다.
Google 웹 검색은 다음을 분석하여 문서의 언어를 결정합니다.
- 문서 URL의 최상위 도메인 (TLD)
- 문서 내 language 메타 태그
- 문서의 본문 텍스트에 사용되는 기본 언어
lr 매개변수의 정의, Searching Search
특정 언어로 작성된 문서 및 언어 컬렉션 값
자세한 내용은 lr 매개변수 값으로 사용됨
언어에 따라 결과를 제한하는 방법에 대한 정보
Google 웹 검색은 다음을 분석하여 문서의 국가를 결정합니다.
- 문서 URL의 최상위 도메인 (TLD)
- 웹 서버 IP 주소의 지리적 위치
cr 매개변수 및 국가 컬렉션의 정의를 참조하세요. 국가별로 결과를 제한하는 방법에 대한 자세한 내용을 위해 cr 매개변수의 값으로 사용할 수 있는 값 출처입니다.
참고: 언어를 결합할 수 있습니다. 값과 국가 값을 사용하여 검색 결과를 맞춤설정할 수 있습니다. 대상 예를 들어 프랑스어로 작성된 문서를 요청할 수 있고 프랑스 또는 캐나다 출신인 경우, 국외로 서류를 요청할 수도 있습니다. 영어로 작성되어 있지 않습니다. lr 및 cr 매개변수 모두 부울 연산자를 지원합니다.
세이프서치로 성인용 콘텐츠 필터링
많은 Google 고객이 사이트 성인용 콘텐츠가 포함된 광고 Google 세이프서치 필터를 사용하면 성인용 콘텐츠가 포함된 검색결과를 찾고 이를 삭제합니다. Google의 필터는 독점 기술을 사용하여 키워드와 구문을 확인합니다. URL을 입력합니다. 100% 정확한 필터는 없지만 세이프서치는 검색결과에서 압도적인 대부분의 성인용 콘텐츠 삭제 있습니다.
Google은 세이프서치를 최대한 최신, 포괄적으로 유지하고자 가능한 한 많은 노력을 기울였습니다. 확인할 수 있습니다.
세이프서치는 다음 언어로 제공됩니다.
| 네덜란드어 영어 프랑스어 독일어 |
이탈리아어 포르투갈어 (브라질) 스페인어 중국어 번체 |
Google에서 검색결과를 필터링하는 정도를 조정할 수 있습니다. safe 쿼리 매개변수를 사용하는 성인용 콘텐츠 다음 표에서는 Google의 세이프서치 설정과 이러한 설정이 어떻게 설정은 검색결과에 영향을 미칩니다.
| 세이프서치 수준 | 설명 |
|---|---|
| high | 더 엄격한 버전을 사용 설정합니다. 기능을 제공합니다 |
| 중간 | 다음을 포함하는 웹페이지를 차단합니다. 포르노 및 기타 음란물 |
| 사용 안함 | 성인을 필터링하지 않음 콘텐츠가 표시되지 않습니다. |
* 기본 세이프서치 설정은 사용 안함입니다.
세이프서치가 활성화된 상태에서 검색결과에 불쾌감을 주는 콘텐츠가 포함되어 있으면 사이트 URL을 safesearch@google.com으로 보내주시기 바랍니다. Google에서 사이트를 조사하겠습니다.
XML 결과
Google XML 결과 DTD
Google은 동일한 DTD를 사용하여 모든 유형의 XML 형식을 설명합니다. 검색 결과 많은 태그와 속성은 검색 유형 그러나 일부 태그는 특정 검색 유형 따라서 DTD의 정의는 더 적을 수 있습니다. 본 문서에 명시된 정의보다 제한적입니다.
이 문서에서는 관련된 DTD의 측면을 설명합니다. 웹 검색에 사용할 수 있습니다. DTD를 볼 때 WebSearch를 사용하면 참조하세요. DTD와 DTD의 정의가 다른 경우 이 문서에 설명되어 있습니다.
Google은 가장 최근의 DTD를 나타냅니다. DTD는 관리자 검색을 돕기 위한 가이드입니다. XML 파서는 Google의 XML 결과를 이해합니다. Google의 XML은 문법은 때때로 변경될 수 있으므로 DTD를 사용하여 각 XML 결과의 유효성을 검사하는 파서입니다.
또한 DTD로 기록됩니다. Google에서 DTD를 업데이트함 이러한 요청은 불필요한 지연과 대역폭을 요구사항을 충족해야 합니다
XML 결과를 얻으려면 xml_no_dtd 출력 형식을 사용하는 것이 좋습니다. 검색 요청에 xml output 형식을 지정하는 경우 유일한 차이점은 XML 결과에 다음 줄이 포함된다는 점입니다.
<!DOCTYPE GSP SYSTEM "google.dtd">
다음에서 최신 DTD를 확인하실 수 있습니다. http://www.google.com/google.dtd.
현재 DTD의 모든 기능이 제공되거나 지원되지는 않을 수도 있습니다.
XML 응답 정보
- 모든 요소 값은 다음에 해당하는 경우 표시하기에 적합한 유효한 HTML입니다. XML 태그 정의에 설명되어 있습니다.
- 일부 요소 값은 표시됩니다.
- XML 파서는 문서화되지 않은 속성과 태그를 무시해야 합니다. 이렇게 하면 애플리케이션이 수정 없이 계속 작동할 수 있습니다. Google이 XML 출력에 기능을 더 추가하는 경우.
- 일부 문자는
XML 태그입니다. XML 프로세서는 이러한 항목을
입력해야 합니다. 항목을 올바르게 변환하지 않으면
예를 들어 & 문자를 "&"로 사용합니다.
XML
표준에서는 이러한 문자를 설명합니다. 이러한 문자는
아래 표에 나와 있습니다.
문자 이스케이프 형식 항목 문자 코드 앰퍼샌드 & & & 작은따옴표 ' ' ' 큰따옴표 " " " 초과 > > > 미만 < < <
일반 및 고급 검색어의 XML 결과
일반/고급 검색: 샘플 검색어 및 XML 결과
이 샘플 WebSearch 요청은 결과 10개를 요청합니다 (num=10).
'소서'라는 검색어에 대한 (q=socer)는
"축구" 이 예에서는 의도적으로 철자를 잘못 입력했습니다.)
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 | 북 | P | Q | R | 남 | T | U | X |
| anchor_text | |
|---|---|
| 정의 | <anchor_text> 태그는 상세검색을 할 수 있도록 사용자에게 표시해야 하는 검색결과 집합과 관련된 라벨을 표시합니다. 상세검색 라벨이 영숫자가 아닌 문자를 밑줄로 바꾸는 대신 사용자 인터페이스에 <label> 태그의 값을 표시해야 합니다. 대신 <anchor_text> 태그입니다. |
| 예 | <anchor_text>골프 강의</anchor_text> |
| 하위 태그 | FacetItem |
| 콘텐츠 형식 | 텍스트 |
| 차단 | |
|---|---|
| 정의 | 이 태그는 프로모션 결과의 본문 줄에 블록의 콘텐츠를 캡슐화합니다. 각 블록에는 하위 태그 T, U, L이 있습니다. 비어 있지 않은 T 태그는 블록에 텍스트가 포함되어 있음을 나타냅니다. 비어 있지 않은 U 및 L 태그는 블록에 링크 (U 하위 태그에 제공된 URL 및 L 하위 태그에 앵커 텍스트 제공)가 포함되어 있음을 나타냅니다. |
| 하위 태그 | T, U, L |
| 하위 태그 | BODY_LINE |
| 콘텐츠 형식 | 비어 있음 |
| BODY_LINE | |
|---|---|
| 정의 | 이 태그는 승격된 결과의 본문에 있는 줄의 콘텐츠를 캡슐화합니다. 각 본문 줄은 일부 텍스트 또는 URL과 앵커 텍스트가 있는 링크를 포함하는 여러 BLOCK 태그로 구성됩니다. |
| 하위 태그 | 차단* |
| 하위 태그 | SL_MAIN |
| 콘텐츠 형식 | 비어 있음 |
| C | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 정의 | <C> 태그는 WebSearch 서비스가
이 검색결과 URL의 캐시된 버전을 검색할 수 있습니다. 금지사항
XML API를 통해 캐시된 페이지를 가져오지만 사용자를 리디렉션하여
www.google.com으로 리디렉션
있습니다. |
|||||||||
| 속성 |
|
|||||||||
| 예 | <C SZ="6k" CID="kvOXK_cYSSgJ" / | |||||||||
| 하위 태그 | 있음 | |||||||||
| 콘텐츠 형식 | 비어 있음 | |||||||||
| C2C | |
|---|---|
| 정의 | <C2C> 태그는 결과는 중국어 번체 페이지를 나타냅니다. 이 태그 간체 및 번체 중국어 검색이 사용 설정되었습니다. 사용 설정 및 사용 설정에 대한 자세한 내용은 c2coff 쿼리 매개변수 정의를 참조하세요. 이 기능을 사용 중지합니다. |
| 콘텐츠 형식 | 텍스트 |
| 컨텍스트 | |
|---|---|
| 정의 | <Context> 태그는 검색결과 집합과 관련된 상세검색 라벨 |
| 예 | <Context> |
| 하위 태그 | title, Facet+ |
| 콘텐츠 형식 | 컨테이너 |
| 크롤링 날짜 | |
|---|---|
| 정의 | <CRAWLDATE> 태그는 사용자가
페이지가 마지막으로 크롤링되었습니다. 모든 검색결과 페이지에 대해 |
| 예 | <CRAWLDATE>5월 21일, 2005</CRAWLDATE> |
| 하위 태그 | R |
| 콘텐츠 형식 | 텍스트 |
| DI | |
|---|---|
| 정의 | <DI> 태그는 Open Directory Project를 캡슐화합니다. 단일 검색결과에 관한 (ODP) 카테고리 정보 |
| 예 | <DI> |
| 하위 태그 | DT: DS와 같은 항목이 있나요? |
| 하위 태그 | 있음 |
| 콘텐츠 형식 | 비어 있음 |
| DS | |
|---|---|
| 정의 | <DS> 태그는 ODP 디렉터리에 단일 카테고리로 구성됩니다. |
| 예 | <DS> <b>축구</b> 바로 재개하려면 있습니다.</DS> |
| 하위 태그 | DI |
| 콘텐츠 형식 | 텍스트 (HTML을 포함할 수 있음) |
| DT : 기기 트리 | |
|---|---|
| 정의 | <DT> 태그는 단일 카테고리에 나와 있습니다 |
| 예 | <DT>SoccerConnection.net</DT> |
| 하위 태그 | DI |
| 콘텐츠 형식 | 텍스트 (HTML을 포함할 수 있음) |
| 패싯 | |
|---|---|
| 정의 | <Facet> 태그에는 <FacetItem> 태그의 논리적 그룹이 포함됩니다. 다음과 같은 작업을 할 수 있습니다. 만들기 프로그래밍 검색 엔진을 사용하여 이러한 그룹을 엔진 XML 사양 형식을 참조하세요. 계정 소유자가 직접 results_xml_tag_Context><Context> 태그는 위로 4개의 <Facet> 태그에 추가해야 합니다. 각 <Facet> 태그 내의 항목은 표시를 위해 그룹화되지만 논리 관계입니다. |
| 예 | <패싯> |
| 하위 태그 | FacetItem+, title+ |
| 하위 태그 | 컨텍스트 |
| 콘텐츠 형식 | 컨테이너 |
| FacetItem | |
|---|---|
| 정의 | <FacetItem> 태그는 검색결과 집합과 관련된 상세검색 라벨에 대한 정보 |
| 예 | <FacetItem> |
| 하위 태그 | label, anchor_text+ |
| 하위 태그 | 패싯 |
| 콘텐츠 형식 | FacetItem |
| FI | |
|---|---|
| 정의 | <FI> 태그는 플래그 역할을 합니다. - 검색에 대해 문서 필터링이 수행되었는지 여부를 나타냅니다. 자동 필터링 섹션을 참조하세요. 이 문서의 내용을 참고해 Google의 검색결과에 관해 자세히 알아보세요. 필터를 적용합니다. |
| 예 | <FI /> |
| 하위 태그 | RES |
| 콘텐츠 형식 | 비어 있음 |
| GSP | |||||||
|---|---|---|---|---|---|---|---|
| 정의 | <GSP> 태그 는 Google XML 검색 결과에 반환된 모든 데이터를 캡슐화합니다. 'GSP' 은 'Google 검색 프로토콜'의 약어입니다. |
||||||
| 속성 |
|
||||||
| 예 | <GSP VER="3.2"> | ||||||
| 하위 태그 | PARAM+, Q, RES?, TM | ||||||
| 콘텐츠 형식 | 비어 있음 | ||||||
| 있음 | |
|---|---|
| 정의 | <HAS> 태그는
특수 검색에 관한 정보를
요청 매개변수를 참조하세요.
참고: <HAS>의 정의는 WebSearch는 DTD보다 더 제한적입니다. |
| 하위 태그 | DI L?, C?, RT하시겠습니까? |
| 하위 태그 | R |
| ISURL | |
|---|---|
| 정의 | Google은 <ISURL> 태그를 반환합니다. 연결된 검색어가 URL인 경우입니다. |
| 하위 태그 | GSP |
| 콘텐츠 형식 | 비어 있음 |
| L | |
|---|---|
| 정의 | <L> 태그 는 웹 검색 서비스가 에 연결되는 다른 사이트를 찾을 수 있음을 나타냅니다. 이 검색결과 URL입니다. 이러한 사이트를 찾으려면 link: 특수 검색어를 사용합니다. |
| 하위 태그 | 있음 |
| 콘텐츠 형식 | 비어 있음 |
| 라벨 | |
|---|---|
| 정의 | <label> 태그는 상세검색 라벨을 지정합니다. 제공되는 검색결과를 필터링할 수 있습니다. 사용 방법 상세검색 라벨에 more:[[label tag value]] 문자열을 추가합니다. Google에 보내는 HTTP 요청의 q 매개변수 값을 다음 예에 나와 있습니다. 이 값은 URL 이스케이프 처리되었습니다. This example uses the refinement label golf_courses to 참고: <label> 태그는 <Label> 태그: 상세검색 라벨을 식별합니다. 검색 결과에 표시되는 특정 URL과 연결된 키워드입니다. |
| 예 | <label>golf_courses</label> |
| 하위 태그 | FacetItem |
| 콘텐츠 형식 | 텍스트 |
| LANG | |
|---|---|
| 정의 | <LANG> 태그에는 검색결과의 언어 |
| 예 | <COUNTRY>en</partners> |
| 하위 태그 | 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> 태그 연결된 HTTP 요청에서 제출된 입력 매개변수를 식별합니다. 표시됩니다. 매개변수에 대한 정보는 태그 속성(name, value, original_value)을 구분하고 HTTP 요청에 제출된 각 매개변수에 대해 PARAM 태그 한 개를 사용해야 합니다. |
||||||||||||
| 속성 |
|
||||||||||||
| 예 | <PARAM name="cr" value="countryNZ" 원본_값="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>피자</Q> |
| 하위 태그 | GSP |
| 콘텐츠 형식 | 텍스트 |
| R | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 정의 | <R> 태그는 태그의 세부정보를 캡슐화합니다. 확인할 수 있습니다. 참고: <R> 태그의 정의는 WebSearch는 DTD보다 더 제한적입니다. |
|||||||||
| 속성 |
|
|||||||||
| 하위 태그 | U, UE, T?, CRAWLDATE, S?, LANG?, 있음 | |||||||||
| 하위 태그 | RES | |||||||||
| 저항군 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 정의 | <RES> 태그는 개별 항목 집합을 캡슐화합니다. 검색 결과와 그 결과에 대한 세부정보 |
|||||||||
| 속성 |
|
|||||||||
| 예 | <RES SN="1" KO="10"> | |||||||||
| 하위 태그 | M, FI?, XT?, NB?, R* | |||||||||
| 하위 태그 | GSP | |||||||||
| 콘텐츠 형식 | 비어 있음 | |||||||||
| S | |
|---|---|
| 정의 | <S> 태그에는 검색어에 대한 발췌 부분이 포함됩니다. 검색어가 굵게 강조 표시되어 있습니다. 줄바꿈은 포함해야 합니다. |
| 예 | <S>워싱턴 (CNN) -- 대통령을 두고 상원 교착 상태 <b>Bush's</b> 사법 심사위원단은 5명의 후보가 최종 투표에 이르도록 <b>...<b>...</b><S> |
| 하위 태그 | R |
| 콘텐츠 형식 | 텍스트 (HTML) |
| SL_MAIN | |
|---|---|
| 정의 | 이 태그는 프로모션 결과의 콘텐츠를 캡슐화합니다. 프로모션 파싱에 사용합니다. 앵커 텍스트와 제목 링크의 URL은 각각 T 및 U 하위 태그에 포함됩니다. 본문 텍스트와 링크는 BODY_LINE 하위 태그 안에 있습니다. |
| 하위 태그 | BODY_LINE*, T, U |
| 하위 태그 | SL_RESULTS |
| 콘텐츠 형식 | 비어 있음 |
| SL_RESULTS | |
|---|---|
| 정의 | 승격된 결과의 컨테이너 태그입니다. 검색결과에 프로모션이 표시될 때마다 이 중 하나가 표시됩니다. SL_MAIN 하위 태그에는 기본 결과 데이터가 포함됩니다. |
| 하위 태그 | SL_MAIN* |
| 하위 태그 | R |
| 콘텐츠 형식 | 비어 있음 |
| 맞춤법 | |
|---|---|
| 정의 | <Ctrling> 태그는 맞춤법 검사에 사용될 수 있는 대체 맞춤법을 제출된 검색어에 대한 맞춤법 제안입니다. 이 태그는 검색 결과의 첫 페이지입니다. 맞춤법 제안은 다음에서 사용할 수 있습니다. 영어, 중국어, 일본어, 한국어가 지원됩니다. 참고: Google은 gl 매개변수 값이 있는 쿼리 소문자. |
| 예 | <맞춤법> |
| 하위 태그 | 제안 |
| 하위 태그 | GSP |
| 콘텐츠 형식 | 비어 있음 |
| 추천 | |||||||
|---|---|---|---|---|---|---|---|
| 정의 | <Suggestion> 태그에는 제출된 검색어에 대한 대체 맞춤법 제안입니다. 이 태그의 콘텐츠를 사용하여 검색 사용자에게 다른 철자를 제안합니다. q 속성의 값은 검색어로 사용할 수 있는 URL 이스케이프된 맞춤법 제안입니다. | ||||||
| 속성 |
|
||||||
| 예 | <제안 q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion> | ||||||
| 하위 태그 | 맞춤법 | ||||||
| 콘텐츠 형식 | 텍스트 (HTML) | ||||||
| T | |
|---|---|
| 정의 | <T> 태그에는 제목이 포함됨 표시됩니다. |
| 예 | <T>아미시 동부 해안 피자 전문점</T> |
| 하위 태그 | R |
| 콘텐츠 형식 | 텍스트 (HTML) |
| 제목 | |
|---|---|
| 정의 | <Context>의 하위 요소로서 <Context> 태그에는 프로그래밍 검색 엔진의 이름이 포함됩니다. <Facet>의 하위 요소로서 <title> 태그는 패싯 집합의 제목을 제공합니다. |
| 예 | <Context>의 하위 요소: <title>My Search Engine</title> <Facet>의 하위 요소: <title>facet title</title> |
| 하위 태그 | 컨텍스트, 패싯 |
| 콘텐츠 형식 | 텍스트 |
| TM | |
|---|---|
| 정의 | <TM> 태그는 총 서버 시간을 식별합니다. 초 단위로 측정되는 검색 결과를 반환하는 데 필요합니다. |
| 예 | <TM>0.100445</TM> |
| 하위 태그 | GSP |
| 콘텐츠 형식 | 텍스트 (부동 소수점 수) |
| TT | |
|---|---|
| 정의 | <TT> 태그는 도움말을 참조하세요. |
| 예 | <TT><i>팁: 대부분의 경우 반환 키를 누르면 검색 버튼을 누르면 됩니다.</i></TT> |
| 하위 태그 | GSP |
| U | |
|---|---|
| 정의 | <U> 태그는 표시됩니다. |
| 예 | <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.specific鮨.com으로 표시할 수 있습니다. 이 <UD> 태그는 ud 매개변수가 포함된 요청을 전송합니다. 참고: 이 기능은 베타 기능입니다. |
| 예 | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
| 하위 태그 | R |
| 콘텐츠 형식 | 텍스트 (IDN 인코딩된 URL) |
| UE | |
|---|---|
| 정의 | <UE> 태그는 URL의 표시됩니다. 값은 URL 이스케이프 처리되므로 를 사용합니다. |
| 예 | <UE>http://www.dominos.com/</UE> |
| 하위 태그 | R |
| 콘텐츠 형식 | 텍스트 (URL 이스케이프된 URL) |
| XT | |
|---|---|
| 정의 | <XT> 태그는 M 태그에서 지정된 대로, 예상 총 결과 수가 실제로 총 결과 수입니다. 자세한 내용은 자동 필터링 섹션을 참고하세요. |
| 예 | <XT /> |
| 하위 태그 | RES |
| 콘텐츠 형식 | 비어 있음 |
이미지 검색어의 XML 결과
이 샘플 이미지 요청은 'monkey'라는 검색어에 대한 5개의 결과 (num=5)를 요청합니다. (q=원숭이)입니다.
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 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 정의 | <RG> 태그는 개별 이미지 검색결과의 세부정보를 포함합니다. |
|||||||||
| 속성 |
| |||||||||
| 하위 태그 | RES | |||||||||
| RU | |
|---|---|
| 정의 | <RU tag> 태그는 각 이미지 검색 결과의 세부정보를 포함합니다. |
| 하위 태그 | R |