Operaciones de larga duración

Algunos métodos de la API Video Intelligence devuelven una operación de larga duración. Estos métodos son asíncronos y es posible que la operación no se complete cuando el método devuelva una respuesta.

Obtener el estado de una operación

Puedes consultar el estado de una tarea de larga duración (detección de cambios de plano) con el nombre de la operación.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • OPERATION_NAME: el campo name devuelto por la llamada a la API Video Intelligence. Es un valor con el formato
    projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID,
    donde:
    • PROJECT_NUMBER es el número de tu proyecto Google Cloud .
    • LOCATION_ID es la región en la nube en la que se ha realizado la anotación (por ejemplo, us-east1, us-west1, europe-west1 o asia-east1).
    • OPERATION_ID es el ID de la operación de larga duración.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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 una operación

Puedes cancelar una operación de larga duración mediante el ID de la operación. Sin embargo, no se garantiza que la cancelación se complete correctamente.

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • OPERATION_ID: se proporciona en la respuesta cuando iniciaste la operación.
    Por ejemplo: 3326639765503758657 de projects/754177431483/locations/us-west1/operations/3326639765503758657
  • Nota:
    • PROJECT_NUMBER: tu ID de proyecto de GCP
    • LOCATION_ID: la región de Cloud en la que se debe realizar la anotación. Las regiones de nube admitidas son us-east1, us-west1, europe-west1 y asia-east1. Si no se especifica ninguna, se determinará una región en función de la ubicación del archivo de vídeo.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.