預覽精靈

透過 Preview 精靈,您可以快速、輕鬆且穩定地將預覽整合至網站。您還可以在書籍檢視器中嵌入書籍檢視器、連結至圖書搜尋,甚至新增預覽「彈出式視窗」視窗到網站上。方法很簡單,只要產生程式碼,然後貼到您的網頁上即可。此外,您也可以使用部分簡單的 JavaScript 函式自訂此程式碼


預覽精靈是以 Dynamic LinksEmbedded Viewer API 為基礎建構而成的簡易型程式庫。如果您是需要自訂整合的進階開發人員,請考慮直接使用基礎 API。

產生預覽程式碼

產生的預覽範例

下列範例是使用 Preview Wizard 產生的。

自訂程式碼

除了使用上述精靈以外,您也可以直接呼叫一些簡單的 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 Preview] 按鈕的語言、內嵌預覽的介面語言等。
    參數:
      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-k、pt、

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)
    參數:
      Object optionsObj - 傳送至 Embedded Viewer API 之 DefaultViewer 建構函式的鍵/值組合。通常用於進階自訂功能。

GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    這項功能適合合作夥伴計畫的出版商使用,可設定在將任何預覽連結插入「Google 圖書搜尋」時,要使用的聯合品牌搜尋網站。在插入按鈕前呼叫此函式,可確保使用者在書籍搜尋預覽上方看到合作夥伴的標誌。
    參數:
      string cobrandName - 要新增至任何「圖書搜尋」網址的聯名名稱。這通常是在現有的「聯合品牌搜尋」預覽網址中,位於 /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 - 預覽網址或書籍 ID,例如 ISBN、OCLC 或 LCCN 編號。請參閱「Dynamic Links 要求格式」。
      Number opt_width - 所需的檢視器寬度 (以像素為單位)。
      Number opt_height - 所需的檢視器高度,以像素為單位。

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    如果有書籍預覽畫面,這個函式會撰寫「Google Preview」按鈕。只要按一下這個按鈕,系統就會在網頁右上方開啟「浮動預覽視窗」。如果沒有可用的預覽,系統就不會繪製該按鈕。

    經驗老到的開發人員可能會對這項功能內部使用的嵌入式檢視器 API 感興趣,

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