預覽精靈

預覽精靈功能，可讓您輕鬆快速地將預覽與你的網站整合。您可以將嵌入書籍檢視器、連結「Google 書籍搜尋」的連結，甚至在網站中加入預覽「彈出式視窗」視窗。只要產生程式碼，再貼到網頁中即可。您也可以使用一些簡單的 JavaScript 函式自訂這段程式碼。


「預覽精靈」是簡易的便利程式庫，以動態連結和嵌入式檢視器 API 為基礎為基礎。如果您是想要自訂整合的進階開發人員，建議您直接使用基礎 API。

產生預覽程式碼

產生的預覽範例

以下為使用預覽精靈產生的範例。

自訂程式碼

除了使用上述精靈，您也可以直接呼叫一些簡單的 JavaScript「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、PT、pt、PT、PT、PT、PT、PT、PT、PT、PT、PT、PT、PT

GBS_setViewer 選項

GBS_setViewerOptions(optionObj)
    參數：
      Object optionsObj - 一組鍵/值組合，傳遞至 Embedded Viewer API 的 DefaultViewer 建構函式。通常用於進階自訂。

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    僅供合作夥伴計畫的發布者使用；這個函式會設定在「書籍搜尋」中插入任何預覽連結時要使用的聯名搜尋網站。在插入按鈕之前呼叫此函式，可確保使用者會在「書籍搜尋」預覽上方看到合作夥伴的標誌。
    參數：
      string cobrandName - 要新增至任何書籍搜尋網址中的聯名名稱。這通常是在現有的聯名搜尋預覽網址中
    之後。

    例如，如果將值設為 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 - 試閱網址或書籍 ID，例如 ISBN、OCLC 或 LCCN 號碼。請參閱動態連結要求格式。
      Number opt_width - 所需的觀眾寬度 (以像素為單位)。
      Number opt_height - 所需的觀眾高度 (以像素為單位)。

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    如果書籍提供試閱，這個函式會寫出「Google 預覽」按鈕。按一下這個按鈕即可開啟頁面頂端的「浮動預覽視窗」。如果沒有預覽，系統就不會顯示該按鈕。

    更複雜的開發人員可能會希望在內部使用這個函式的 Embedded Viewer API。

    參數：
      string, Array identifier - 試閱網址或書籍 ID，例如 ISBN、OCLC 或 LCCN 號碼。請參閱動態連結要求格式。如果您知道這本書的多個替代 ID，可以傳遞這些 ID 的陣列，只要任一 ID 有提供試閱，系統就會顯示這個按鈕。 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    如果書籍提供試閱，這個函式會輸出「Google 預覽」按鈕，該按鈕會直接連結至書籍的試閱頁面。根據預設，這個連結會連結至 Google 圖書的試閱內容，但你也可以：
    • 連結 (應包含內嵌式檢視器)，連結到您網站上的網址。方法很簡單，只要傳遞選用的 alternativeUrl 選項即可。
    • 如果連結至 GBS_setCobrandName，請在這個函式開始前呼叫書籍試閱頁面的共同品牌版本。
    如果使用者無法預覽，系統就不會在網頁上顯示任何按鈕。
    參數：
      string, Array identifier - 試閱網址或書籍 ID，例如 ISBN、OCLC 或 LCCN 號碼。請參閱動態連結要求格式。如果您知道這本書的多個替代 ID，可以傳遞這些 ID 的陣列，只要任一 ID 有提供試閱，系統就會顯示這個按鈕。
      Object opt_options - 選用 - 用於設定按鈕行為的名稱/值對應。目前支援下列其中一種選項：alternativeUrl。舉例來說，如要將 Google 預覽按鈕連結至網站上的自訂預覽頁面，只要將下列引數當做第二個引數傳遞至 GBS_insertPreviewButtonLink：
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }