セーフ ブラウジングのリスト

このドキュメントは、次のメソッドに適用されます。

リストについて

セーフ ブラウジング リスト（脅威リストまたは 単純なリスト - Google は常に更新している、安全でないウェブリソースのリストです。 安全でないウェブリソースの例としては、ソーシャル エンジニアリング サイト（フィッシング サイトや偽のサイト）や マルウェアや望ましくないソフトウェアをホストするサイト。

リスト名

各セーフ ブラウジング リストには、次の 3 つのパラメータまたは型の組み合わせを使用して名前（識別）が付けられます。 threatType、platformType、threatEntryType（ ThreatListDescriptor）。

セーフ ブラウジング サーバーにリクエストを送信する前に、クライアントは 現在利用できるセーフ ブラウジング リストの一覧をご覧ください。こうすることで、パラメータや型が 有効な組み合わせが有効です。

セーフ ブラウジング リストの名前を取得するには、 threatLists.list メソッドと HTTP GET リクエスト/レスポンス。

例：threatLists.list

HTTP GET リクエスト

リクエストにはヘッダーのみが含まれる（リクエスト本文は含まれない）。

リクエスト ヘッダー

リクエスト ヘッダーには、リクエスト URL とコンテンツ タイプが含まれます。忘れずに URL 内の API_KEY の API キー。

GET https://safebrowsing.googleapis.com/v4/threatLists?key=API_KEY HTTP/1.1
Content-Type: application/json

リクエスト本文

このメソッドにはリクエスト本文がありません。

HTTP GET レスポンス

レスポンスでは、現在クエリまたはダウンロードが可能なセーフ ブラウジング リストが返されます。この この例では、2 つのリストのみが表示されていますが、追加のリストが使用可能で、返されます。

レスポンス ヘッダー

レスポンス ヘッダーには、HTTP ステータス コードが含まれます。 コンテンツタイプを指定します

HTTP/1.1 200 OK
Content-Type: application/json

レスポンスの本文

セーフ ブラウジング リストは脅威リストの配列として返されます。前述のように、 list は 3 つのパラメータまたは型の組み合わせ（threatType、platformType、および threatEntryType。

{
  threatLists: [{
      "threatType":      "MALWARE",
      "platformType":    "WINDOWS",
      "threatEntryType": "URL",
  }, {
      "threatType":      "MALWARE",
      "platformType":    "LINUX",
      "threatEntryType": "URL",
  }, {
    ... additional lists will be returned ...
  }]
}

リストの内容

現在、すべてのセーフ ブラウジング リストは、4 ～ 32 の可変長 SHA 256 ハッシュで構成されています あります。これらのハッシュは、安全でない URL の接尾辞/接頭辞の式に基づいています。 説明します。なお、URL 自体がセーフ ブラウジングのリストに保存されることはありません。 （URL とハッシュをご覧ください）。

Lookup API を使用して URL を確認する場合、クライアントはリクエストで実際の URL を送信し、 セーフ ブラウジング サーバーが URL をハッシュに変換してからチェックを行う （Lookup API の URL の確認をご覧ください）。

Update API を使用して URL を確認する場合、クライアントは URL をハッシュに変換して、 URL チェックを実行するためのリクエスト内のハッシュ接頭辞 （Update API については URL を確認するをご覧ください）。