Operações de longa duração

Alguns métodos da API Video Intelligence 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.

Receber status de operação

Você pode verificar o status de uma tarefa de longa duração (como detectar alterações na imagem) usando o nome da operação.

REST

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

  • OPERATION_NAME: o campo name retornado da chamada para a API Video Intelligence. Este é um valor no formato:
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID,
    em que:
    • PROJECT_NUMBER é o número do seu projeto do Google Cloud;
    • LOCATION_ID é a região da nuvem em que 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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "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": [
      {
        ...
      }
    ]
  }
}

Cancelar uma operação

Você pode cancelar uma operação de longa duração usando o ID da operação. No entanto, não há garantia de que a operação será realmente cancelada.

REST

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

  • OPERATION_ID: fornecido na resposta quando você iniciou a operação,
    por exemplo, 3326639765503758657 do projects/754177431483/locations/us-west1/operations/3326639765503758657.
  • Observação:
    • PROJECT_NUMBER: código do projeto do GCP.
    • LOCATION_ID: a região do Cloud em que a anotação deve ocorrer. As regiões de nuvem compatíveis são: us-east1, us-west1, europe-west1 e asia-east1. Se nenhuma região for especificada, uma região será determinada com base na localização do arquivo 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 a solicitação, expanda uma destas opções:

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.