Method: files.asyncBatchAnnotate

Esegui il rilevamento e l'annotazione asincroni delle immagini per un elenco di file generici, ad esempio file PDF, che possono contenere più pagine e più immagini per pagina. L'avanzamento e i risultati possono essere recuperati tramite l'interfaccia google.longrunning.Operations. Operation.metadata contiene OperationMetadata (metadati). Operation.response contiene AsyncBatchAnnotateFilesResponse (risultati).

Richiesta HTTP

POST https://vision.googleapis.com/v1p3beta1/files:asyncBatchAnnotate

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(AsyncAnnotateFileRequest)
    }
  ]
}
Campi
requests[]

object(AsyncAnnotateFileRequest)

Richieste di annotazione file asincrone singole per questo batch.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

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.

AsyncAnnotateFileRequest

Una richiesta di annotazione di file offline.

Rappresentazione JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
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.

outputConfig

object(OutputConfig)

Obbligatorio. La posizione di output e i metadati desiderati (ad es. il formato).

InputConfig

La posizione di input e i metadati desiderati.

Rappresentazione JSON 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
Campi
gcsSource

object(GcsSource)

La posizione di Google Cloud Storage da cui leggere l'input.

mimeType

string

Il tipo di file. Al momento sono supportati solo "application/pdf" e "image/tiff". I caratteri jolly non sono supportati.

GcsSource

La posizione di Google Cloud Storage da cui verrà letto l'input.

Rappresentazione JSON 
{
  "uri": string
}
Campi
uri

string

URI Google Cloud Storage per il file di input. Deve essere solo un oggetto Google Cloud Storage. I caratteri jolly non sono attualmente supportati.

OutputConfig

La posizione di output e i metadati desiderati.

Rappresentazione JSON 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
Campi
gcsDestination

object(GcsDestination)

La posizione di Google Cloud Storage in cui scrivere gli output.

batchSize

number

Il numero massimo di proto di risposta da inserire in ogni file JSON di output su Google Cloud Storage. L'intervallo valido è [1, 100]. Se non specificato, il valore predefinito è 20.

Ad esempio, per un file PDF con 100 pagine verranno generati 100 proto di risposta. Se batchSize = 20, verranno scritti 5 file JSON contenenti ciascuno 20 proto di risposta con il prefisso gcsDestination.uri.

Al momento, batchSize si applica solo a GcsDestination, con un potenziale supporto futuro per altre configurazioni di output.

GcsDestination

La posizione di Google Cloud Storage in cui verrà scritto l'output.

Rappresentazione JSON 
{
  "uri": string
}
Campi
uri

string

URI Google Cloud Storage in cui verranno archiviati i risultati. I risultati saranno in formato JSON e preceduti dall'URI di input corrispondente. Questo campo può rappresentare un singolo file o un prefisso per più output. I prefissi devono terminare con /.

Esempi:

Se sono presenti più output, ogni risposta è ancora AnnotateFileResponse, ciascuna delle quali contiene un sottoinsieme dell'elenco completo di AnnotateImageResponse. Possono verificarsi più output se, ad esempio, l'output JSON è troppo grande e si verifica un overflow in più file suddivisi in parti.