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 fünf (Kunden können angeben, welche fünf in AnnotateFileRequest.pages) Frames (gif) oder Seiten (PDF oder TIFF) aus jeder bereitgestellten Datei enthalten sind. Für jedes extrahierte Bild werden Erkennung und Annotation durchgeführt.

HTTP-Anfrage

POST https://vision.googleapis.com/v1p4beta1/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 Anfrageanmerkungsanfragen 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, die eine Bildanmerkung ausführt.

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 bedeutet die letzte Seite. Seite 2 bedeutet, dass die zweite Seite die letzte ist.

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

Wenn dieses Feld leer ist, führt der Dienst standardmäßig eine Bildanmerkung 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)
    }
  ],
  "totalPages": number
}
Felder
inputConfig

object (InputConfig)

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

responses[]

object (AnnotateImageResponse)

Einzelne Antworten auf Bilder in der Datei.

totalPages

number

Dieses Feld gibt die Gesamtzahl der Seiten in der Datei an.