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 mình 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 của mình — tất cả những gì bạn cần làm là 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 chuyên nghiệp và đang tìm cách tích hợp tuỳ chỉnh, hãy cân nhắc trực tiếp sử dụng các API cơ bản.
Tạo mã xem trước
Ví dụ về bản xem trước đã tạo
Các ví dụ sau được tạo bằng Trình hướng dẫn xem trước.
- previewwizard-embed: Nhúng trình xem sách vào trang.
- previewpreview- nổi bật lên: Thêm một nút mà người dùng có thể nhấp để mở bản xem trước nổi trên trang.
- previewwizard-linktogbs: Chèn một nút liên kết đến phần xem trước trên trang web Tìm kiếm sách.
- previewwizard-customurl: Hiển thị một nút dẫn đến một URL cụ thể.
Tuỳ chỉnh mã
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ố chức năng "trợ giúp" đơn giản của JavaScript. Để thực hiện việc này, trước tiên, bạn cần tải thư viện Trình hướng dẫn xem trước. Bạn có thể thực hiện việc này bằng cách thêm thẻ sau vào phần <head> trên trang:
<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ừ bên trong thẻ <script> bên trong <body> của tài liệu. Ví dụ: nếu muốn chèn nút "Xem trước trên Google", bạn cần đặt mã để thực hiện việc này trong phần tử <script> tại vị trí mong muốn của nút trên trang.
GBS_setLanguage
GBS_setLanguage(languageCode)
-
Thay đổi ngôn ngữ của mọi nút hoặc văn bản được thêm sau khi gọi hàm này. Trong đó bao gồm ngôn ngữ của nút "Bản xem trước của Google", ngôn ngữ giao diện của bản xem trước được nhúng, v.v.
-
Tham số:
string languageCode – Mã ngôn ngữ RFC 3066 mong muốn (mặc định là "en" cho tiếng Anh). Mã ngôn ngữ hiện được hỗ trợ bao gồm 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, ro, ru, s. , slv, s
GBS_setViewerOptions
GBS_setViewerOptions(optionObj)
-
Thông số:
Object optionsObj – Một tập hợp các cặp khoá-giá trị được truyền đến hàm khởi tạo DefaultViewer của API Trình xem được nhúng. Thông thường, chế độ này được sử dụng cho các chế độ tuỳ chỉnh nâng cao.
GBS_setCobrandName
GBS_setCobrandName(cobrandName)
-
Dành cho các nhà xuất bản trong Chương trình Đối tác sử dụng, chức năng này sẽ đặt trang web Tìm kiếm cùng nhãn hiệu để sử dụng khi chèn đường liên kết xem trước vào trang Tìm kiếm sách. Việc gọi hàm này trước khi chèn nút sẽ đảm bảo rằng người dùng nhìn thấy biểu trưng của đối tác phía trên bản xem trước của Tìm kiếm sách.
-
Tham số:
string cobrandName – Tên đồng thương hiệu sẽ được thêm vào bất kỳ URL nào trên Tìm kiếm sách. Đây thường là tên đứng sau /p/ trong các URL xem trước hiện có của 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ì các đường liên kết 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 của 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, sẽ không có trình xem nào hiển thị.
-
Tham số:
string identifier – URL xem trước hoặc giá trị nhận dạng sách, chẳng hạn như số ISBN, OCLC hoặc LCCN. Hãy xem bài viết Định dạng yêu cầu đường liên kết động.
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 của sách cho phép, hàm này sẽ ghi một nút "Xem trước trên Google". Nhấp vào nút này sẽ mở 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 không được vẽ.
Các nhà phát triển tinh vi hơn có thể quan tâm đến API Trình xem được nhúng. Đây là API mà chức năng này sử dụng nội bộ.
-
Tham số:
string, Array identifier – URL xem trước hoặc giá trị nhận dạng sách, chẳng hạn như số ISBN, OCLC hoặc LCCN. Hãy xem bài viết Định dạng yêu cầu đường liên kết động. Nếu biết một số giá trị nhận dạng thay thế cho sách, bạn có thể chuyển một dãy các giá trị nhận dạng này và nút sẽ xuất hiện nếu có bản xem trước cho bất kỳ giá trị nào trong số đó.
GBS_insertPreviewButtonLink
GBS_insertPreviewButtonLink(identifiers, opt_options)
-
Nếu bản xem trước của sách cho phép, chức năng này sẽ tạo nút "Xem trước trên Google". Nút này chỉ liên kết đến trang xem trước của cuốn sách. Theo mặc định, đường liên kết này sẽ dẫn đế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 (URL này nên chứa trình xem được nhúng). Bạn có thể thực hiện việc này bằng cách truyền tuỳ chọn
alternativeUrl(không bắt buộc). - liên kết đến phiên bản Đồng thương hiệu của trang xem trước sách, nếu GBS_setCobrandName được gọi trước hàm này.
-
Tham số:
string, Array identifier – URL xem trước hoặc giá trị nhận dạng sách, chẳng hạn như số ISBN, OCLC hoặc LCCN. Hãy xem bài viết Định dạng yêu cầu đường liên kết động. Nếu biết một số giá trị nhận dạng thay thế cho sách, bạn có thể chuyển một dãy các giá trị nhận dạng này và nút sẽ xuất hiện nếu có bản xem trước cho bất kỳ giá trị 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ụ: để nút Xem trước trên Google liên kết đến một trang xem trước tuỳ chỉnh trên trang web của bạn, bạn chỉ cần truyền giá trị sau làm đối số thứ hai cho GBS_insertPreviewButtonLink: { 'alternativeUrl' : 'http://yoursite.com/your-preview-page' }