Trình hướng dẫn xem trước

Trình hướng dẫn xem trước được thiết kế để cho phép bạn tích hợp bản xem trước với trang web của bạn một cách nhanh chóng, dễ dàng và đáng tin cậy. Bạn có thể nhúng trình xem sách, liên kết đến Tìm kiếm sách hoặc thậm chí thêm cửa sổ "cửa sổ bật lên" xem trước vào trang web. Bạn chỉ cần tạo mã và dán mã đó vào trang của mình. Bạn cũng có thể tuỳ chỉnh mã này bằng cách sử dụng một số hàm JavaScript đơn giản.


Trình hướng dẫn xem trước là một thư viện tiện lợi đơn giản mà chúng tôi xây dựng dựa trên các API Đường liên kết động và Trình xem được nhúng. Nếu bạn là một nhà phát triển nâng cao đang tìm cách tích hợp tuỳ chỉnh, hãy cân nhắc việc sử dụng trực tiếp các API cơ bản.

Tạo mã xem trước

Ví dụ về bản xem trước được tạo

Những ví dụ sau được tạo bằng Trình hướng dẫn xem trước.

Tuỳ chỉnh mã của bạn

Ngoài việc sử dụng trình hướng dẫn ở trên, bạn có thể gọi trực tiếp một số hàm "trình trợ giúp" JavaScript. Để thực hiện việc này, trước tiên, bạn nên tải thư viện Trình hướng dẫn xem trước. Một cách để thực hiện việc này là thêm thẻ sau vào phần <head> trên trang của bạn:

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

Sau khi tải thư viện xem trước, bạn có thể gọi bất kỳ hàm nào sau đây từ trong thẻ <script> bên trong <body> của tài liệu. Ví dụ: nếu bạn muốn chèn nút "Xem trước của Google", bạn nên đặt mã vào phần tử <script> ở vị trí mong muốn của nút trong trang.

GBS_setLanguage

GBS_setLanguage(languageCode)
    Thay đổi ngôn ngữ của bất kỳ nút hoặc văn bản nào được thêm sau khi gọi hàm này. bao gồm ngôn ngữ của nút "Xem trước trên Google", ngôn ngữ giao diện của bản xem trước được nhúng, v.v.
    Thông số:
      string languageCode – Mã ngôn ngữ RFC 3066 bạn muốn dùng (mặc định là "en" cho tiếng Anh). Các mã ngôn ngữ hiện được hỗ trợ bao gồm hi, 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, ro, ru, s, s, s, r, s

GBS_setViewerOptions

GBS_setViewerOptions(optionObj)

Tên miền GBS_setCobrandName

GBS_setCobrandName(cobrandName)
    Dành cho nhà xuất bản để tham gia Chương trình Đối tác, hàm này đặt trang web Tìm kiếm cùng thương hiệu được sử dụng khi chèn bất kỳ đường liên kết xem trước nào vào Tìm kiếm sách. Việc gọi hàm này trước khi chèn một nút sẽ đảm bảo rằng người dùng thấy biểu tượng của đối tác phía trên bản xem trước nội dung Tìm kiếm sách.
    Thông số:
      string cobrandName – Tên thương hiệu sẽ được thêm vào bất kỳ URL nào của Tìm kiếm sách. Đây thường là tên xuất hiện sau /p/ trong các URL xem trước hiện có trên Tìm kiếm cùng thương hiệu.

      Ví dụ: việc đặt giá trị thành sup sẽ đưa người dùng đến các đường liên kết như
      https://books.google.com/books/p/sup?id=Q8ysL64pM54C&printsec=frontcover
      thay vì mặc định
      https://books.google.com/books?id=Q8ysL64pM54C&printsec=frontcover

GBS_insertEmbeddedViewer

GBS_insertEmbeddedViewer(identifier, opt_width, opt_height)
    Chèn bản xem trước sách được nhúng ở bất cứ nơi nào hàm này được gọi. Nếu không có bản xem trước thì sẽ không có người xem nào xuất hiện.
    Thông số:
      Number opt_width – Chiều rộng mong muốn của người xem, tính bằng pixel.
      Number opt_height – Chiều cao mong muốn của người xem, tính bằng pixel.

GBS_insertPreviewButtonPopup

GBS_insertPreviewButtonPopup(identifiers)
    Nếu bản xem trước sách có sẵn, hàm này sẽ ghi ra nút "Xem trước Google". Nhấp vào nút này sẽ mở ra một "cửa sổ xem trước nổi" ngay đầu trang của bạn. Nếu không có bản xem trước, nút này sẽ không được vẽ.

    Các nhà phát triển phức tạp hơn có thể quan tâm đến API Trình xem được nhúng vì API này sử dụng nội bộ.

    Thông số:
      string, Array identifier – URL xem trước hoặc giá trị nhận dạng sách, chẳng hạn như ISBN, OCLC hoặc số LCCN. Xem định dạng yêu cầu Liên kết động. Nếu bạn biết một số giá trị nhận dạng thay thế cho sách, bạn có thể chuyển một loạt giá trị nhận dạng này và nút này sẽ xuất hiện nếu có bản xem trước cho bất kỳ giá trị nhận dạng nào trong số đó. 
GBS_insertPreviewButtonLink(identifiers, opt_options)
    Nếu bản xem trước sách có sẵn, hàm này sẽ ghi ra nút "Xem trước trên Google" chỉ liên kết đến trang xem trước của cuốn sách. Theo mặc định, thẻ này liên kết đến bản xem trước trên Google Sách, nhưng bạn cũng có thể:
    • liên kết đến một URL trên trang web của bạn (bằng cách này sẽ chứa một trình xem được nhúng). Bạn có thể thực hiện việc này bằng cách chuyển một tuỳ chọn alternativeUrl không bắt buộc.
    • liên kết đến phiên bản Co-Brand của trang xem trước sách, nếu GBS_setCobrandName được gọi trước hàm này.
    Nếu người dùng không xem trước được thì sẽ không có nút nào được vẽ lên trang.
    Thông số:
      string, Array identifier – URL xem trước hoặc giá trị nhận dạng sách, chẳng hạn như ISBN, OCLC hoặc số LCCN. Xem định dạng yêu cầu Liên kết động. Nếu bạn biết một số giá trị nhận dạng thay thế cho sách, bạn có thể chuyển một loạt giá trị nhận dạng này và nút này sẽ xuất hiện nếu có bản xem trước cho bất kỳ giá trị nhận dạng nào trong số đó.
      Object opt_options – không bắt buộc – Bản đồ tên-giá trị dùng để định cấu hình hoạt động của nút. Hiện tại, chúng tôi hỗ trợ một lựa chọn: alternativeUrl. Ví dụ: để liên kết nút Google Preview (Xem trước của Google) với một trang xem trước tuỳ chỉnh trên trang web của bạn, bạn chỉ cần chuyển đối số sau làm đối số thứ hai cho GBS_insertPreviewButtonLink:
           { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }