Aufgabe „Übersetzen – Dokument“

Mit der Aufgabe Übersetzen – Dokument können Sie eine einzelne Dokumentdatei mit Cloud Translation in Echtzeit (synchron) übersetzen. Sie können formatierte Dokumente wie PDF und DOCX direkt übersetzen und dabei die ursprüngliche Formatierung und das Layout beibehalten. Informationen zu den unterstützten Dateiformaten für die Dokumentübersetzung finden Sie unter Unterstützte Dateiformate.

Cloud Translation ist ein Google Cloud-Dienst, mit dem Sie Text für mehr als 100 Sprachpaaren übersetzen können, wobei sich die Ausgangssprache automatisch erkennen lässt. Eine Liste aller unterstützten Sprachen finden Sie unter Unterstützte Sprachen.

Hinweis

Führen Sie folgende Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie die Aufgabe Übersetzen – Dokument konfigurieren:

  1. Cloud Translation API aktivieren (translate.googleapis.com).

    Cloud Translation API aktivieren

  2. Authentifizierungsprofil erstellen. Apigee Integration verwendet ein Authentifizierungsprofil, um eine Verbindung zu einem Authentifizierungsendpunkt für die Aufgabe Übersetzen – Dokument herzustellen.

    Informationen zum Zuweisen zusätzlicher Rollen oder Berechtigungen für ein Dienstkonto finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

Aufgabe „Übersetzen – Dokument“ konfigurieren

  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
    3. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

  4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Aufgaben, um die Liste der verfügbaren Aufgaben aufzurufen.
  5. Klicken Sie auf das Element Übersetzen – Dokument und platzieren Sie es im Integrationsdesigner.
  6. Klicken Sie im Designer auf das Element Übersetzen – Dokument, um den Aufgabenkonfigurationsbereich Übersetzen – Dokument aufzurufen.
  7. Rufen Sie die Authentifizierung auf und wählen Sie ein vorhandenes Authentifizierungsprofil aus, das Sie verwenden möchten.

    Optional. Wenn Sie vor der Konfiguration der Aufgabe kein Authentifizierungsprofil erstellt haben, klicken Sie auf + Neues Authentifizierungsprofil und folgen Sie der Anleitung unter Neues Authentifizierungsprofil erstellen.

  8. Wechseln Sie zu Aufgabeneingabe und konfigurieren Sie die angezeigten Eingabefelder mit der folgenden Tabelle Aufgabeneingabeparameter.

    Änderungen an den Eingabefeldern werden automatisch gespeichert.

Aufgabeneingabeparameter

In der folgenden Tabelle werden die Eingabeparameter der Aufgabe Übersetzen – Dokument beschrieben:

Attribut Datentyp Beschreibung
Region String Region, in der Sie den Übersetzungsvorgang ausführen möchten. Beispiel: us-central1.
ProjectsId String Ihre Google Cloud-Projekt-ID.
Anfrage JSON Siehe JSON-Struktur von Anfragen. Sie müssen das Feld mimeType der JSON-Anfrage für Inline-Dokumentübersetzungen angeben.

Aufgabenausgabe

Die Aufgabe Übersetzen – Dokument gibt das übersetzte Dokument zurück, ähnlich der folgenden Beispielausgabe: 

{
    "documentTranslation": {
        "byteStreamOutputs": ["BYTE_STREAM"],
        "mimeType": "MIME_TYPE"
    },
    "model": "projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt"
}

Unterstützte Dateiformate

Cloud Translation unterstützt die folgenden Eingabedateitypen und die zugehörigen Ausgabedateitypen. Informationen zu den Größenbeschränkungen für Dokumentdateien finden Sie unter Größenbeschränkungen für Dokumentdateien.

Eingaben MIME-Typ für das Dokument Ausgabe
DOC application/msword DOC, DOCX
DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document DOCX
PDF application/pdf PDF, DOCX
PPT application/vnd.ms-powerpoint PPT, PPTX
PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation PPTX
XLS application/vnd.ms-excel XLS, XLSX
XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet XLSX

Größenbeschränkungen für Dokumentdateien

File type Größenbeschränkungen
PDF Bis zu 20 MB
Native PDF

(Das Feld isTranslateNativePdfOnly muss auf true gesetzt sein.)

Bis zu 20 MB mit einem Limit von 300 Seiten
Scanned PDF Bis zu 20 MB mit einem Limit von 20 Seiten
Andere Dateitypen Bis zu 20 MB ohne Seitenbeschränkung

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.

Nächste Schritte

  1. Edges und Edge-Bedingungen hinzufügen
  2. Integration testen und veröffentlichen
  3. Trigger konfigurieren
  4. Aufgabe „Datenabgleich“ hinzufügen
  5. Alle Aufgaben für Google Cloud-Dienste ansehen