Trang này được dịch bởi Cloud Translation API.

Dynamic Links

Tính năng Liên kết động của Google Sách cho phép bạn tạo các liên kết có thể tuỳ chỉnh, đáng tin cậy hơn tới Google Sách từ trang web của mình. Ví dụ: công cụ này cho phép bạn tạo đường liên kết "thông minh" chỉ xuất hiện khi sách nằm trong chỉ mục của chúng tôi hoặc hiển thị các đường liên kết cho người dùng biết có thể xem trước sách trên Google Sách hay không. Tính năng Liên kết động cũng cho phép bạn đưa hình thu nhỏ vào liên kết của bạn tới Google Sách. Tài liệu này nhằm cho phép bạn nhanh chóng thêm chức năng này vào trang web của mình.

Lưu ý: Tính năng này trước đây được gọi là API Khả năng xem sách.

Trình hướng dẫn xem trước là một công cụ được tạo phía trên Liên kết động giúp bạn dễ dàng liên kết đến các bản xem trước sách từ trang web chỉ bằng cách sao chép vài dòng mã. Tài liệu này dành cho các nhà phát triển thành thạo hơn muốn tuỳ chỉnh cách họ liên kết với Tìm kiếm Sách.

Nội dung

Đối tượng người xem
Các thuật ngữ khi tìm kiếm sách
Giới thiệu
Nguyên tắc sử dụng thương hiệu
API phía máy khách
1. Định dạng URL yêu cầu
2. Định dạng kết quả JSON
Chế độ đồng bộ và không đồng bộ
Câu hỏi thường gặp
Mã mẫu

Thẻ Đối tượng người xem

Tài liệu về liên kết động dành cho các lập trình viên muốn viết các ứng dụng web liên kết tới sách trong Google Sách. Tài liệu này giả định rằng bạn đã quen thuộc với giao thức HTTP và JavaScript cơ bản.

Thuật ngữ khi tìm kiếm sách

Google Sách tôn trọng các hạn chế về bản quyền tại địa phương của người dùng. Do đó, bản xem trước hoặc chế độ xem toàn bộ của một số cuốn sách sẽ không được cung cấp ở một số địa điểm. Khả năng xem được nhóm thành các lớp sau:

Chế độ xem toàn bộ: Người dùng có thể xem toàn bộ nội dung cuốn sách. Những cuốn sách này có thể nằm trong phạm vi công cộng.
Bản xem trước có giới hạn: Có thể xem được một phần của cuốn sách. Cuốn sách này có bản quyền và Google Sách đã được phép cho phép người dùng truy cập vào các trang này. Những cuốn sách này khác với những cuốn sách Xem đoạn trích ở chỗ người dùng có thể xem toàn bộ các trang.
Chế độ xem đoạn trích và không có bản xem trước: Người dùng sẽ chỉ thấy trang "Giới thiệu về sách". Tối đa, sách chỉ có các đoạn trích ngắn. Cuốn sách này chưa được quét hoặc vẫn có bản quyền và Google Sách chưa được phép hiển thị nhiều hơn một số "đoạn trích" liên quan đến cụm từ tìm kiếm của người dùng.

Giới thiệu

Tài liệu về Đường liên kết tĩnh mô tả một cách rất đơn giản để tạo URL đến một trang của một cuốn sách cụ thể trên Google Sách. Rất tiếc, đôi khi một cuốn sách cụ thể không có trong chỉ mục của Google Sách hoặc không có bản xem trước cho người dùng ở một vị trí địa lý cụ thể. Do Đường liên kết tĩnh "bị che khuất", nên đôi khi chúng không có tác dụng như dự kiến.

Đường liên kết động cung cấp một phương thức thay thế, có lập trình phía máy khách để truy vấn khả năng xem của một cuốn sách bằng JavaScript. Điều này cho phép bạn đưa các liên kết đáng tin cậy và dễ dự đoán hơn vào Tìm kiếm Sách, mang lại trải nghiệm nhất quán hơn cho người dùng của bạn. Vì khả năng xem thay đổi tuỳ theo vị trí của người dùng cuối, nên giao diện đường liên kết động không được thiết kế cho các truy vấn phía máy chủ hoặc truy vấn ngoại tuyến.

Để hiểu rõ vai trò của Đường liên kết động, hãy chuyển đến phần mã mẫu ở cuối tài liệu này.

