Inicio rápido

En esta página se muestra cómo realizar una petición de la API Cloud Video Intelligence con curl.

Antes de empezar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En GCP Console, en la página de selección de proyecto, selecciona o crea un proyecto de GCP.

    Ir a la página de selección de proyecto

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita lasCloud Video IntelligenceAPI.

    Habilita lasAPI

  5. Configurar la autenticación
    1. En GCP Console, ve a la página Crear clave de la cuenta de servicio.

      Ir a la página Crear clave de la cuenta de servicio
    2. En la lista Cuenta de servicio, selecciona Cuenta de servicio nueva.
    3. Ingresa un nombre en el campo Nombre de cuenta de servicio.
    4. No selecciones un valor de la lista Función. No se necesita una función para acceder a este servicio.
    5. Haz clic en Crear. Aparece una nota que advierte que esta cuenta de servicio no tiene función.
    6. Haz clic en Crear sin función. Se descargará un archivo JSON a tu computadora que contiene tus descargas de claves.
  6. Configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS con la ruta de acceso al archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a tu sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable.

  7. Instala e inicializa el SDK de Cloud.
  8. Obtén un token de autorización:
    gcloud auth application-default print-access-token

Realizar una petición de vídeo de anotación

  1. Crea un archivo de petición JSON con el siguiente texto y guárdalo como request.json:

    {
       "inputUri":"gs://cloud-ml-sandbox/video/chicago.mp4",
       "features": [
           "LABEL_DETECTION"
       ]
    }
    
  2. Usa curl para realizar una petición videos:annotate y envíale el token de acceso que imprimiste y el nombre de archivo de la petición de la entidad:

    curl -s -H 'Content-Type: application/json' \
        -H 'Authorization: Bearer ACCESS_TOKEN' \
        'https://videointelligence.googleapis.com/v1/videos:annotate' \
        -d @request.json
    

    La API Video Intelligence crea una operación para procesar la petición. La respuesta incluye el nombre de la operación:

    {
      "name": "us-west1.18358601230245040268"
    }
    
  3. Puedes solicitar información sobre la operación si llamas al punto final v1.operations y envías el valor del name de la operación:

    curl -s -H 'Content-Type: application/json' \
        -H 'Authorization: Bearer ACCESS_TOKEN' \
        'https://videointelligence.googleapis.com/v1/operations/OPERATION_NAME'
    

    Verás información relacionada con la operación. Si la operación se completó, se incluye un campo done y se establece en true:

    {
      "name": "OPERATION_NAME",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.videointelligence.v1.Annota
    tionProgressMetadata",
        "progressMetadata": [
          {
            "inputUri": "gs://cloud-ml-sandbox/video/chicago.mp4",
            "startTime": "2016-09-22T21:41:56.766091Z",
            "lastUpdateTime": "2016-09-22T21:42:03.889743Z"
          }
        ]
      },
      ...
    }
    
  4. Después de proporcionar algo de tiempo a la petición (aproximadamente un minuto, por lo general), la misma petición devuelve los resultados de la anotación:

    {
      "name": "OPERATION_NAME",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress",
        "annotationProgress": [
          {
            "inputUri": "/cloud-ml-sandbox/video/chicago.mp4",
            "progressPercent": 100,
            "startTime": "2017-02-17T22:39:00.333942Z",
            "updateTime": "2017-02-17T22:39:11.414399Z"
          }
        ]
      },
      "done": true,
      "response": {
        "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse",
        "annotationResults": [
          {
            "inputUri": "/cloud-ml-sandbox/video/chicago.mp4",
            "segmentLabelAnnotations": [
              {
                "entity": {
                  "entityId": "/m/01yrx",
                  "languageCode": "en-US"
                },
                "segments": [
                  {
                    "segment": {
                      "startTimeOffset": "0s",
                      "endTimeOffset": "14.833664s"
                    },
                    "confidence": 0.98509187
                  }
                ]
              },
             ...
    

¡Enhorabuena! Has enviado tu primera petición a la API Cloud Video Intelligence.

Limpieza

Si quieres evitar costes innecesarios de Google Cloud Platform, usa la consola de GCP para eliminar el proyecto si no lo necesitas.

Siguientes pasos