このページは Cloud Translation API によって翻訳されました。

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

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

リストについて

セーフブラウジングリスト（脅威リストまたは単純なリスト - 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 を確認するをご覧ください）。

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