Submission API の使用

このドキュメントでは、分析のために安全でないと思われる URL をセーフブラウジングに送信して、送信した URL の分析結果を非同期で確認する方法について説明します。セーフブラウジングポリシーに違反することが確認された URL はすべて、セーフブラウジングサービスに追加されます。

始める前に

この機能を利用するには、セールスまたはカスタマーエンジニアにお問い合わせください。

ベストプラクティス

セーフブラウジングポリシーを確認する

Web Risk Submission API は、送信された URL でセーフブラウジングポリシーに違反するコンテンツが表示されているかどうかを検証します。API デベロッパーは、送信された URL がこれらのポリシーに違反しているという明確な証拠があることを確認する必要があります。次の例は、ポリシー違反の証拠を示しています。

正当なオンラインブランド（ブランド名、ロゴ、外観）やシステムアラートを模倣する、不正な URL を使用する、ユーザーにユーザー名やパスワードなどの機密性の高い認証情報の入力を求めるソーシャルエンジニアリングコンテンツ。
既知のマルウェア実行可能ファイルをホストしているサイト。

以下のタイプの URLは、セーフブラウジングのブロックリストに追加されない可能性が高いため、API デベロッパーは、これらを送信しないでください。

偽のアンケート、ショッピングサイト、またはフィッシングでないその他の詐欺（暗号通貨詐欺など）。
フィッシング、マルウェアではない、ギャンブルコンテンツ、暴力的コンテンツ、またはアダルトコンテンツが含まれるスパム

URL の送信

URL を送信するには、HTTP POST リクエストを projects.uris.submit メソッドに送信します。

Submission API は、リクエストごとに 1 つの URL をサポートします。複数の URL を確認するには、URL ごとに別々のリクエストを送信する必要があります。
URL は有効である必要がありますが、正規化する必要はありません。詳細については、RFC 2396 をご覧ください。
HTTP POST レスポンスは long-running operation を返します。送信結果の取得方法と送信のステータスの確認方法について詳しくは、長時間実行オペレーションをご覧ください。

例

HTTP メソッドと URL:

POST https://webrisk.googleapis.com/v1/projects/project-id/uris:submit

リクエストの本文（JSON）:

{
  "submission": {
    "uri": "https://www.example.com/login.html"
  }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://webrisk.googleapis.com/v1/projects/project-id/uris:submit"

PowerShell

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://webrisk.googleapis.com/v1/projects/project-id/uris:submit" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/project-number/operations/operation-id",
}

送信ステータスを確認する

送信のステータスを確認するには、レスポンスの project-number と operation-id の値を使用します。

SUCCEEDED: 送信された URL がセーフブラウジングブロックリストに追加されたことを示します。

CLOSED: 送信された URL がセーフブラウジングポリシーの違反として検出されず、直近の24 時間以内にセーフブラウジングブロックリストに追加されなかったことを示します。

Submission API の使用

始める前に

ベスト プラクティス

セーフ ブラウジング ポリシーを確認する

URL の送信

例

curl

PowerShell

送信ステータスを確認する

ベストプラクティス

セーフブラウジングポリシーを確認する