סקירה כללית
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מהם ממשקי ה-API של הגלישה הבטוחה?
ממשקי ה-API הבאים של הגלישה הבטוחה מיועדים לשימוש לא מסחרי בלבד. אם אתם צריכים להשתמש בממשקי API כדי לזהות כתובות URL זדוניות למטרות מסחריות – כלומר, 'למטרות מכירה או ליצירת הכנסות' – אתם יכולים לעיין ב-Web Risk API.
ממשקי Safe Browsing API (גרסה 4) מאפשרים לאפליקציות לקוח לבדוק כתובות URL מול רשימות של Google שמתעדכנות באופן שוטף וכוללות משאבי אינטרנט לא בטוחים. דוגמאות למשאבי אינטרנט לא בטוחים: אתרים של הנדסה חברתית (פישינג ואתרים מטעים) ואתרים שמארחים תוכנות זדוניות או תוכנות לא רצויות.
כל כתובת URL שמופיעה ברשימת הגלישה הבטוחה נחשבת ללא בטוחה.
כדי לבדוק אם כתובת URL מופיעה באחת מרשימות הגלישה הבטוחה, לקוחות יכולים להשתמש ב-Lookup API (גרסה 4) או ב-Update API (גרסה 4).
Lookup API (גרסה 4)
באמצעות Lookup API, אפליקציות לקוח יכולות לשלוח כתובות URL לשרת של Google לגלישה בטוחה כדי לבדוק את הסטטוס שלהן. ה-API פשוט וקל לשימוש, כי הוא לא כולל את המורכבויות של Update API.
יתרונות:
- בדיקות פשוטות של כתובות URL: אתם שולחים בקשת HTTP
POST עם כתובות ה-URL בפועל, והשרת מגיב עם הסטטוס של כתובות ה-URL (בטוחות או לא בטוחות).
חסרונות:
- פרטיות: כתובות ה-URL לא עוברות גיבוב, כך שהשרת יודע אילו כתובות URL אתם מחפשים.
- זמן תגובה: כל בקשת חיפוש מעובדת על ידי השרת. אנחנו לא מספקים ערבויות לגבי זמן התגובה של בדיקת המידע.
אם אתם לא מודאגים מדי לגבי הפרטיות של כתובות ה-URL שמוזנות לשאילתה, ואתם יכולים לסבול את זמן האחזור שנובע מבקשת רשת, כדאי להשתמש ב-Lookup API כי הוא די פשוט לשימוש.
Update API (גרסה 4)
באמצעות Update API, אפליקציות לקוח יכולות להוריד גרסאות מוצפנות של רשימות הגלישה הבטוחה כדי לבצע בדיקות מקומיות בצד הלקוח של כתובות URL. Update API מיועד ללקוחות שנדרשים להם פסקי דין בתדירות גבוהה ובזמן אחזור נמוך. כמה דפדפני אינטרנט ופלטפורמות תוכנה משתמשים בממשק ה-API הזה כדי להגן על קבוצות גדולות של משתמשים.
יתרונות:
- פרטיות: הנתונים מועברים לשרת לעיתים רחוקות (רק אחרי התאמה של קידומת גיבוב מקומית) ובאמצעות כתובות URL מגובבות, כך שהשרת אף פעם לא יודע מהן כתובות ה-URL האמיתיות שהלקוחות מחפשים.
- זמן תגובה: אתם מנהלים מסד נתונים מקומי שמכיל עותקים של רשימות הגלישה הבטוחה. אין צורך לשלוח שאילתה לשרת בכל פעם שרוצים לבדוק כתובת URL.
חסרונות:
- הטמעה: צריך להגדיר מסד נתונים מקומי, ואז להוריד את העותקים המקומיים של רשימות הגלישה הבטוחה (שמאוחסנים כגיבובי SHA256 באורך משתנה) ולעדכן אותם מעת לעת.
- בדיקות מורכבות של כתובות URL: צריך לדעת איך לבצע קנוניזציה של כתובות URL, ליצור ביטויי סיומת/קידומת ולחשב גיבובי SHA256 (לצורך השוואה עם העותקים המקומיים של רשימות הגלישה הבטוחה וגם עם רשימות הגלישה הבטוחה שמאוחסנות בשרת).
אם אתם מודאגים לגבי הפרטיות של כתובות ה-URL שנשלחו בשאילתה או לגבי זמן האחזור שנובע מבקשת רשת, אתם יכולים להשתמש ב-Update API.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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."]]