Nguyên tắc sử dụng thương hiệu

Khi hiển thị Đường liên kết động, bạn phải tuân thủ các nguyên tắc ghi nhãn chi phối Nhóm Google Sách API. Cụ thể,

Bạn phải duy trì thông tin ghi nhận sự đóng góp và đường liên kết đến Google Sách.
Bạn chỉ được sử dụng nút Xem trước trên Google đã được phê duyệt khi liên kết đến bản xem trước trên Google Sách.
Mọi đường liên kết văn bản, nút, tài liệu hoặc văn bản mô tả đều phải tuân theo quy ước đặt tên đã được phê duyệt. Ví dụ: bạn không nên sử dụng những động từ "tải xuống" hoặc "đọc" khi liên kết đến bản xem trước trên Google Sách, vì bạn chỉ có thể tải toàn bộ các tác phẩm thuộc phạm vi công cộng xuống.

Ví dụ về xây dựng thương hiệu

Freakonomics: An Rogue Economist Khám phá mặt tiềm ẩn của mọi thứ

Tác giả: Steven Levitt và Stephen Dubner

Phần mẫu ở cuối tài liệu này cung cấp thêm các ví dụ tuân thủ các nguyên tắc sử dụng thương hiệu hiện tại.

API phía máy khách

Cốt lõi của đường liên kết động phía máy khách là một định dạng URL cho phép nhà phát triển tạo các URL yêu cầu thông tin về một hoặc nhiều cuốn sách và gửi yêu cầu đến Google Sách bằng thẻ <script>.

Ví dụ về cú pháp:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

Định dạng yêu cầu

Định dạng của URL này tương tự như cú pháp URL dùng để liên kết với sách, nhưng trường mã sách có thể chứa nhiều mã sách được phân tách bằng dấu phẩy và có thêm các thông số "jscmd" và "callback". Bạn có thể sử dụng các đối số bổ sung để kiểm soát bộ lọc khả năng xem (không bắt buộc).

Đường liên kết động hỗ trợ một số phương pháp nhận dạng sách: số ISBN, số OCLC và khoá LCCN. API cho phép truy vấn theo lô có kích thước lên đến kích thước tối đa của yêu cầu GET.

ISBN: &bibkeys=ISBN:0451526538 (API hỗ trợ cả ISBN 10 và 13.)
OCLC (Trung tâm Kiểm soát và Điều dưỡng): &bibkeys=OCLC:36792831
LCCN (Mã số sản phẩm thương mại toàn cầu): &bibkeys=LCCN:96072233

Định dạng kết quả JSON

Phản hồi từ lệnh gọi này sẽ là thông tin về các sách được yêu cầu được trả về dưới dạng một hoặc nhiều đối tượng JSON. Các đối tượng JSON sử dụng cấu trúc sau:

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

Các trường này cung cấp thông tin sau:

bib_key: Giá trị nhận dạng dùng để truy vấn cuốn sách này.
info_url: URL tới một trang trong Google Sách có thông tin về sách (trang giới thiệu về sách này).
preview_url: URL đến bản xem trước của cuốn sách, đưa người dùng đến thẳng trang bìa của cuốn sách. Nếu yêu cầu chỉ có bản xem trước của sách hoặc "Xem đoạn trích" thì sẽ không có URL xem trước nào được trả về.
thumbnail_url: URL đến hình thu nhỏ bìa sách.
bản xem trước: Một giá trị cho biết trạng thái xem của sách: full (đối với sách ở chế độ Xem toàn bộ), partial (đối với sách Xem trước có giới hạn) hoặc noview (đối với sách Trích đoạn hoặc Không có bản xem trước).
có thể nhúng: Giá trị boolean này là true nếu sách có thể được nhúng vào các trang của bên thứ ba bằng trình xem được nhúng trên tính năng Tìm kiếm sách.

Dynamic Links

Nội dung

Thẻ Đối tượng người xem

Thuật ngữ khi tìm kiếm sách

Giới thiệu

Nguyên tắc sử dụng thương hiệu

Ví dụ về xây dựng thương hiệu

API phía máy khách

Định dạng yêu cầu

Định dạng kết quả JSON

Các thông số và trường bổ sung

Chế độ đồng bộ và không đồng bộ

Chế độ không đồng bộ

Chế độ đồng bộ

Câu hỏi thường gặp

Mã mẫu