Operações de longa duração

A API Submission é assíncrona e retorna uma operação de longa duração. A operação pode não ser concluída quando o método retornar uma resposta.

Receber status de operação

Veja a seguir como pesquisar o status de uma operação.

Chame o método GET para o tipo de operação.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• project-number: o número do projeto do Google Cloud.
• operation-id: ID da operação

Método HTTP e URL:

GET https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id

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

curl

Observação: verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS no caminho do arquivo de chave privada da conta de serviço.

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id"

PowerShell

Observação: verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS no caminho do arquivo de chave privada da conta de serviço.

execute o seguinte comando:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://webrisk.googleapis.com/v1/projects/project-number/operations/operation-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/project-number/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.webrisk.v1.SubmitUriMetadata",
    "state": "RUNNING"
  }
  "done": false,
  ...
}

Quando a operação é concluída, um dos seguintes valores é retornado para state:

• SUCCEEDED: indica que o URL enviado foi adicionado ao recurso Navegação segura. Lista de bloqueio.

• CLOSED: indica que não foi detectado que o URL enviado viola a políticas de Navegação segura e não foi adicionado à lista de bloqueio da Navegação segura nas últimas 24 horas.