Evaluate API の使用

このページでは、Evaluate API を使用して、クライアント アプリケーションで悪意のある URL を評価する方法について説明します。この API は、URL が悪意のあるものである可能性を示す、脅威タイプごとの信頼スコアを返します。この可能性は、セーフ ブラウジングのブロックリスト、生成 AI モデル、ML モデル、ヒューリスティック ルールに基づいて計算されます。信頼スコアではなくバイナリ結果が必要な場合は、Lookup APIを使用します。

注: Evaluate API に提出された URL は、クロールを含む追加の処理を受ける場合があります。

始める前に

この機能は、限定公開プレビューで、ユースケースがその機能に直接合致する一部のお客様にご利用いただけます。プロダクト チームとエンジニアリング チームによるユースケースのレビューをご希望の場合は、営業チームにお問い合わせください。

URL の評価

URL を評価するには、HTTP POST リクエストを evaluateUri メソッドに送信します。URL を評価するときは、次の点を考慮してください。

• Evaluate API は、リクエストごとに 1 つの URL をサポートします。複数の URL をチェックする場合は、URL ごとに個別のリクエストを送信します。
• URL は有効である必要がありますが、正規化する必要はありません。詳細については、RFC 2396 をご覧ください。
• Evaluate API は、SOCIAL_ENGINEERING、MALWARE、UNWANTED_SOFTWARE の 3 つの threatTypes をサポートしています。
• 非推奨。allow_scan フィールドは、指定した URL を Web Risk でスキャンできるかどうかを決定するために使用されました。この機能は、Evaluate API で無効にできなくなりました。クロール不要のオプションについては、Lookup API と Update API をご覧ください。
• HTTP POST レスポンスは、指定された threatType の信頼スコアを返します。信頼スコアは、指定した URL のリスクを示す信頼度レベルを表します。

API リクエスト

リクエストのデータを使用する前に、次のように置き換えます。

HTTP メソッドと URL:

POST https://webrisk.googleapis.com/v1eap1:evaluateUri?key=API_KEY