Method: files.annotate

Dienst, der für einen Batch von Dateien Bilderkennung und -annotation ausführt. Aktuell 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 (in AnnotateFileRequest.pages können Kunden angeben welche genau). 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 Anrufen festlegen.

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: 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.