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 5 (i clienti possono specificare quali 5 in AnnotateFileRequest.pages) frame (GIF) o pagine (PDF o TIFF) da ogni file fornito ed esegue il rilevamento e l'annotazione di ogni immagine estratta.

Richiesta HTTP

POST https://vision.googleapis.com/v1p4beta1/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 un 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 all'annotazione dei file.

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

object (AnnotateFileResponse)

L'elenco delle risposte all'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 ulteriori informazioni, consulta la 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 per eseguire l'annotazione delle immagini.

Le pagine iniziano da 1, supponiamo che la prima pagina del file sia la pagina 1. Sono supportate al massimo 5 pagine per richiesta. Le pagine possono essere negative.

Pagina 1 indica la prima pagina. Pagina 2 indica la seconda pagina. Pagina -1 indica l'ultima pagina. 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 richiesta di annotazione di un singolo file. Un file può contenere una o più immagini, che hanno singolarmente le proprie risposte.

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

object (InputConfig)

Informazioni sul file per il quale viene generata questa risposta.

responses[]

object (AnnotateImageResponse)

Singole risposte alle immagini trovate all'interno del file.

totalPages

number

Questo campo indica il numero totale di pagine del file.