Web Risk API . uris

close()

Close httplib2 connections.

search(threatTypes=None, uri=None, x__xgafv=None)

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.

Args:
  threatTypes: string, Required. The ThreatLists to search in. Multiple ThreatLists may be specified. (repeated)
    Allowed values
      THREAT_TYPE_UNSPECIFIED - No entries should match this threat type. This threat type is unused.
      MALWARE - Malware targeting any platform.
      SOCIAL_ENGINEERING - Social engineering targeting any platform.
      UNWANTED_SOFTWARE - Unwanted software targeting any platform.
      SOCIAL_ENGINEERING_EXTENDED_COVERAGE - A list of extended coverage social engineering URIs targeting any platform.
  uri: string, Required. The URI to be checked for matches.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "threat": { # Contains threat information on a matching uri. # The threat list matches. This might be empty if the URI is on no list.
    "expireTime": "A String", # The cache lifetime for the returned match. Clients must not cache this response past this timestamp to avoid false positives.
    "threatTypes": [ # The ThreatList this threat belongs to.
      "A String",
    ],
  },
}