미리보기 마법사

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


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

미리보기 코드 생성

생성된 미리보기의 예

다음 예는 미리보기 마법사를 사용하여 생성되었습니다.

코드 맞춤설정

위의 마법사를 사용하는 것 외에도 간단한 자바스크립트 'helper' 함수를 직접 호출할 수 있습니다. 이렇게 하려면 먼저 미리보기 마법사 라이브러리를 로드해야 합니다. 이를 위한 한 가지 방법은 페이지의 <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 BR pt PT PT PT PT

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    매개변수:
      Object optionsObj - Embedded 뷰어 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 - ISBN, OCLC 또는 LCCN 번호와 같은 미리보기 URL 또는 도서 식별자입니다. 동적 링크 요청 형식을 참조하세요.
      Number opt_width - 원하는 뷰어 너비(픽셀)입니다.
      Number opt_height - 원하는 뷰어 높이(픽셀)입니다.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    도서 미리보기를 사용할 수 있는 경우 이 함수는 'Google 미리보기' 버튼을 작성합니다. 이 버튼을 클릭하면 페이지 상단에 '플로팅 미리보기 창'이 열립니다. 미리보기를 사용할 수 없는 경우 버튼이 그려지지 않습니다.

    보다 수준 높은 개발자는 이 함수가 내부적으로 사용하는 Embedded Viewer API에 관심이 있을 수 있습니다.

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