リリースノート

Version 4.0

Safe Browsing API（v4）には、以下のアップデートと新機能が含まれています。

Lookup API（v4）

同じ点:

  • この API では、引き続きクライアントが Google セーフ ブラウジング サーバーとセーフ ブラウジング リストに直接クエリを実行できます。

相違点:

  • HTTP GET メソッドはサポートされなくなりました。代わりに HTTP POST メソッドを使用してください。
  • key パラメータが、HTTP POST リクエスト URL で必要な唯一のパラメータになりました。
  • HTTP POST リクエストとレスポンスの形式が変更されました。書式なしテキストはサポートされなくなりました。代わりに JSON を使用してください。

Update API（v4）

同じ点:

  • この API では、引き続きクライアントが、ローカル データベースのリストの SHA256 ハッシュ プレフィックスを定期的に更新するようになっています。
  • また、この API には、クライアントがハッシュ プレフィックスの競合が発生した場合に、SHA256 の完全長ハッシュを取得するためのリクエストも用意されています。

相違点:

  • key パラメータが、HTTP POST リクエスト URL で必要な唯一のパラメータになりました。
  • HTTP POST リクエストとレスポンスの形式が変更されました。書式なしテキストはサポートされなくなりました。代わりに JSON を使用してください。
  • 更新のエンコード方法が変更されました。追加チャンクとサブチャンクを提供する代わりに、API はシンプルなバージョニング プロトコルを使用して差分を提供するようになりました。クライアントは、現在の状態をリクエストされた更新とともにサーバーに送信します。サーバーは、クライアントを完全に更新するための新しいクライアントの状態と差分を返します。
  • クライアントの制約に対応するときに保護の犠牲を最小限に抑えるために、この API は優先順位付けされた脅威リストを提供します。デバイスのリソース、帯域幅、位置情報、その他のシグナルを使用して、優先度が最も高い脅威データを各クライアントに配信します。

ThreatLists.list メソッド

新しいメソッド threatLists.list により、現在検索またはダウンロードが可能なセーフ ブラウジング リストのリストが返されます。

ステータス コード

HTTP POST リクエストに応じてサーバーが生成した HTTP ステータス コードが変更されました。