자료

링크된 맞춤검색 엔진

링크된 CSE에서 검색 엔진의 사양은 사용자의 웹사이트에서 호스팅됩니다. Google 저장 CSE의 경우 사양은 Google에 저장됩니다.

기존의 Google 저장 CSE를 사용할 경우에는 로그인하여 마법사를 사용하거나 XML 파일을 작성한 후 고급 탭을 통해 Google에 업로드하여 CSE를 만듭니다. 사용하는 검색창 코드는 'cx' 매개변수를 사용하여 Google에 저장된 이 사양을 참조합니다. CSE와 관련된 부분을 변경하려면 제어판을 사용하거나 새 XML 사양을 업로드해야 합니다. 이 경우 몇 가지 제한이 있습니다.

CSE 생성 및 유지관리 작업은 수동으로 이루어집니다.
CSE를 사용자별로 하나씩 만들거나 각 페이지마다 약간씩 다르게 만드는 등 많은 CSE를 만드는 일은 쉽지 않습니다.
iCal, RSS, Google Base 등 다른 데이터 소스를 사용하여 프로그래밍 방식으로 CSE를 만드는 것은 어렵습니다.

외부 호스팅 CSE는 Google 저장 CSE의 이러한 제한사항을 극복합니다. 외부 호스팅 CSE를 사용할 경우 사용자의 웹사이트에서 CSE 사양을 호스팅한 후 CSE 검색 요청에 이 사양의 URL을 포함합니다. Google은 사용자가 CSE에서 검색할 때 웹사이트에서 CSE 사양을 검색합니다. 이 경우 몇 가지 매우 중요한 이점이 있습니다.

데이터를 맞춤검색 엔진으로 쉽게 변환할 수 있습니다.
임의의 수의 CSE를 자동으로 생성할 수 있고 각각을 특정 사용자, 특정 페이지, 시간 등에 맞게 조정할 수 있습니다. 실제로 사용자의 검색어 또는 사용자가 검색하는 사이트의 페이지에 맞게 주문형 CSE를 만들 수 있습니다. Google은 페이지의 링크로부터 링크된 CSE를 만드는 기능 등 몇 가지 유용한 도구를 사용자들에게 제공합니다.
Google에 데이터를 전송하지 않고 손쉽게 링크된 CSE 정의를 업데이트할 수 있습니다.
사용자별 사이트설정과 관련하여 공통으로 적용되는 제한사항은 없습니다.

이제 아이디어를 최대한 활용하여 CSE를 동적으로 생성할 수 있습니다. Google 및 타사가 제공하는 도구를 사용하면 손쉽게 CSE를 자신의 웹사이트 및 타인의 웹사이트와 동기화할 수 있습니다. CSE를 만드는 데 사용할 수 있는 유용한 데이터 소스로는 iCal 피드, 참조자 로그 및 사용자의 즐겨찾기 또는 탐색 기록이 있습니다. 웹사이트의 상태나 트래픽에 따라 CSE의 디자인을 변경할 수도 있습니다. 창의성을 발휘해 보세요. 가능성은 무한합니다.

CSE 사양은 하나 이상의 외부 사이트설정 파일을 참조할 수 있습니다. 따라서 CSE 간에 쉽게 사이트설정을 공유할 수 있습니다.

그러나 협업 및 Google 마커와 같이 Google 저장 CSE의 일부 기능은 외부 호스팅 CSE와 함께 작동하지 않습니다. 이미 Google에 사이트설정을 저장한 경우 사이트설정을 다운로드하여 외부 호스팅 CSE에 포함할 수 있습니다. 자세한 내용은 Google 저장 CSE에서 외부 호스팅 CSE로 전환을 참조하세요. 또한 외부 호스팅 CSE는 항상 무료로 광고가 지원되는 CSE이며, 외부 호스팅 CSE 메커니즘을 사용하여 Google Site Search의 CSE 사양을 호스팅할 수 없습니다.

링크된 CSE 예

다음은 사양이 http://www.guha.com/cref_cse.xml에 있는 외부 호스팅 CSE 사용에 대한 매우 간단한 예제입니다. CSE 사양에는 검색할 사이트와 검색결과를 표시할 모습 등이 포함되어 있습니다. 다음은 CSE 사양을 사용하는 검색창에 대한 코드입니다. 'cref'라는 매개변수에 유의하세요.

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref" action="http://www.google.com/cse">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="http://www.google.co.kr/cse/brand?form=cref"></script>
<!-- Google CSE Search Box Ends -->

