Submission API の使用

概要

Submission API を使用すると、セーフ ブラウジングで安全でないと思われる URL を分析のために送信できます。セーフ ブラウジング ポリシーに準拠していることが確認された URL はすべて、セーフ ブラウジング サービスに追加されます。

始める前に

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

URL の送信

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

HTTP メソッドと URL:

POST "https://webrisk.googleapis.com/v1/projects/project-id/submissions"

JSON 本文のリクエスト:

{
  "uri": "https://www.phishingsite.com/",
}

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

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/submissions"

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/submissions"" | Select-Object -Expand Content

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

{
  "uri": "https://www.phishingsite.com/",
}