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

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

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

リストについて

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

リスト名

各セーフブラウジングリストは、threatType、platformType、threatEntryType の 3 つのパラメータまたは型の組み合わせを使用して命名（識別）されます（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

レスポンスの本文

セーフブラウジングリストは脅威リストの配列として返されます。前述のように、各リストは 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 の確認をご覧ください）。

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