Method: files.annotate

Dienst, der für einen Batch von Dateien Bilderkennung und -annotation ausführt. Jetzt werden nur „application/pdf“, „image/tiff“ und „image/gif“ unterstützt.

Dieser Dienst extrahiert maximal die ersten zehn Frames (gif) oder Seiten (PDF oder TIFF) aus jeder bereitgestellten Datei und führt für jedes extrahierte Bild eine Erkennung und Annotation durch.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object(AnnotateFileRequest)

Die Liste der Annotationsanfragen Derzeit unterstützen wir in BatchAnnotateFilesRequest nur eine AnnotateFileRequest.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Eine Liste von Antworten zu Dateiannotationen.

JSON-Darstellung 
{
  "responses": [
    {
      object(AnnotateFileResponse)
    }
  ]
}
Felder
responses[]

object(AnnotateFileResponse)

Die Liste der Antworten zur Dateiannotation, wobei jede Antwort für jede AnnotateFileRequest in BatchAnnotateFilesRequest entspricht.

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.

AnnotateFileRequest

Eine Anfrage zum Annotieren einer einzelnen Datei, z. B. einer PDF-, TIFF- oder GIF-Datei.

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

pages[]

number

Seiten der Datei, für die die Bildannotation ausgeführt werden soll.

Die Seiten beginnen bei 1. Wir gehen davon aus, dass die erste Seite der Datei Seite 1 ist. Pro Anfrage werden maximal 5 Seiten unterstützt. Seiten können negativ sein.

Seite 1 steht für die erste Seite. Seite 2 steht für die zweite Seite. Seite -1 steht für die letzte Seite. Seite 2 steht für die vorletzte Seite.

Wenn die Datei anstelle von PDF oder TIFF das GIF-Format hat, bezieht sich die Seite auf GIF-Frames.

Wenn dieses Feld leer ist, führt der Dienst standardmäßig eine Bildannotation für die ersten fünf Seiten der Datei aus.

AnnotateFileResponse

Antwort auf eine einzelne Dateiannotationsanfrage. Eine Datei kann ein oder mehrere Bilder enthalten, die jeweils eigene Antworten haben.

JSON-Darstellung 
{
  "inputConfig": {
    object(InputConfig)
  },
  "responses": [
    {
      object(AnnotateImageResponse)
    }
  ]
}
Felder
inputConfig

object(InputConfig)

Informationen zur Datei, für die diese Antwort generiert wird.

responses[]

object(AnnotateImageResponse)

Einzelne Antworten auf Bilder in der Datei.

Testen!