API dalam Keluarga API Google Buku tersedia bagi siapa saja yang ingin berintegrasi dengan Google Buku dari situs atau aplikasi mereka sendiri. Tidak diperlukan prapersetujuan untuk menggunakan API ini.
Namun, penggunaan API ini diatur oleh Persyaratan Layanan. Di antara persyaratan lainnya, Persyaratan ini mewajibkan Anda mematuhi panduan tertentu tentang cara tata letak, atribusi Google, dan branding harus ditangani di situs Anda. Dokumen ini dimaksudkan untuk membantu Anda memenuhi persyaratan ini.
Pedoman branding ini dapat berubah dari waktu ke waktu dan tanpa pemberitahuan sebelumnya dari Google. Penggunaan berkelanjutan Anda atas Keluarga Google Books API bergantung pada kepatuhan Anda terhadap pedoman branding saat ini. Jika Anda merasa tidak nyaman dengan salah satu pedoman branding ini, hentikan penggunaan API, dan hubungi kami jika ada masalah.
Ringkasan
Tujuan Jenis Google Books API adalah untuk membantu Anda secara andal mengarahkan pengguna ke layanan Google Buku dari situs Anda. Dengan demikian, ada persyaratan atribusi dan penautan tertentu. Prinsip dasar berikut mengatur penggunaan Anda atas Kategori Google Books API:
- Kepatuhan terhadap pedoman ini diperlukan sebelum penggunaan Kelompok Google API Google dari situs web atau aplikasi Anda.
- Anda harus mematuhi konvensi penamaan tertentu yang terkait dengan Google Buku dan fiturnya.
- Google harus diberi atribusi dengan menggunakan teks atau elemen merek yang sesuai, setiap kali Anda menampilkan hasil Google, pratinjau, atau konten lain yang disediakan melalui API.
- Anda harus mempertahankan link yang jelas ke halaman dan fitur Google Buku.
- Anda tidak boleh mengubah hasil atau konten yang disediakan melalui Kelompok Google Books API.
Penamaan
Untuk membantu kami memastikan pengalaman pengguna akhir yang konsisten dan ekspektasi fitur Google Buku yang akurat, Anda harus mematuhi konvensi penamaan tertentu.
Saat membuat fitur atau produk yang menggunakan Kategori Google Books API, nama fitur atau produk tidak boleh menggunakan Google, Google Buku, atau Fitur Merek Google lainnya atas nama software atau fitur. Jika karena alasan pemasaran atau alasan strategis lainnya, ada baiknya merujuk Google Buku, developer dapat menggunakan frasa tersebut (misalnya, 'Plugin Acme untuk Google Buku,' tetapi tidak pernah 'Plugin AcmeOPAC Google Buku'), namun ini harus menjadi pengecualian dan bukan aturan. Anda tidak boleh menyatakan atau menyiratkan afiliasi apa pun dengan Google atau Google Buku.
Terkadang perlu untuk merujuk ke Google Buku atau fitur yang disediakan melalui API ini (misalnya, dalam dokumentasi, header, tombol, dan sebagainya). Saat melakukannya, Anda hanya boleh menggunakan terminologi yang disetujui:
- Layanan Google Buku: Hanya menggunakan istilah "Google Buku" untuk merujuk layanan yang disediakan melalui API ini dan di URL seperti books.google.com. Jangan ubah logo teks ini, misalnya, melalui tanda hubung, singkatan kombinasi, atau akronim seperti: Google Buku, GB, Penelusuran Google Buku, dll.
- Kategori Google Books API: Hanya gunakan istilah "Google Books API Family" untuk melihat sekumpulan fitur yang ditampilkan kepada developer yang dijelaskan di https://developer.google.com/books. Lihat API dan alat tertentu menggunakan terminologi dari situs ini.
- Kemampuan pratinjau: Jika Anda merujuk pada kemampuan pratinjau buku yang diberikan Google dalam aplikasi Anda (misalnya, dalam header atau teks penjelasan), gunakan hanya satu istilah berikut, dan lakukan secara konsisten di seluruh situs Anda: "Pratinjau," "Pratinjau Google," atau "Pratinjau buku." Saat merujuk pada tingkat visibilitas, hanya gunakan istilah "Pratinjau terbatas" atau "Tampilan lengkap."
- Kemampuan penelusuran: Anda hanya dapat menggunakan kata kerja "Telusuri," "Telusuri Buku," atau "Telusuri dalam buku ini" saat meminta pengguna melakukan tindakan yang menghasilkan kueri API (misalnya, pada formulir 'kirim' tombol). Hanya gunakan istilah "hasil penelusuran Google Buku" bersama dengan tampilan hasil penelusuran dari API ini.
- Konten buatan pengguna: Beberapa API dalam Keluarga API Google Buku memungkinkan Anda membaca dan menulis konten buatan pengguna, termasuk ulasan dan koleksi buku. Baca fitur ini sesuai dengan terminologi di Google Buku dan dokumentasi terkait. Misalnya: Anda dapat menggunakan "Koleksi Saya" (bukan Koleksi Google), "label" (bukan tag), "ulasan," "rating," dan seterusnya.
Jika Anda ingin menggunakan fitur Google Buku dalam bahasa selain bahasa Inggris, Anda harus menggunakan terminologi yang sama dengan situs Google Buku, yang tersedia dalam lebih dari 35 bahasa. Demi kenyamanan, kami menyediakan tabel terjemahan yang disetujui untuk beberapa fitur yang paling umum.
Untuk pertanyaan lain tentang penggunaan Fitur Merek Google lainnya, kunjungi https://www.google.com/permissions/guidelines.html.
Atribusi dan logo
Selain mengikuti pedoman Fitur Merek umum Google, Anda juga diwajibkan untuk menggunakan elemen merek tertentu saat menggunakan Kelompok API Google Books. Bentuk atribusi ini digunakan untuk menjaga konsistensi dan menjaga identitas merek Google.
Prinsip dasar berikut mengatur penggunaan nama dan logo Google bersamaan dengan Kelompok API Google Buku:
- Atribusi Google harus disertakan.
- Nama dan logo Google hanya boleh dikaitkan dengan Google Buku.
- Logo Google tidak boleh muncul di samping atau di halaman yang sama dengan logo web pesaing atau layanan penelusuran lainnya. Tidak ada pengecualian untuk aturan ini.
- "didukung oleh Google" grafik harus selalu ditampilkan bersama modul penelusuran atau hasil apa pun.
- Anda harus menampilkan setiap dan semua legenda dan pemberitahuan hak atas kekayaan intelektual (misalnya, pemberitahuan hak cipta) sebagaimana diinstruksikan oleh Google.
Bagian berikut memberikan detail lebih lanjut tentang atribusi yang dapat diterima.
Pratinjau buku
Kapan saja Anda ingin mengarahkan pengguna ke halaman atau elemen yang elemennya yang paling menonjol adalah pratinjau buku yang disediakan Google ("Pratinjau Google"), Anda harus menautkan ke halaman tersebut menggunakan tombol "Pratinjau Google" yang diotorisasi dan dapat diklik di bawah. Anda juga harus menggunakan tombol Pratinjau Google saat membuka halaman pratinjau di jendela browser baru, atau saat menautkan ke halaman pratinjau yang dihosting oleh Google.
|
GIF aman untuk web PNG sumber |
Jika Anda ingin menunjukkan kepada pengguna bahwa kemampuan Pratinjau Google tersedia untuk judul buku atau untuk hasil penelusuran buku di halaman web Anda sendiri, gunakan stiker "Pratinjau Google" yang tidak dapat diklik. Anda tidak diharuskan untuk menyebutkan kemampuan pratinjau dalam kasus tersebut, tetapi jika Anda melakukannya, stiker Pratinjau Google harus ditampilkan.
|
GIF aman untuk web PNG sumber |
Saat menyematkan Pratinjau Google di halaman mana pun, Anda tidak boleh mengaburkan, mengubah, atau menyesuaikan elemen apa pun di Pratinjau Google, kecuali seperti yang ditentukan oleh Google (mis., dalam dokumentasi developer di situs ini).
Lihat halaman terjemahan yang disetujui untuk versi gambar yang dilokalkan di atas.
Kotak penelusuran
Dengan Keluarga dan alat Google Books API, Anda dapat menerbitkan kueri penelusuran Google Buku langsung dari situs Anda. Kotak penelusuran yang Anda gunakan bersama dengan fitur ini harus menyertakan atribusi yang tepat ke Google. Anda harus menyertakan atribusi ini meskipun hasil penelusuran dirender dalam situs Anda sendiri.
Anda dapat memilih untuk menampilkan watermark Google di dalam kotak penelusuran Anda, atau logo "Didukung oleh Google" di samping kotak penelusuran Anda. Teks atau tombol apa pun harus mematuhi konvensi penamaan yang dijelaskan di atas.
| Jenis penelusuran | Gaya watermark | Tidak ada gaya watermark |
|---|---|---|
| Telusuri semua buku | ||
| Menelusuri dalam buku |
Telusuri dalam buku ini
|
Telusuri dalam buku ini
|
Hasil penelusuran dan informasi buku
Aplikasi Anda dapat menampilkan, sebagai tanggapan atas tindakan pengguna, informasi buku yang diperoleh dari API Google Books API. Setiap kali Anda menampilkan informasi tersebut, Anda harus menyertakan atribusi ke Google dan menautkan secara jelas ke fitur Google Buku.
Dengan teknologi Google. Saat merender satu atau beberapa hasil buku dari Keluarga Google Books API, logo "didukung oleh Google" harus tampak berdekatan dengan hasil ini. Anda harus menghindari duplikasi pesan "yang didukung oleh Google" (mis., jika Anda telah memiliki kotak penelusuran bermerek Google langsung di atas hasil).
|
Link penting ke Google Buku. Setiap hasil buku yang ditampilkan dalam aplikasi Anda harus memiliki link yang menonjol ke (1) halaman di situs Anda yang menampilkan kemampuan Pratinjau Google, atau (2) halaman Google Buku untuk buku tersebut. Saat menautkan langsung ke pratinjau dari hasil penelusuran, pastikan untuk menggunakan "Pratinjau Google" gambar seperti yang dijelaskan di atas.
Perubahan hasil penelusuran. Anda tidak boleh menyusun ulang atau mengubah hasil yang ditampilkan dalam Kelompok Google Books API. Untuk mengetahui informasi selengkapnya, lihat Persyaratan Layanan.
Contoh penerapan yang dapat diterima
Untuk menggambarkan penerapan pedoman branding di situs atau aplikasi Anda, bagian ini menyertakan berbagai screenshot penerapan yang mematuhi kebijakan. Ini disediakan sebagai contoh dan tidak mencakup semua kemungkinan yang berlaku dalam pedoman branding di situs Anda.
Anda dapat mengklik gambar thumbnail di bawah untuk melihat gambar yang diperbesar.
Menautkan ke halaman pratinjau
Dalam banyak kasus, Anda mungkin ingin mengarahkan pengguna ke halaman atau jendela yang dikhususkan untuk menampilkan pratinjau buku.
|
Tombol Pratinjau Google
Seperti yang dijelaskan di atas, Anda harus menggunakan "Pratinjau Google" setiap kali menggunakan API Google Buku API untuk mengarahkan pengguna ke pratinjau Google Buku. Tombol Pratinjau Google, misalnya, dapat ditempatkan di samping metadata buku atau gambar sampul. |
Aplikasi Anda dapat menggunakan tombol ini untuk meluncurkan pratinjau di situs Anda, di situs web Google Buku, atau di halaman pihak ketiga. Pratinjau dapat terbuka di jendela baru, atau mengambil alih jendela yang sudah ada. Screenshot berikut menunjukkan apa yang mungkin dilihat pengguna setelah mengklik tombol "Pratinjau Google".
|
Pop-up Pratinjau
Anda mungkin ingin tombol Pratinjau Google meluncurkan "popup" yang berisi penampil tersemat. Wizard Pratinjau membuat pendekatan pop-up menjadi sangat mudah diterapkan di situs Anda. |
|
Lihat pratinjau halaman di situs Anda
Daripada membuka jendela pop-up, Anda mungkin memiliki link Pratinjau Google ke halaman terpisah di situs Anda yang dikhususkan untuk menampilkan pratinjau. |
|
Halaman pratinjau Google Buku
Anda dapat menggunakan tombol Pratinjau Google untuk menautkan langsung ke halaman pratinjau di situs Google Buku (mis., jika Anda menggunakan Dynamic Links untuk menentukan URL visibilitas dan pratinjau), atau ke pratinjau Penelusuran Bersama yang dihosting oleh Google. |
Menampilkan pratinjau inline
Anda juga dapat menyertakan Pratinjau Google sebagai elemen sekunder halaman di situs Anda.
|
Bagian pratinjau
Dalam contoh ini, penampil tersemat disisipkan dalam header "Pratinjau buku" dalam halaman buku. Anda dapat menerapkannya menggunakan Dynamic Links dan Embedded Viewer. Seperti yang ditentukan di bagian penamaan, Anda juga dapat menggunakan "Pratinjau Google" atau hanya "Pratinjau" untuk header. |
|
Tab pratinjau
Contoh ini menunjukkan desain tab alternatif, yang memungkinkan pengguna membuka Pratinjau Google tanpa meninggalkan halaman. Seperti yang ditentukan di bagian penamaan, Anda juga dapat menggunakan "Pratinjau Google" atau hanya "Pratinjau" untuk nama tab. |
Menampilkan hasil penelusuran
|
Aplikasi penelusuran dan pratinjau
Screenshot ini menunjukkan bagaimana elemen branding akan muncul dalam penerapan lanjutan Books API yang merender hasil penelusuran Google Buku. Catatan khusus:
|
Persyaratan branding tambahan
- Anda juga harus mematuhi Pedoman Penggunaan Fitur Merek Google oleh Pihak Ketiga yang berlaku di seluruh Google.
- Penggunaan tombol, stiker, dan unsur merek yang dijelaskan dalam dokumen ini diatur oleh Persyaratan Layanan Keluarga Google Books API.
- Jangan ubah tanda Google apa pun dengan cara apa pun. Jangan menghapus, menghalangi, mendistorsi, atau mengubah elemen apa pun dari merek dagang Penelusuran Buku Google. Hal ini termasuk memodifikasi logo teks Google, misalnya, dengan menggunakan tanda sambung, singkatan kombinasi, atau akronim seperti: Pratinjau Google, GP, GBS, Penelusuran Buku Google, dll.
- Pastikan tombol, stiker, atau elemen branding lainnya penuh dan terlihat jelas, tidak pernah diubah atau tertutup sebagian.
- Jangan tampilkan tombol Pratinjau Google, stiker Pratinjau Google, atau gambar Didukung oleh Google sebagai elemen yang paling menonjol di halaman web Anda.
- Jangan menggunakan tombol, stiker, atau elemen branding lainnya dengan cara yang (1) menyiratkan hubungan dengan atau dukungan terhadap produk, layanan, acara, sponsor, atau organisasi lainnya; (2) dapat ditafsirkan secara wajar bahwa konten editorial ditulis oleh Google; atau (3) mewakili pandangan atau opini staf Google tanpa izin tertulis sebelumnya dari Google. Semua penggunaan yang disebutkan di atas harus disetujui melalui izin tertulis.
- Jangan menggunakan merek, logo, slogan, atau desain yang membingungkan karena mirip dengan merek dagang Google atau meniru pakaian dagang Google, termasuk tampilan dan nuansa properti desain web Google Buku, kemasan merek Google Buku, kombinasi warna yang khas, tipografi, desain grafis, ikon produk, atau gambar yang terkait dengan Google Buku.
- Jangan mendaftarkan merek dagang Google sebagai nama domain tingkat kedua atau memasukkan merek dagang Google ke dalam nama produk, nama layanan, merek dagang, logo, atau nama perusahaan Anda sendiri.
- Jangan pernah menampilkan merek dagang Google dengan cara yang menyesatkan, tidak adil, mencemarkan nama baik, melanggar, memfitnah, meremehkan, cabul, atau tidak pantas terhadap Google.
- Tidak boleh menampilkan merek dagang Penelusuran Buku Google di situs web atau antarmuka pengguna yang berisi atau menampilkan konten khusus dewasa, mempromosikan perjudian, mendukung kekerasan, berisi ujaran kebencian, melibatkan penjualan tembakau atau alkohol kepada orang berusia di bawah dua puluh satu tahun, melanggar hukum atau peraturan lainnya yang berlaku, atau tidak pantas.
Terakhir diperbarui 9 Mei 2011