Method: files.asyncBatchAnnotate

Führen Sie die asynchrone Bilderkennung und -annotation für eine Liste allgemeiner Dateien aus, z. B. PDF-Dateien, die mehrere Seiten und mehrere Bilder pro Seite enthalten können. Fortschritt und Ergebnisse können über die google.longrunning.Operations-Schnittstelle abgerufen werden. Operation.metadata enthält OperationMetadata (Metadaten). Operation.response enthält AsyncBatchAnnotateFilesResponse (Ergebnisse).

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object(AsyncAnnotateFileRequest)
    }
  ]
}
Felder
requests[]

object(AsyncAnnotateFileRequest)

Individuelle asynchrone Dateiannotationsanfragen für diesen Batch.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

AsyncAnnotateFileRequest

Eine Anfrage für eine Offline-Dateiannotation.

JSON-Darstellung 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
Felder
inputConfig

object(InputConfig)

Erforderlich. Informationen zur Eingabedatei.

features[]

object(Feature)

Erforderlich. Die angeforderten Funktionen

imageContext

object(ImageContext)

Zusätzlicher Kontext, der gegebenenfalls die Bilder in der Datei enthält

outputConfig

object(OutputConfig)

Erforderlich. Der gewünschte Speicherort und die gewünschten Metadaten der Ausgabe (z. B. Format).

InputConfig

Der gewünschte Eingabeort und die Metadaten.

JSON-Darstellung 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
Felder
gcsSource

object(GcsSource)

Der Google Cloud Storage-Speicherort, aus dem die Eingabe gelesen werden soll.

mimeType

string

Der Typ der Datei. Im Moment werden nur „application/pdf“ und „image/tiff“ unterstützt. Platzhalter werden nicht unterstützt.

GcsSource

Der Google Cloud Storage-Speicherort, aus dem die Eingabe gelesen wird.

JSON-Darstellung 
{
  "uri": string
}
Felder
uri

string

Google Cloud Storage-URI für die Eingabedatei. Dies muss nur ein Google Cloud Storage-Objekt sein. Platzhalter werden derzeit nicht unterstützt.

OutputConfig

Der gewünschte Ausgabeort und die gewünschten Metadaten.

JSON-Darstellung 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
Felder
gcsDestination

object(GcsDestination)

Der Google Cloud Storage-Speicherort, an den die Ausgaben geschrieben werden.

batchSize

number

Die maximale Anzahl von Antwort-Protos, die in jede JSON-Ausgabedatei in Google Cloud Storage eingefügt werden. Der gültige Bereich ist [1, 100]. Wenn keine Angabe erfolgt, beträgt der Standardwert 20.

Bei einer PDF-Datei mit 100 Seiten werden beispielsweise 100 Antwort-Proto-Dateien generiert. Bei batchSize = 20 werden 5 JSON-Dateien mit 20 Antwort-Proto-Dateien unter dem Präfix gcsDestination geschrieben.uri

Derzeit gilt batchSize nur für GcsDestination und bietet möglicherweise Unterstützung für andere Ausgabekonfigurationen.

GcsDestination

Der Google Cloud Storage-Speicherort, in den die Ausgabe geschrieben wird.

JSON-Darstellung 
{
  "uri": string
}
Felder
uri

string

Der Google Cloud Storage-URI, unter dem die Ergebnisse gespeichert werden. Die Ergebnisse haben das JSON-Format und als Präfix den zugehörigen Eingabe-URI. Dieses Feld kann entweder eine einzelne Datei oder ein Präfix für mehrere Ausgaben darstellen. Präfixe müssen mit / enden.

Beispiele:

Bei mehreren Ausgaben enthält jede Antwort immer noch AnnotateFileResponse, die jeweils einen Teil der vollständigen Liste von AnnotateImageResponse enthält. Mehrere Ausgaben können auftreten, wenn die JSON-Ausgabe beispielsweise zu groß ist und in mehrere fragmentierte Dateien überläuft.