Interface WebRiskServiceGrpc.AsyncService (2.20.0)

public static interface WebRiskServiceGrpc.AsyncService

Web Risk API defines an interface to detect malicious URLs on your website and in client applications.

Methods

computeThreatListDiff(ComputeThreatListDiffRequest request, StreamObserver<ComputeThreatListDiffResponse> responseObserver)

public default void computeThreatListDiff(ComputeThreatListDiffRequest request, StreamObserver<ComputeThreatListDiffResponse> responseObserver)

Gets the most recent threat list diffs. These diffs should be applied to a local database of hashes to keep it up-to-date. If the local database is empty or excessively out-of-date, a complete snapshot of the database will be returned. This Method only updates a single ThreatList at a time. To update multiple ThreatList databases, this method needs to be called once for each list.

Parameters
NameDescription
requestComputeThreatListDiffRequest
responseObserverio.grpc.stub.StreamObserver<ComputeThreatListDiffResponse>

createSubmission(CreateSubmissionRequest request, StreamObserver<Submission> responseObserver)

public default void createSubmission(CreateSubmissionRequest request, StreamObserver<Submission> responseObserver)

Creates a Submission of a URI suspected of containing phishing content to be reviewed. If the result verifies the existence of malicious phishing 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.

Parameters
NameDescription
requestCreateSubmissionRequest
responseObserverio.grpc.stub.StreamObserver<Submission>

searchHashes(SearchHashesRequest request, StreamObserver<SearchHashesResponse> responseObserver)

public default void searchHashes(SearchHashesRequest request, StreamObserver<SearchHashesResponse> responseObserver)

Gets the full hashes that match the requested hash prefix. This is used after a hash prefix is looked up in a threatList and there is a match. The client side threatList only holds partial hashes so the client must query this method to determine if there is a full hash match of a threat.

Parameters
NameDescription
requestSearchHashesRequest
responseObserverio.grpc.stub.StreamObserver<SearchHashesResponse>

searchUris(SearchUrisRequest request, StreamObserver<SearchUrisResponse> responseObserver)

public default void searchUris(SearchUrisRequest request, StreamObserver<SearchUrisResponse> responseObserver)

This method is used to check whether a URI is on a given threatList. Multiple threatLists may be searched in a single query. The response will list all requested threatLists the URI was found to match. If the URI is not found on any of the requested ThreatList an empty response will be returned.

Parameters
NameDescription
requestSearchUrisRequest
responseObserverio.grpc.stub.StreamObserver<SearchUrisResponse>

submitUri(SubmitUriRequest request, StreamObserver<Operation> responseObserver)

public default void submitUri(SubmitUriRequest request, StreamObserver<Operation> responseObserver)

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.

Parameters
NameDescription
requestSubmitUriRequest
responseObserverio.grpc.stub.StreamObserver<Operation>