Panoramica
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Che cosa sono le API Navigazione sicura?
Le seguenti API Navigazione sicura sono destinate esclusivamente a un uso non commerciale. Se hai bisogno di utilizzare le API per rilevare URL dannosi per scopi commerciali, ovvero "per la vendita o per generare entrate", consulta l'API Web Risk.
Le API Navigazione sicura (v4) consentono alle applicazioni client di controllare gli URL rispetto agli elenchi costantemente aggiornati di Google relativi a risorse web non sicure. Esempi di risorse web non sicure sono i siti di ingegneria sociale (siti di phishing e ingannevoli) e i siti che ospitano malware o software indesiderato.
Qualsiasi URL trovato in un elenco di Navigazione sicura è considerato non sicuro.
Per determinare se un URL è presente in uno degli elenchi di Navigazione sicura, i client possono utilizzare l'API Lookup (v4) o l'API Update (v4).
API Lookup (v4)
L'API Lookup consente alle applicazioni client di inviare URL al server Navigazione sicura di Google per
controllarne lo stato. L'API è semplice e facile da usare, in quanto evita le complessità dell'API Update.
Vantaggi:
- Controlli semplici degli URL: invii una richiesta HTTP
POST con gli URL effettivi
e il server risponde con lo stato degli URL (sicuri o non sicuri).
Svantaggi:
- Privacy: gli URL non vengono sottoposti ad hashing, quindi il server sa quali URL cerchi.
- Tempo di risposta: ogni richiesta di ricerca viene elaborata dal server. Non
forniamo garanzie sul tempo di risposta della ricerca.
Se la privacy degli URL sottoposti a query non ti preoccupa troppo e puoi tollerare la latenza indotta da una richiesta di rete, ti consigliamo di utilizzare l'API Lookup, che è abbastanza facile da usare.
API Update (v4)
L'API Update consente alle tue applicazioni client di scaricare versioni criptate degli elenchi di Navigazione sicura
per i controlli locali lato client degli URL. L'API Update è progettata per i client che richiedono
verifiche a bassa latenza e ad alta frequenza. Diversi browser web e piattaforme software utilizzano questa
API per proteggere grandi gruppi di utenti.
Vantaggi:
- Privacy: lo scambio di dati con il server avviene di rado (solo dopo una corrispondenza del prefisso hash locale) e utilizzando URL sottoposti ad hashing, quindi il server non conosce mai gli URL effettivi interrogati dai client.
- Tempo di risposta: mantieni un database locale che contiene copie degli elenchi di Navigazione sicura; non è necessario eseguire query sul server ogni volta che vuoi controllare un URL.
Svantaggi:
- Implementazione: devi configurare un database locale, scaricare e aggiornare periodicamente le copie locali degli elenchi di Navigazione sicura (memorizzati come hash SHA256 a lunghezza variabile).
- Controlli complessi degli URL: devi sapere come canonizzare gli URL, creare espressioni di suffisso/prefisso
e calcolare gli hash SHA256 (per il confronto con le copie locali degli elenchi di Safe
Browsing e con gli elenchi di Safe Browsing archiviati sul server).
Se ti preoccupa la privacy degli URL sottoposti a query o la latenza indotta da una
richiesta di rete, utilizza l'API Update.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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."]]
