Method: urls.search

Busca URLs que coincidan con amenazas conocidas. Se verifica cada URL y sus expresiones de sufijo de host y prefijo de ruta (hasta una profundidad limitada). Esto significa que la respuesta puede contener URLs que no se incluyeron en la solicitud, pero que son expresiones de las URLs solicitadas.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
urls[]

string

Obligatorio. Son las URLs que se buscarán. Los clientes NO DEBEN enviar más de 50 URLs.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta que se devuelve después de buscar amenazas que coincidan con las URLs especificadas.

Si no se encuentra nada, el servidor devolverá un estado OK (código de estado HTTP 200) con el campo threats vacío, en lugar de devolver un estado NOT_FOUND (código de estado HTTP 404).

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Campos
threats[]

object (ThreatUrl)

Lista sin ordenar. Es la lista no ordenada de coincidencias de amenazas encontradas. Cada entrada contiene una URL y los tipos de amenazas que se encontraron que coinciden con esa URL. El tamaño de la lista puede ser mayor que la cantidad de URLs en la solicitud, ya que se habrán considerado todas las expresiones de la URL.
cacheDuration

string (Duration format)

Es la duración de la caché del cliente. El cliente DEBE agregar esta duración a la hora actual para determinar la hora de vencimiento. Luego, la hora de vencimiento se aplica a cada URL que consulta el cliente en la solicitud, independientemente de cuántas URLs se muestren en la respuesta. Incluso si el servidor no devuelve coincidencias para una URL en particular, el cliente TAMBIÉN DEBE almacenar en caché este hecho.

Si el campo threats está vacío, el cliente PUEDE aumentar el valor de cacheDuration para determinar una nueva fecha de vencimiento posterior a la especificada por el servidor. En cualquier caso, la duración de la caché aumentada no debe ser superior a 24 horas.

Importante: El cliente NO DEBE suponer que el servidor devolverá la misma duración de caché para todas las respuestas. El servidor PUEDE elegir diferentes duraciones de caché para diferentes respuestas según la situación.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

ThreatUrl

Es una URL que coincide con una o más amenazas.

Representación JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Campos
url

string

Es la URL solicitada que coincidió con una o más amenazas.
threatTypes[]

enum (ThreatType)

Lista sin ordenar. Es la lista no ordenada de amenazas según las cuales se clasifica la URL.