Method: projects.uris.submit

Stay organized with collections Save and categorize content based on your preferences.

Submits a URI suspected of containing malicious content to be reviewed. Returns a google.longrunning.Operation which, once the review is complete, is updated with its result. You can use the Pub/Sub API to receive notifications for the returned Operation. If the result verifies the existence of malicious content, the site will be added to the Google's Social Engineering lists in order to protect users that could get exposed to this threat in the future. Only allowlisted projects can use this method during Early Access. Please reach out to Sales or your customer engineer to obtain access.

HTTP request

POST https://webrisk.googleapis.com/v1/{parent=projects/*}/uris:submit

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The name of the project that is making the submission. This string is in the format "projects/{project_number}".

Request body

The request body contains data with the following structure:

JSON representation 
{
  "submission": {
    object (Submission)
  }
}
Fields
submission

object (Submission)

Required. The submission that contains the URI to be scanned.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Submission

Wraps a URI that might be displaying malicious content.

JSON representation 
{
  "uri": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Fields
uri

string

Required. The URI that is being reported for malicious content to be analyzed.
threatTypes[]

enum (ThreatType)

ThreatTypes found to be associated with the submitted URI after reviewing it. This might be empty if the URI was not added to any list.