Ringkasan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Apa yang dimaksud dengan Safe Browsing API?
Safe Browsing API berikut hanya untuk penggunaan non-komersial. Jika Anda perlu menggunakan API untuk mendeteksi URL berbahaya untuk tujuan komersial – yang berarti “untuk tujuan penjualan atau menghasilkan pendapatan” – lihat Web Risk API.
Safe Browsing API (v4) memungkinkan aplikasi klien Anda memeriksa URL berdasarkan daftar resource web tidak aman yang terus diperbarui Google. Contoh resource web yang tidak aman adalah situs manipulasi psikologis (situs phishing dan penipuan) serta situs yang menghosting malware atau software yang tidak diinginkan.
Setiap URL yang ditemukan dalam daftar Safe Browsing dianggap tidak aman.
Untuk menentukan apakah suatu URL ada dalam daftar Safe Browsing, klien dapat menggunakan
Lookup API (v4)
atau Update API (v4).
Lookup API (v4)
Lookup API memungkinkan aplikasi klien Anda mengirim URL ke server Google Safe Browsing untuk
memeriksa statusnya. API ini sederhana dan mudah digunakan, karena menghindari kompleksitas
Update API.
Kelebihan:
- Pemeriksaan URL sederhana: Anda mengirim permintaan HTTP
POST dengan URL sebenarnya,
dan server merespons dengan status URL (aman atau tidak aman).
Kekurangan:
- Privasi: URL tidak di-hash, sehingga server mengetahui URL yang Anda cari.
- Waktu respons: Setiap permintaan penelusuran diproses oleh server. Kami tidak
memberikan jaminan waktu respons pencarian.
Jika Anda tidak terlalu mengkhawatirkan privasi URL yang dikueri, dan Anda dapat mentoleransi latensi yang disebabkan oleh permintaan jaringan, pertimbangkan untuk menggunakan Lookup API karena cukup mudah digunakan.
Update API (v4)
Update API memungkinkan aplikasi klien Anda mendownload versi terenkripsi dari daftar Safe Browsing
untuk pemeriksaan URL sisi klien secara lokal. Update API dirancang untuk klien yang memerlukan
putusan dengan frekuensi tinggi dan latensi rendah. Beberapa browser web dan platform software menggunakan
API ini untuk melindungi banyak pengguna.
Kelebihan:
- Privasi: Anda bertukar data dengan server secara jarang (hanya setelah awalan hash lokal cocok) dan menggunakan URL yang di-hash, sehingga server tidak pernah mengetahui URL sebenarnya yang dikueri oleh klien.
- Waktu respons: Anda mengelola database lokal yang berisi salinan daftar Safe
Browsing; mereka tidak perlu mengkueri server setiap kali ingin memeriksa URL.
Kekurangan:
- Implementasi: Anda perlu menyiapkan database lokal, lalu mendownload, dan
memperbarui salinan lokal daftar Safe Browsing secara berkala (disimpan sebagai
hash SHA256 dengan panjang variabel).
- Pemeriksaan URL yang kompleks: Anda perlu mengetahui cara menganonimkan URL, membuat ekspresi akhiran/awalan, dan menghitung hash SHA256 (untuk perbandingan dengan salinan lokal daftar Penjelajahan Aman serta daftar Penjelajahan Aman yang disimpan di server).
Jika Anda khawatir tentang privasi URL yang dikueri atau latensi yang disebabkan oleh
permintaan jaringan, gunakan Update API.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003eThe Safe Browsing APIs (v4) enable client applications to check URLs against Google's lists of unsafe web resources, including phishing sites and those hosting malware.\u003c/p\u003e\n"],["\u003cp\u003eTwo APIs are available: Lookup API (v4) for simple URL checks and Update API (v4) for local, privacy-focused checks.\u003c/p\u003e\n"],["\u003cp\u003eLookup API (v4) offers ease of use but has privacy and response time limitations.\u003c/p\u003e\n"],["\u003cp\u003eUpdate API (v4) prioritizes privacy and speed but requires more complex implementation and URL handling.\u003c/p\u003e\n"],["\u003cp\u003eThese APIs are for non-commercial use only; commercial users should refer to the Web Risk API.\u003c/p\u003e\n"]]],["Safe Browsing APIs allow client applications to check URLs against Google's unsafe web resource lists, distinguishing between non-commercial and commercial use (Web Risk API). The Lookup API checks URL status via server requests, offering simplicity but compromising privacy and response time. The Update API downloads encrypted lists for local checks, prioritizing privacy and speed but requiring complex implementation, database setup, and hash management. Users can choose between these based on privacy needs and latency tolerance.\n"],null,["# Overview\n\nWhat are the Safe Browsing APIs?\n--------------------------------\n\nThe following Safe Browsing APIs are for non-commercial use only. If you need to use APIs\nto detect malicious URLs for commercial purposes -- meaning \"for sale or revenue-generating\npurposes\" -- please refer to the [Web Risk API](https://cloud.google.com/web-risk).\n\nThe Safe Browsing APIs (v4) let your client applications check URLs against Google's\nconstantly updated lists of unsafe web resources. Examples of unsafe web resources are social\nengineering sites (phishing and deceptive sites) and sites that host malware or unwanted software.\nAny URL found on a Safe Browsing list is considered unsafe.\n\nTo determine if a URL is on any of the Safe Browsing lists, clients can use either\nthe [Lookup API (v4)](/safe-browsing/v4/lookup-api)\nor the [Update API (v4)](/safe-browsing/v4/update-api).\n\nLookup API (v4)\n---------------\n\nThe Lookup API lets your client applications send URLs to the Google Safe Browsing server to\ncheck their status. The API is simple and easy to use, as it avoids the complexities of the\nUpdate API.\n\nAdvantages:\n\n- Simple URL checks: You send an HTTP `POST` request with the actual URLs, and the server responds with the state of the URLs (safe or unsafe).\n\nDrawbacks:\n\n- Privacy: URLs are not hashed, so the server knows which URLs you look up.\n- Response time: Every lookup request is processed by the server. We don't provide guarantees on lookup response time.\n\nIf you are not too concerned about the privacy of the queried URLs, and you can tolerate the\nlatency induced by a network request, consider using the Lookup API since it's fairly easy to\nuse.\n\nUpdate API (v4)\n---------------\n\nThe Update API lets your client applications download encrypted versions of the Safe Browsing\nlists for local, client-side checks of URLs. The Update API is designed for clients that require\nhigh frequency, low-latency verdicts. Several web browsers and software platforms use this\nAPI to protect large sets of users.\n\nAdvantages:\n\n- Privacy: You exchange data with the server infrequently (only after a local hash prefix match) and using hashed URLs, so the server never knows the actual URLs queried by the clients.\n- Response time: You maintain a local database that contains copies of the Safe Browsing lists; they do not need to query the server every time they want to check a URL.\n\nDrawbacks:\n\n- Implementation: You need to set up a local database and then download, and periodically update, the local copies of the Safe Browsing lists (stored as variable-length SHA256 hashes).\n- Complex URL checks: You need to know how to canonicalize URLs, create suffix/prefix expressions, and compute SHA256 hashes (for comparison with the local copies of the Safe Browsing lists as well as the Safe Browsing lists stored on the server).\n\nIf you are concerned about the privacy of the queried URLs or the latency induced by a\nnetwork request, use the Update API."]]
