Method: projects.uris.submit

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.