Method: files.annotate

Servizio che esegue il rilevamento e l'annotazione delle immagini per un batch di file. Ora sono supportati solo "application/pdf", "image/tiff" e "image/gif".

Questo servizio estrae al massimo i primi 10 fotogrammi (GIF) o pagine (PDF o TIFF) da ogni file fornito ed esegue il rilevamento e l'annotazione per ogni immagine estratta.

Richiesta HTTP

POST https://alpha-vision.googleapis.com/v1/files:annotate

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requests": [
    {
      object(AnnotateFileRequest)
    }
  ]
}
Campi
requests[]

object(AnnotateFileRequest)

L'elenco delle richieste di annotazione dei file. Al momento supportiamo solo una richiesta AnnotateFileRequest in BatchAnnotateFilesRequest.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Un elenco di risposte alle annotazioni dei file.

Rappresentazione JSON 
{
  "responses": [
    {
      object(AnnotateFileResponse)
    }
  ]
}
Campi
responses[]

object(AnnotateFileResponse)

L'elenco delle risposte di annotazione dei file, ciascuna risposta corrispondente a ogni AnnotateFileRequest in BatchAnnotateFilesRequest.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Per saperne di più, consulta Panoramica dell'autenticazione.

AnnotateFileRequest

Una richiesta di annotazione di un singolo file, ad esempio un file PDF, TIFF o GIF.

Rappresentazione JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "pages": [
    number
  ]
}
Campi
inputConfig

object(InputConfig)

Obbligatorio. Informazioni sul file di input.

features[]

object(Feature)

Obbligatorio. Funzionalità richieste.

imageContext

object(ImageContext)

Contesto aggiuntivo che può accompagnare le immagini nel file.

pages[]

number

Pagine del file su cui eseguire l'annotazione delle immagini.

Le pagine iniziano da 1, quindi la prima pagina del file è la pagina 1. Per richiesta sono supportate al massimo 5 pagine. Le pagine possono essere negative.

Pagina 1 indica la prima pagina. Pagina 2 indica la seconda pagina. La pagina -1 indica l'ultima pagina. La pagina -2 indica la penultima pagina.

Se il file è GIF anziché PDF o TIFF, la pagina si riferisce ai frame GIF.

Se questo campo è vuoto, per impostazione predefinita il servizio esegue l'annotazione delle immagini per le prime 5 pagine del file.

AnnotateFileResponse

Risposta a una singola richiesta di annotazione del file. Un file può contenere una o più immagini, ognuna con le proprie risposte.

Rappresentazione JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "responses": [
    {
      object(AnnotateImageResponse)
    }
  ]
}
Campi
inputConfig

object(InputConfig)

Informazioni sul file per cui viene generata questa risposta.

responses[]

object(AnnotateImageResponse)

Singole risposte alle immagini trovate all'interno del file.

Prova