Halaman ini diterjemahkan oleh Cloud Translation API.

Dynamic Links

Fitur Dynamic Links Google Buku memungkinkan Anda membuat link yang lebih dapat disesuaikan dan andal ke Google Buku dari situs Anda. Misalnya, alat ini memungkinkan Anda membuat "smart" link yang hanya muncul saat buku ada di indeks kami, atau menampilkan link yang menunjukkan kepada pengguna apakah buku dapat dipratinjau di Google Buku atau tidak. Fitur Dynamic Links juga memungkinkan Anda menyertakan gambar thumbnail pada link ke Google Buku. Dokumen ini dimaksudkan untuk memungkinkan Anda menambahkan fungsi ini ke situs Anda dengan cepat.

Catatan: Fitur ini sebelumnya dikenal sebagai Book Visibility API.

Wizard Pratinjau adalah alat yang dibuat di atas Dynamic Links yang mempermudah penautan pratinjau buku dari situs cukup dengan menyalin beberapa baris kode. Dokumen ini ditujukan bagi pengembang tingkat lanjut yang ingin menyesuaikan cara menautkan ke Penelusuran Buku.

Daftar Isi

Penonton
Terminologi Penelusuran Buku
Pengantar
Pedoman branding
Client-side API
1. Format URL permintaan
2. Format hasil JSON
Mode sinkron dan asinkron
Pertanyaan umum (FAQ)
Contoh kode

Penonton

Dokumentasi link dinamis ditujukan untuk programmer yang ingin menulis aplikasi web yang terhubung ke buku dalam Google Buku. Dokumentasi ini mengasumsikan bahwa Anda sudah memahami protokol HTTP dan JavaScript dasar.

Terminologi Penelusuran Buku

Google Buku menghormati pembatasan hak cipta lokal milik pengguna, dan akibatnya, pratinjau atau tampilan penuh beberapa buku tidak tersedia di semua lokasi. Visibilitas dikelompokkan ke dalam class berikut:

Layar Penuh: Seluruh buku dapat dilihat. Buku ini mungkin berada dalam domain publik.
Pratinjau Terbatas: Sebagian buku dapat dilihat. Buku ini dilindungi hak cipta dan Google Buku telah menerima izin untuk membuat halaman tersebut dapat diakses oleh pengguna. Buku ini berbeda dengan buku Tampilan Cuplikan karena pengguna dapat melihat seluruh halaman.
Tampilan Penggalan dan Tanpa Pratinjau: Pengguna hanya melihat halaman "Tentang buku". Hanya tersedia kutipan singkat dari buku tersebut. Buku ini belum dipindai, atau berada di bawah hak cipta dan Google Buku belum menerima izin untuk mengekspos lebih dari beberapa "cuplikan" yang terkait dengan istilah penelusuran pengguna.

Pengantar

Dokumentasi Link Statis menjelaskan cara yang sangat sederhana untuk membuat URL pada halaman buku tertentu di Google Buku. Sayangnya, terkadang buku tertentu tidak ada dalam indeks Google Buku, atau pratinjau tidak tersedia bagi pengguna di lokasi geografis tertentu. Karena Static Links adalah "blind," terkadang link gagal memiliki efek yang diinginkan.

Dynamic Links menyediakan metode sisi klien terprogram yang alternatif untuk membuat kueri visibilitas buku menggunakan JavaScript. Tindakan ini memungkinkan Anda menyertakan link yang lebih andal dan dapat diprediksi ke Penelusuran Buku, yang menghasilkan pengalaman yang lebih konsisten bagi pengguna Anda. Karena visibilitas bervariasi sesuai dengan lokasi pengguna akhir, antarmuka link dinamis tidak dirancang untuk kueri sisi server atau offline.

Untuk memahami apa saja yang dapat dilakukan Dynamic Links, langsung ke contoh kode di akhir dokumen ini.

Panduan branding

Saat merender Dynamic Link, Anda harus mematuhi pedoman branding yang mengatur Google Books API Family. Khususnya,

Anda harus mempertahankan atribusi dan link ke Google Buku.
Anda hanya boleh menggunakan tombol Pratinjau Google yang disetujui saat menautkan ke pratinjau di Google Buku.
Setiap link teks, tombol, dokumentasi, atau teks deskriptif harus mematuhi konvensi penamaan yang disetujui. Misalnya, Anda tidak boleh menggunakan kata kerja "download" atau "baca" saat menautkan ke pratinjau Google Buku, karena hanya karya domain publik yang dapat didownload secara keseluruhan.

Contoh branding

Freakonomics: An Rogue Economist Menjelajahi Sisi Tersembunyi dari Semuanya

Oleh Steven Levitt dan Stephen Dubner

Bagian contoh di akhir dokumen ini memberikan contoh tambahan yang sesuai dengan pedoman branding saat ini.

API sisi klien

Inti dari link dinamis sisi klien adalah format URL yang memungkinkan developer membuat URL yang meminta informasi tentang satu atau beberapa buku dan mengirim permintaan ke Google Buku menggunakan tag <script>.

Contoh Sintaksis:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

Format permintaan

Format URL-nya mirip dengan sintaksis URL yang digunakan untuk menautkan ke buku, tetapi kolom ID buku dapat berisi beberapa ID buku yang dipisahkan koma. Ada juga parameter 'jscmd' serta 'callback'. Secara opsional, argumen tambahan dapat muncul untuk mengontrol filter visibilitas.

Dynamic Links mendukung beberapa metode yang berbeda untuk mengidentifikasi buku: ISBN, nomor OCLC, dan kunci LCCN. API ini memungkinkan kueri yang dikelompokkan dengan ukuran hingga maksimal ukuran permintaan GET maksimal.

ISBN: &bibkeys=ISBN:0451526538 (API mendukung ISBN 10 dan 13.)
OCLC: &bibkeys=OCLC:36792831
LCCN: &bibkeys=LCCN:96072233

Format hasil JSON

Respons dari panggilan ini akan menjadi informasi tentang buku yang diminta yang ditampilkan sebagai satu atau beberapa objek JSON. Objek JSON menggunakan struktur berikut:

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

Kolom ini memberikan informasi berikut:

kunci_sepeda: ID yang digunakan untuk mengirimkan kueri ke buku ini.
info_url: URL ke halaman dalam Google Buku yang berisi informasi tentang buku (halaman tentang buku ini).
url_pratinjau: URL ke pratinjau buku, yang akan mengarahkan pengguna langsung ke sampul buku. Jika hanya buku Tampilan Cuplikan atau Tidak Ada Pratinjau yang tersedia untuk permintaan, tidak ada URL pratinjau yang akan ditampilkan.
thumbnail_url: URL yang mengarah ke thumbnail sampul buku.
pratinjau: Nilai yang menunjukkan status visibilitas buku: full (untuk buku Tampilan Penuh), partial (untuk buku Pratinjau Terbatas), atau noview (untuk buku Cuplikan atau Tanpa Pratinjau).
dapat disematkan: Boolean ini adalah true jika buku dapat disematkan ke halaman pihak ketiga menggunakan penampil tersemat Penelusuran Buku.

Dynamic Links

Daftar Isi

Penonton

Terminologi Penelusuran Buku

Pengantar

Panduan branding

Contoh branding

API sisi klien

Format permintaan

Format hasil JSON

Parameter dan kolom tambahan

Mode sinkron vs. asinkron

Mode asinkron

Mode sinkron

Pertanyaan umum (FAQ)

Contoh kode