Method: urls.search

Pesquisar URLs que correspondam a ameaças conhecidas. Cada URL e suas expressões de sufixo de host e prefixo de caminho (até uma profundidade limitada) são verificados. Isso significa que a resposta pode conter URLs que não foram incluídos na solicitação, mas são expressões dos URLs solicitados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
urls[]

string

Obrigatório. Os URLs a serem pesquisados. Os clientes NÃO PODEM enviar mais de 50 URLs.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A resposta retornada após a pesquisa de ameaças que correspondem aos URLs especificados.

Se nada for encontrado, o servidor vai retornar um status OK (código de status HTTP 200) com o campo threats vazio, em vez de um status NOT_FOUND (código de status HTTP 404).

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Campos
threats[]

object (ThreatUrl)

Lista não ordenada. A lista não ordenada de correspondências de ameaças encontradas. Cada entrada contém um URL e os tipos de ameaças encontradas que correspondem a esse URL. O tamanho da lista pode ser maior que o número de URLs na solicitação, já que todas as expressões do URL foram consideradas.
cacheDuration

string (Duration format)

A duração do cache do lado do cliente. O cliente PRECISA adicionar essa duração ao horário atual para determinar o horário de expiração. O tempo de expiração é aplicado a todos os URLs consultados pelo cliente na solicitação, não importa quantos URLs sejam retornados na resposta. Mesmo que o servidor não retorne correspondências para um URL específico, esse fato também PRECISA ser armazenado em cache pelo cliente.

Se e somente se o campo threats estiver vazio, o cliente poderá aumentar o cacheDuration para determinar uma nova expiração posterior à especificada pelo servidor. Em qualquer caso, o aumento da duração do cache não pode ser superior a 24 horas.

Importante: o cliente NÃO PODE presumir que o servidor vai retornar a mesma duração de cache para todas as respostas. O servidor PODE escolher durações de cache diferentes para respostas diferentes, dependendo da situação.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

ThreatUrl

Um URL que corresponde a uma ou mais ameaças.

Representação JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Campos
url

string

O URL solicitado que foi correspondido por uma ou mais ameaças.
threatTypes[]

enum (ThreatType)

Lista não ordenada. A lista não ordenada de ameaças em que o URL é classificado.