미리보기 마법사

미리보기 마법사는 미리보기를 사이트에 빠르고 쉽고 안정적으로 통합할 수 있도록 설계되었습니다. 도서 뷰어를 삽입하거나 도서 검색에 링크를 걸 수 있으며 사이트에 미리보기 '팝업' 창을 추가할 수도 있습니다. 코드를 생성하고 페이지에 붙여넣기만 하면 됩니다. 간단한 자바스크립트 함수를 사용하여 이 코드를 맞춤설정할 수도 있습니다.


미리보기 마법사는 동적 링크 및 삽입된 뷰어 API를 기반으로 빌드된 간단한 편의 라이브러리입니다. 맞춤 통합을 원하는 고급 개발자라면 기본 API를 직접 사용해 보세요.

미리보기 코드 생성

생성된 미리보기의 예

다음은 미리보기 마법사를 사용하여 생성된 예시입니다.

코드 맞춤설정

위의 마법사를 사용하는 것 외에도 몇 가지 간단한 JavaScript '도우미' 함수를 직접 호출할 수 있습니다. 이렇게 하려면 먼저 미리보기 마법사 라이브러리를 로드해야 합니다. 이를 위한 한 가지 방법은 다음 태그를 페이지의 <head> 섹션에 추가하는 것입니다.

<script type="text/javascript" src="https://books.google.com/books/previewlib.js"></script>

미리보기 라이브러리를 로드한 후에는 문서의 <body> 내 <script> 태그 내에서 다음 함수를 호출할 수 있습니다. 예를 들어 'Google 미리보기' 버튼을 삽입하려면 페이지 내에서 원하는 버튼 위치에 있는 <script> 요소에 삽입하도록 코드를 삽입합니다.

GBS_setLanguage

GBS_setLanguage(languageCode)
    이 함수가 호출된 후에 추가된 버튼 또는 텍스트의 언어를 변경합니다. 여기에는 'Google 미리보기' 버튼의 언어, 삽입된 미리보기의 인터페이스 언어 등이 포함됩니다.
    매개변수:
      string languageCode - 원하는 RFC 3066 언어 코드 (기본값은 영어의 경우 'en'). 현재 지원되는 언어 코드로는 hy, bg, ca, zh-CN, zh-TW, hr, cs, da, nl, en, fil, fi, fr, de, el, hi, hu, is, id, in, it, ja, ko, lv, lt, no, pl, pt-BR, pt-PT, lt, no, pl, pt-BR, pt-PT, ko

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    매개변수:
      Object optionsObj - Embedded Viewer API의 DefaultViewer 생성자에 전달된 키-값 쌍 집합입니다. 일반적으로 이 속성은 고급 맞춤설정에 사용됩니다.

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    파트너 프로그램의 출판사가 사용하도록 설계된 이 함수는 도서 검색에 미리보기 링크를 삽입할 때 파트너십 검색 사이트를 사용하도록 설정합니다. 버튼을 삽입하기 전에 이 함수를 호출하면 사용자에게 도서검색 미리보기 위에 파트너 로고가 표시됩니다.
    매개변수:
      string cobrandName - 도서 검색 URL에 추가될 공동 브랜드 이름입니다. 이는 일반적으로 기존 파트너 도서검색 미리보기 URL에서 /p/ 다음에 표시됩니다.

      예를 들어 값을 sup로 설정하면 사용자가 기본값이 아닌
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      와 같은 링크로 이동합니다.
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    이 함수가 호출될 때마다 삽입된 도서 미리보기를 삽입합니다. 미리보기를 사용할 수 없는 경우 뷰어가 표시되지 않습니다.
    매개변수:
      string identifier - 미리보기 URL 또는 도서 식별자(예: ISBN, OCLC, LCCN 번호)입니다. 동적 링크 요청 형식을 참고하세요.
      Number opt_width - 뷰어의 원하는 너비(픽셀)입니다.
      Number opt_height - 뷰어의 원하는 높이(픽셀)입니다.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    도서 미리보기가 제공되는 경우 이 함수는 'Google 미리보기' 버튼을 작성합니다. 이 버튼을 클릭하면 페이지 바로 위에 '플로팅 미리보기 창'이 열립니다. 미리보기가 없으면 버튼이 그려지지 않습니다.

    보다 정교한 개발자라면 이 함수가 내부적으로 사용하는 Embedded Viewer API에 관심이 있을 수 있습니다.

    매개변수:
      string, Array identifier - 미리보기 URL 또는 도서 식별자(예: ISBN, OCLC, LCCN 번호)입니다. 동적 링크 요청 형식을 참고하세요. 책의 대체 식별자를 여러 개 알고 있는 경우 이러한 식별자의 배열을 전달할 수 있습니다. 그러면 미리보기가 제공되는 경우 버튼이 표시됩니다. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    도서 미리보기가 제공되는 경우 이 함수는 책의 미리보기 페이지로 연결되는 'Google 미리보기' 버튼을 작성합니다. 기본적으로 이 링크는 Google 도서의 미리보기로 연결되지만 다음 작업도 할 수 있습니다.
    • 포함된 뷰어를 포함해야 합니다. 선택사항인 alternativeUrl 옵션을 전달하면 됩니다.
    • 이 함수 전에 GBS_setCobrandName을 호출하면 도서 미리보기 페이지의 파트너 도서검색 버전으로 연결되는 링크를 제공할 수 있습니다.
    사용자에게 미리보기가 제공되지 않으면 페이지에 버튼이 표시되지 않습니다.
    매개변수:
      string, Array identifier - 미리보기 URL 또는 도서 식별자(예: ISBN, OCLC, LCCN 번호)입니다. 동적 링크 요청 형식을 참고하세요. 책의 대체 식별자를 여러 개 알고 있는 경우 이러한 식별자의 배열을 전달할 수 있습니다. 그러면 미리보기가 제공되는 경우 버튼이 표시됩니다.
      Object opt_options - 선택사항 - 버튼의 동작을 구성하는 데 사용되는 이름-값 맵입니다. 현재 한 가지 옵션(alternativeUrl)이 지원됩니다. 예를 들어 Google 미리보기 버튼을 사이트의 맞춤 미리보기 페이지로 연결하려면 다음을 두 번째 인수로 GBS_insertPreviewButtonLink에 전달하기만 하면 됩니다.
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }