Method: projects.locations.batchTranslateDocument

Übersetzt große Mengen an Dokumenten im asynchronen Batchmodus. Diese Funktion gibt Echtzeitausgabe aus, während die Eingaben verarbeitet werden. Wenn der Aufrufer eine Anfrage abbricht, sind die Teilergebnisse (für eine Eingabedatei ist es alles oder nichts) möglicherweise weiterhin am angegebenen Ausgabespeicherort verfügbar.

Dieser Aufruf wird sofort zurückgegeben und Sie können google.longrunning.Operation.name verwenden, um den Status des Aufrufs abzufragen.

HTTP-Anfrage

POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:batchTranslateDocument

Pfadparameter

Parameter
parent

string

Erforderlich. Standort für einen Anruf.

Format: projects/{project-id}.

Der Standort global wird für die Batchübersetzung nicht unterstützt.

Es können nur Glossare in derselben Region (mit derselben location-id) verwendet werden. Andernfalls wird der Fehler INVALID_ARGUMENT (400) zurückgegeben.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "sourceLanguageCode": string,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
Felder
sourceLanguageCode

string

Erforderlich. Der ISO-639-Sprachcode des Eingabedokuments, sofern bekannt, z. B. „en-US“ oder „sr-Latn“. Die unterstützten Sprachcodes finden Sie unter Unterstützte Sprachen.
targetLanguageCodes[]

string

Erforderlich. Der ISO-639-Sprachcode, der für die Übersetzung des Eingabedokuments verwendet werden soll. Geben Sie hier bis zu 10 Sprachcodes an.
inputConfigs[]

object (BatchDocumentInputConfig)

Erforderlich. Eingabekonfigurationen. Die Gesamtzahl der übereinstimmenden Dateien sollte maximal 100 betragen. Die Gesamtgröße des zu übersetzenden Inhalts darf 100 Millionen Unicode-Codepunkte nicht überschreiten. Die Dateien müssen UTF-8-codiert sein.
outputConfig

object (BatchDocumentOutputConfig)

Erforderlich. Ausgabekonfiguration Wenn zwei Eingabekonfigurationen mit derselben Datei übereinstimmen (d. h. derselbe Eingabepfad), wird keine Ausgabe für doppelte Eingaben generiert.
glossaries

map (key: string, value: object (TranslateTextGlossaryConfig))

Optional. Glossare, die angewendet werden sollen. Die Schlüssel sind die Codes der Zielsprachen.
formatConversions

map (key: string, value: string)

Optional. Die Zuordnung für die Konvertierung des Dateiformats, die auf alle Eingabedateien angewendet wird. Der Kartenschlüssel ist der ursprüngliche MIME-Typ. Der Zuordnungswert ist der Ziel-MIME-Typ übersetzter Dokumente.

Die unterstützte Dateiformatkonvertierung umfasst: - application/pdf zu application/vnd.openxmlformats-officedocument.wordprocessingml.document

Wenn nichts angegeben ist, haben die Ausgabedateien dasselbe Format wie die Originaldatei.
customizedAttribution

string

Optional. Dieses Flag dient zur Unterstützung der benutzerdefinierten Attribution. Wenn keine Angabe erfolgt, lautet der Standardwert Machine Translated by Google. Die benutzerdefinierte Quellenangabe muss den Regeln unter https://cloud.google.com/translate/attribution#attribution_and_logos entsprechen.
enableShadowRemovalNativePdf

boolean

Optional. Wenn „true“ festgelegt ist, wird der Server zum Entfernen von Text verwendet, um den Schattentext auf dem Hintergrundbild für die native PDF-Übersetzung zu entfernen. Die Funktion zum Entfernen von Schatten kann nur aktiviert werden, wenn isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

Optional. Wenn „true“, wird die automatische Korrektur der Drehung in DVS aktiviert.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

BatchDocumentInputConfig

Eingabekonfiguration für die Anfrage „locations.batchTranslateDocument“.

JSON-Darstellung 
{

  // Union field source can be only one of the following:
  "s3_source": {
    object (s3Source)
  }
  // End of list of possible types for union field source.
}
Felder
Union-Feld source. Präzisiert die Eingabe. Für source ist nur einer der folgenden Werte zulässig:
s3_source

object (s3Source)

S3-Bucket-Speicherort für die Quelleingabe. Dies kann eine einzelne Datei oder ein Platzhalter sein.

Der MIME-Typ der Datei wird anhand der Erweiterung bestimmt. Unterstützte MIME-Typen:

  • pdf: application/pdf
  • docx: application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • pptx: application/vnd.openxmlformats-officedocument.presentationml.presentation
  • xlsx: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Die maximale Dateigröße für .docx, .pptx und .xlsx beträgt 100 MB. Die maximale Dateigröße für .pdf beträgt 1 GB und das maximale Seitenlimit 1.000 Seiten. Die maximale Dateigröße für alle Eingabedokumente beträgt 1 GB.

BatchDocumentOutputConfig

Ausgabekonfiguration für die Anfrage „locations.batchTranslateDocument“.

JSON-Darstellung 
{

  // Union field destination can be only one of the following:
  "s3_destination": {
    object (s3Destination)
  }
  // End of list of possible types for union field destination.
}
Felder
Union-Feld destination. Das Ziel der Ausgabe. Das angegebene Zielverzeichnis muss vorhanden und leer sein. Für destination ist nur einer der folgenden Werte zulässig:
s3_destination

object (s3Destination)

S3-Bucket-Ziel für Ausgabedaten. Für jedes einzelne Eingabedokument werden maximal 2 * n Ausgabedateien generiert. Dabei ist n die Anzahl der Zielsprachencodes in BatchTranslateDocumentRequest.

targetLanguageCode wird in der Anfrage angegeben.