概要
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Safe Browsing API とは何ですか？
次のセーフ ブラウジング API は、非商用目的でのみ使用できます。商用目的（「販売または収益創出目的」）で API を使用して悪意のある URL を検出する必要がある場合は、Web Risk API をご覧ください。
Safe Browsing API（v4）を使用すると、クライアント アプリケーションで、常に更新される Google の安全でないウェブリソースのリストに照らし合わせて URL をチェックできます。安全でないウェブリソースの例としては、ソーシャル エンジニアリング サイト（フィッシング サイトや詐欺サイト）や、マルウェアまたは望ましくないソフトウェアをホストするサイトがあります。セーフ ブラウジング リストに記載されている URL は安全ではないとみなされます。
URL がセーフ ブラウジング リストにあるかどうかを判断するために、クライアントは Lookup API（v4）または Update API（v4）を使用できます。
Lookup API（v4）
Lookup API を使用すると、クライアント アプリケーションが Google セーフ ブラウジング サーバーにステータスを確認するための URL を送信します。この API は Update API の複雑さを回避できるため、シンプルで使いやすい API です。
メリット:
- シンプルな URL チェック: HTTP
POST リクエストを実際の URL とともに送信すると、サーバーは URL の状態（安全または安全でない）を返します。
デメリット:
- プライバシー: URL はハッシュ化されないため、サーバーが検索する URL を認識します。
- 応答時間: すべての検索リクエストがサーバーによって処理されます。検索の応答時間は保証されません。
クエリされた URL のプライバシーをあまり気にせず、ネットワーク リクエストによるレイテンシを許容できる場合は、Lookup API を使用することをおすすめします。
Update API（v4）
Update API を使用すると、クライアント アプリケーションで Safe Browsing リストの暗号化バージョンをダウンロードして、URL のローカル クライアントサイド チェックを行うことができます。Update API は、高頻度で低遅延の判定を必要とするクライアント向けに設計されています。この API は、複数のウェブブラウザやソフトウェア プラットフォームで、多数のユーザーを保護するために使用されています。
メリット:
- プライバシー: サーバーとのデータ交換頻度が低く（ローカルのハッシュ プレフィックスと一致した後のみ）、ハッシュ化された URL を使用するため、サーバーはクライアントがクエリした実際の URL がわかりません。
- 応答時間: セーフ ブラウジング リストのコピーを含むローカル データベースを維持します。URL を確認するたびにサーバーにクエリする必要はありません。
デメリット:
- 実装: ローカル データベースを設定し、セーフ ブラウジング リストのローカルコピーをダウンロードして定期的に更新する必要があります（可変長の SHA256 ハッシュとして保存されます）。
- 複雑な URL のチェック: URL の正規化、サフィックス/プレフィックス式の作成、SHA256 ハッシュの計算（セーフ ブラウジング リストのローカルコピーとサーバーに保存されたセーフ ブラウジング リストを比較するため）を行う方法を認識している必要があります。
クエリされた URL のプライバシーやネットワーク リクエストによって誘導されるレイテンシが心配な場合は、Update API を使用します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 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."]]
