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

HTTP-Anfrage

POST https://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)
    }
  ],
  "parent": string
}
Felder
requests[]

object (AnnotateFileRequest)

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

parent

string

Optional. Zielprojekt und Standort zum Aufrufen.

Format: projects/{project-id}/locations/{location-id}.

Wenn kein übergeordnetes Element angegeben ist, wird automatisch eine Region ausgewählt.

Unterstützte Standort-IDs: us: nur USA, asia: Ostasien, z. B. Japan, Taiwan, eu: die Europäische Union.

Beispiel: projects/project-A/locations/eu.

Antworttext

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

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.