Operações de longa duração

Alguns métodos da API Video Intelligence devolvem uma operação de longa duração. Estes métodos são assíncronos e a operação pode não estar concluída quando o método devolve uma resposta.

Obtenha o estado de uma operação

Pode verificar o estado de uma tarefa de longa duração (detetar alterações de planos) usando o nome da operação.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • OPERATION_NAME: o campo name devolvido da chamada para a Video Intelligence API. Este é um valor no formato:
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID,
    onde:
    • PROJECT_NUMBER é o número do seu Google Cloud projeto,
    • LOCATION_ID é a região da nuvem onde a anotação ocorreu (por exemplo: us-east1, us-west1, europe-west1, asia-east1),
    • OPERATION_ID é o ID da operação de longa duração.

Método HTTP e URL: 

GET https://videointelligence.googleapis.com/v1/OPERATION_NAME

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress",
    "annotationProgress": [
      {
        "inputUri": "INPUT_URI",
        "progressPercent": 100,
        "startTime": "2020-05-12T19:36:09.110351Z",
        "updateTime": "2020-05-12T19:36:17.519069Z"
      }
    ]
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse",
    "annotationResults": [
      {
        ...
      }
    ]
  }
}

Cancele uma operação

Pode cancelar uma operação de longa duração através do ID da operação. No entanto, o cancelamento não tem garantia de sucesso.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • OPERATION_ID: fornecido na resposta quando iniciou a operação,
    por exemplo 3326639765503758657 de projects/754177431483/locations/us-west1/operations/3326639765503758657
  • Nota:
    • PROJECT_NUMBER: o ID do seu projeto da GCP
    • LOCATION_ID: a região da nuvem onde a anotação deve ocorrer. As regiões da nuvem suportadas são: us-east1, us-west1, europe-west1 e asia-east1. Se não for especificada nenhuma região, é determinada uma região com base na localização do ficheiro de vídeo.

Método HTTP e URL: 

POST https://videointelligence.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID:cancel

Para enviar o seu pedido, expanda uma destas opções:

Deve receber um código de estado de êxito (2xx) e uma resposta vazia.