Method: urls.search

搜索与已知威胁匹配的网址。系统会检查每个网址及其主机后缀和路径前缀表达式（深度有限）。这意味着，响应可能包含未包含在请求中但属于所请求网址的表达式的网址。

HTTP 请求

GET https://safebrowsing.googleapis.com/v5alpha1/urls:search

网址采用 gRPC 转码语法。

查询参数

参数
urls[]

string

必需。要查找的网址。客户端不得发送超过 50 个网址。

请求正文

请求正文必须为空。

响应正文

搜索与指定网址匹配的威胁后返回的响应。

如果未找到任何内容，服务器将返回“确定”状态（HTTP 状态代码 200），但 threats 字段为空，而不是返回“未找到”状态（HTTP 状态代码 404）。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
字段
threats[]

object (ThreatUrl)

无序列表。找到的威胁匹配项的无序列表。每个条目都包含一个网址以及与该网址匹配的威胁类型。列表大小可能大于请求中的网址数量，因为系统会考虑网址的所有表达式。
cacheDuration

string (Duration format)

客户端缓存时长。客户端必须将此时长添加到当前时间，以确定过期时间。然后，过期时间会应用于客户端在请求中查询的每个网址，无论响应中返回了多少个网址。即使服务器未针对特定网址返回任何匹配项，客户端也必须缓存此事实。

当且仅当字段 threats 为空时，客户端可以增加 cacheDuration 以确定比服务器指定的时间更晚的新过期时间。在任何情况下，增加后的缓存时长都不得超过 24 小时。

重要提示：客户端不得假定服务器会针对所有响应返回相同的缓存时长。服务器可能会根据具体情况为不同的响应选择不同的缓存时长。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

ThreatUrl

与一种或多种威胁相匹配的网址。

JSON 表示法 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
字段
url

string

与一个或多个威胁相匹配的所请求网址。
threatTypes[]

enum (ThreatType)

无序列表。相应网址被归类为的威胁的无序列表。