Como usar a API Submission v2

Visão geral

Com a API Submission, você pode enviar URLs que você acredita não serem seguros para o Navegação segura e analisá-los de maneira assíncrona. Todos os URLs confirmados para corresponder às Políticas de navegação segura serão adicionados ao serviço Navegação segura.

Antes de começar

Entre em contato com a equipe de vendas ou com o engenheiro de clientes para ter acesso a esse recurso.

Como enviar URLs

Para enviar um URL, envie uma solicitação HTTP POST ao método projects.uris.submit.

  • A API Submission é compatível com um URL por solicitação. Para verificar vários URLs, você precisa enviar uma solicitação separada para cada URL.
  • O URL precisa ser válido (consulte RFC 2396), mas não precisa ser canônico.
  • A resposta HTTP POST retorna um long-running operation. Para mais informações sobre como recuperar o resultado do envio, consulte Long-running operations.

Exemplo

Método HTTP e URL:

POST "https://webrisk.googleapis.com/v1/projects/project-id/uris:submit"

Corpo JSON da solicitação:

{
  "submission": {
    "uri": "https://www.phishingsite.com/",
  },
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
""https://webrisk.googleapis.com/v1/projects/project-id/uris:submit""

PowerShell

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri ""https://webrisk.googleapis.com/v1/projects/project-id/uris:submit"" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/project-id/operations/operation-id",
}