Annota un video utilizzando la riga di comando

Annota un video utilizzando la riga di comando

Questa pagina mostra come effettuare una richiesta API Video Intelligence con curl per i progetti di tua proprietà.

Puoi seguire i passaggi in questa pagina o provare questa guida rapida come lab Formazione Google Cloud.

Provalo con un lab

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API richiesta.

   Abilita l'API

5. Crea un account di servizio:

   1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
   2. Seleziona il progetto.

   3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

   4. Fai clic su Crea e continua.

   5. Fai clic su Fine per completare la creazione dell'account di servizio.

      Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

6. Crea una chiave dell'account di servizio:

   1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
   2. Fai clic su Chiavi.
   3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
   4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
   5. Fai clic su Chiudi.

7. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile.

   Esempio: Linux o macOS

   export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

   Ad esempio:

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   Esempio: Windows

   Per PowerShell:

   $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

   Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

   Ad esempio:

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

   Per il prompt dei comandi:

   set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

   Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

8. Installa Google Cloud CLI.

9. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

10. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

    Vai al selettore progetti

11. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

12. Attiva l'API richiesta.

    Abilita l'API

13. Crea un account di servizio:

    1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

       Vai a Crea account di servizio
    2. Seleziona il progetto.

    3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

       Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

    4. Fai clic su Crea e continua.

    5. Fai clic su Fine per completare la creazione dell'account di servizio.

       Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.

14. Crea una chiave dell'account di servizio:

    1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
    2. Fai clic su Chiavi.
    3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
    4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.
    5. Fai clic su Chiudi.

15. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile.

    Esempio: Linux o macOS

    export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

    Ad esempio:

    export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

    Esempio: Windows

    Per PowerShell:

    $env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

    Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

    Ad esempio:

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

    Per il prompt dei comandi:

    set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

    Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

16. Installa Google Cloud CLI.

17. Per initialize gcloud CLI, esegui questo comando:

    gcloud init

Effettua una richiesta di annotazione video

gcloud

Usa gcloud CLI per chiamare il comando detect-labels sul percorso del video da analizzare.

gcloud ml video detect-labels gs://YOUR_BUCKET/YOUR_OBJECT

Riga di comando

1. Utilizza curl per effettuare una richiesta POST al metodo videos:annotate, utilizzando il comando gcloud auth application-default print-access-token per incollare un token di accesso nel tuo account di servizio:

   curl -X POST \
     -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{"inputUri":"gs://YOUR_BUCKET/YOUR_OBJECT","features":["LABEL_DETECTION"]}'\
     "https://videointelligence.googleapis.com/v1/videos:annotate"
   

2. L'API Video Intelligence crea un'operazione per elaborare la richiesta. La risposta include il nome dell'operazione:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID"
   }
   

3. Puoi richiedere informazioni sull'operazione chiamando l'endpoint v1.operations, sostituendo OPERATION_NAME nell'esempio seguente con il nome restituito nel passaggio precedente:

    curl -X GET \
      -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
      https://videointelligence.googleapis.com/v1/OPERATION_NAME
   

4. Vedrai le informazioni relative all'operazione. Se l'operazione è stata completata, viene incluso un campo done e impostato su true:

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
     "metadata": {
     "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress",
       "annotationProgress": [
         {
           "inputUri": "/YOUR_BUCKET/YOUR_OBJECT",
           "progressPercent": 100,
           "startTime": "2020-04-01T22:13:17.978847Z",
           "updateTime": "2020-04-01T22:13:29.576004Z"
         }
       ]
     },
     "done": true,
    ...
   }
   

Dopo aver concesso alla richiesta un po' di tempo (in genere circa un minuto), la stessa richiesta restituisce i risultati dell'annotazione:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress",
    "annotationProgress": [
      {
        "inputUri": "YOUR_BUCKET/YOUR_OBJECT",
        "progressPercent": 100,
        "startTime": "2020-04-01T22:13:17.978847Z",
        "updateTime": "2020-04-01T22:13:29.576004Z"
      }
    ]
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse",
    "annotationResults": [
      {
        "inputUri": "/YOUR_BUCKET/YOUR_OBJECT",
        "segmentLabelAnnotations": [
          {
            "entity": {
              "entityId": "/m/07bsy",
              "description": "transport",
              "languageCode": "en-US"
            },
            "segments": [
              {
                "segment": {
                  "startTimeOffset": "0s",
                  "endTimeOffset": "38.757872s"
                },
                "confidence": 0.81231534
              }
            ]
          },
         {
          "entity": {
              "entityId": "/m/01n32",
              "description": "city",
              "languageCode": "en-US"
            },
            "categoryEntities": [
              {
                "entityId": "/m/043rvww",
                "description": "geographical feature",
                "languageCode": "en-US"
              }
            ],
            "segments": [
              {
                "segment": {
                  "startTimeOffset": "0s",
                  "endTimeOffset": "38.757872s"
                },
                "confidence": 0.3942462
              }
            ]
          },
          ...
          {
            "entity": {
              "entityId": "/m/06gfj",
              "description": "road",
              "languageCode": "en-US"
            },
            "segments": [
              {
                "segment": {
                  "startTimeOffset": "0s",
                  "endTimeOffset": "38.757872s"
                },
                "confidence": 0.86698604
              }
            ]
          }
        ]
      }
    ]
  }
}
   

Complimenti! Hai inviato la tua prima richiesta all'API Video Intelligence.

Esegui la pulizia

Per evitare addebiti Google Cloud non necessari, utilizza la console Google Cloud per eliminare il progetto se non ti serve.

Passaggi successivi

• Consulta le Guide illustrative.
• Esamina Esempi e tutorial.
• Per informazioni complete su tutte le chiamate API, consulta i riferimenti API.