Operações de longa duração

Alguns métodos da API Dialogflow retornam uma operação de longa duração. Esses métodos são assíncronos e a operação pode não ser concluída quando o método retornar uma resposta. Verifique o status ou cancele operações.

Receber status de operação

Veja a seguir como pesquisar o status de uma operação. Se você tiver muitas operações para verificar, limite as chamadas ou use o método list.

REST e LINHA DE CMD

Chame o método get para o tipo Operations.

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

• project-id: ID do projeto do GCP
• operation-id: ID da operação
• api-version: é v2 ou v2beta1

Método HTTP e URL:

GET https://dialogflow.googleapis.com/api-version/projects/my-gcp-project/operations/operation-id

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

curl (Linux, macOS ou Cloud Shell)

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

Execute o comando a seguir:

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://dialogflow.googleapis.com/api-version/projects/my-gcp-project/operations/operation-id

PowerShell (Windows)

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

Execute o comando a seguir:

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

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://dialogflow.googleapis.com/api-version/projects/my-gcp-project/operations/operation-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/project-id/operations/some-operation-name-operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.dialogflow.api-version.SomeOperationType",
    "state": "DONE"
  },
  "done": true,
  ...
}

Quando a operação for concluída, um valor state de SUCCESSFUL será retornado.

Listar e cancelar operações

Além de obter uma operação específica, é possível listar e cancelar operações. Veja os métodos list e cancel para o tipo Operations.

É possível que os resultados list contenham operações não relacionadas à sua tarefa atual. Portanto, filtre os resultados.