중요한 양식 매개변수:

cref: CSE 사양의 URL
q: 검색창

지금 검색 엔진을 사용해 보세요.

본 검색창은 CSE 사양 파일과 동일한 사이트에 있을 수 있으며 해당 사이트의 여러 페이지뿐 아니라 다른 사이트에도 있을 수 있습니다.

사용자가 검색어를 처음으로 발행하면 Google은 CSE 사양을 가져와서 검색어를 처리하는 데 사용합니다. 또한 CSE 사양을 저장한 후 주기적으로 새로 고치므로, 사용자가 검색어를 발행할 때마다 Google의 CSE 사양 요청을 제공하는 것에 대해 걱정할 필요가 없습니다. 외부 호스팅 CSE의 사양을 변경한 후 바로 새로 고치려면 외부 호스팅 CSE 새로고침 페이지로 이동하여 CSE 사양의 URL을 입력하세요.

사용자의 사이트에 결과를 호스팅하는 링크된 CSE의 예

표준 맞춤검색 엔진에서처럼 링크된 CSE를 사용하여 사이트에 결과를 호스팅할 수도 있습니다. 이때 2가지 코드 스니펫이 필요한데 하나는 검색창 코드이고 다른 하나는 검색결과 코드입니다. 검색창 코드는 위의 예와 유사하지만 몇 가지 다른 점이 있습니다.

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref_iframe" action="http://www.guha.com/results.html">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="hidden" name="cof" value="FORID:9" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="http://www.google.co.kr/cse/brand?form=cref_iframe"></script>
<!-- Google CSE Search Box Ends -->

중요한 양식 매개변수:

action 입력란: 결과를 호스팅할 URL(본 예에서는 http://www.guha.com/results.html 사용)
cref: CSE 사양의 URL
cof: FORID:9, FORID:10 또는 FORID:11. 이는 표시할 광고 형식을 지정합니다. 자세한 내용은 CSE 사양을 참조하세요.
q: 검색창

위의 action 입력란이 가리키는 URL에서 검색결과를 표시하고 싶은 곳에 해당 코드를 삽입해야 합니다.

<div id="cse-search-results"></div>
<script type="text/javascript">
  var googleSearchIframeName = "cse-search-results";
  var googleSearchFormName = "cse-search-box";
  var googleSearchFrameWidth = 600;
  var googleSearchDomain = "www.google.com";
  var googleSearchPath = "/cse";
</script>
<script type="text/javascript" src="http://www.google.com/afsonline/show_afs_search.js"></script>

링크된 CSE의 사이트설정

링크된 CSE는 위의 예에서처럼 사이트설정을 지정해야 원활하게 작동합니다. 다음 2가지 방법으로 사이트설정을 지정할 수 있습니다.

외부 사이트설정: <Include> 태그를 사용하여 사이트설정 파일의 위치를 지정합니다. 외부 사이트설정 파일에 대해 자세히 알아보기. 이전 섹션에서 본 예제에서는 두 가지 외부 사이트설정 파일을 사용합니다. 그 중 하나는 서버에 저장된 파일이고 다른 하나는 스크립트의 출력 파일입니다.

인라인 사이트설정: CSE 사양과 함께 사이트설정을 동일한 파일에 배치합니다. 인라인 사이트설정에 대해 자세히 알아보기. 위 예제에는 http://www.solarenergy.org/* 및 http://www.solarfacts.net/* 등의 두 가지 인라인 사이트설정이 있습니다.

각 파일의 크기는 3MB 미만이어야 합니다. 3MB를 초과하는 사이트설정이 있는 경우 여러 파일로 분할한 후 <Include> 태그를 사용하여 해당 파일들을 지정할 수 있습니다. 파일은 최대 50개까지 사용할 수 있지만 포함한 모든 파일의 총 크기는 10MB 미만이어야 합니다. 따라서 CSE당 약 25KB의 사이트설정을 포함할 수 있습니다. 이보다 많은 용량이 필요한 경우 메타 방식을 권장합니다. 즉, CSE를 여러 개 만든 후 결과를 가져와 통합한 후 사용자에게 제공하는 것이 좋습니다. 본 프로그래밍 방식 인터페이스를 이용하면 거의 모든 용량 문제를 해결할 수 있습니다.