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
doprojects/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
easia-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.