Method: projects.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_GDC_ENDPOINT}/v1/{parent}/files:annotate

Pfadparameter

Parameter
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: die Europäische Union.

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (AnnotateFileRequest)

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

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