Using the Submission API

Early access

This feature is covered by the Pre-GA Offerings Terms of the Google Cloud Platform Terms of Service. Pre-GA features may have limited support, and changes to pre-GA features may not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

Overview

The Submission API lets you submit URLs that you suspect are unsafe to Safe Browsing for analysis. Any URLs that are confirmed to match the Safe Browsing Policies will be added to the Safe Browsing service.

Before you begin

Please contact Sales or your Customer Engineer in order to obtain access to this feature.

Submitting URLs

To submit a URL, send an HTTP POST request to the projects.submissions.create method.

Example

HTTP method and URL:

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

Request JSON body:

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

To send your request, choose one of these options:

curl

Note: Ensure you have set the GOOGLE_APPLICATION_CREDENTIALS environment variable to your service account private key file path.

Save the request body in a file called request.json, and execute the following command:

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

Note: Ensure you have set the GOOGLE_APPLICATION_CREDENTIALS environment variable to your service account private key file path.

Save the request body in a file called request.json, and execute the following command:

$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

You should receive a JSON response similar to the following:

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