Übersetzen Sie Word oder Excel Dokumente mit der REST-API

Heute beschäftigen wir uns mit der Übersetzungs-REST-API, die Word und Excel Dokumente in andere Sprachen übersetzen kann. Mit GroupDocs.Translation Cloud kann jedes Dokument vom Englischen ins Chinesische, Französische, Deutsche, Italienische, Russische oder Spanische und umgekehrt übersetzt werden. Hier sind also die Sprachpaare, in denen die Übersetzung erfolgen kann.

• Englisch nach Chinesisch und Chinesisch nach Englisch
• Englisch nach Französisch und Französisch nach Englisch
• Englisch nach Deutsch und Deutsch nach Englisch
• Englisch nach Italienisch und Italienisch nach Englisch
• Englisch nach Russisch und Russisch nach Englisch
• Englisch nach Spanisch und Spanisch nach Englisch

Beim Übersetzen kümmert sich die API um Absätze, Tabellen und Überschriften. Fußzeilen, Fußnoten, Endnoten und sogar Bildunterschriften Ihrer Textverarbeitungsdokumente. Für die Excel-Tabellen werden Zellen, Diagramme, Tabellen und auch Pivot-Tabellen unterstützt.

So übersetzen Sie Word oder Excel Dokumente mit der REST-API

Dieser Artikel führt Sie durch den Ablauf zum Übersetzen der Word oder Excel Dokumente mithilfe der REST-API. Hier sind die Schritte, die Sie befolgen müssen:

1. Laden Sie das zu übersetzende Dokument hoch
2. Übersetzen Sie das Dokument in verschiedene Sprachen
3. Laden Sie das übersetzte Dokument herunter

Laden Sie das zu übersetzende Dokument hoch

Laden Sie Ihre Datei über das Dashboard oder die Swagger-Benutzeroberfläche für die API in den Cloud-Speicher hoch. Ich zeige Ihnen, wie Sie mit beiden Optionen in die Cloud hochladen.

Laden Sie Ihre Datei über das Dashboard hoch

Sie können Ihr Dokument über das Dashboard direkt in die Cloud hochladen. Sie müssen lediglich ein Konto auf dem Server erstellen. Klicken Sie einfach auf die Schaltfläche „Datei hochladen“ und wählen Sie Ihr hochzuladendes Dokument aus.

Laden Sie Ihre Datei mit der Swagger-Benutzeroberfläche hoch

Die andere Möglichkeit besteht darin, die Swagger-Benutzeroberfläche zu verwenden, um Ihr Dokument zur Übersetzung über diesen Link hochzuladen.

Nach dem erfolgreichen Upload folgt die Antwort des Servers.

{
  "uploaded": \[
    "document.docx"
  \],
  "errors": \[\]
}

Übersetzen Sie Word oder Excel Dokumente mit der REST-API in verschiedene Sprachen

Mit dem einfachen cURL-Befehl können Sie Ihr hochgeladenes Dokument übersetzen. Hier übersetze ich das Word Dokument vom Englischen ins Französische. Die Datei document.docx wurde zuvor in „myFolder“ unter „MyStorage“ hochgeladen. Ich beabsichtige, das übersetzte Dokument als „translatedDoc.docx“ im selben Ordner, z. B. myFolder, zu speichern.

curl -X POST "https://api.groupdocs.cloud/v1.0/translation/runTranslationTask" \\
-H "accept: application/json" \\
-H "authorization: Bearer TOKEN" \\
-H "Content-Type: application/json" \\
-H "x-aspose-client: Containerize.Swagger" \\
-d "'\[ { \\"format\\":\\"docx\\", \\"pair\\":\\"en-fr\\", \\"name\\":\\"document.docx\\", \\"folder\\":\\"myFolder\\", \\"savepath\\":\\"myFolder\\", \\"savefile\\":\\"translatedDoc.docx\\", \\"storage\\":\\"MyStorage\\" }\]'"

Ich wollte ein Dokument vom Englischen ins Französische übersetzen, also habe ich das Paar „en-fr“ verwendet. Sie können das entsprechende Paar entsprechend Ihrem Bedarf aus den folgenden verwenden:

Als Dokumentdateiformat habe ich „docx“ verwendet. Sie können entsprechend Ihrem Word-Quelldokument oder Ihrer Excel-Tabelle Folgendes verwenden:

Wenn Sie die Swagger-Benutzeroberfläche der API-Referenz für übersetzen verwenden möchten, können Sie einfach die erforderlichen Werte in der Übersetzungsanforderung angeben und den Befehl ausführen.

Unabhängig davon, ob Sie den cURL-Befehl von irgendwo aus ausgeführt haben oder die Swagger-Benutzeroberfläche verwenden, folgt in beiden Fällen die Antwort des Servers nach erfolgreicher Übersetzung. Die übersetzte Datei wird als Ausgabe im genannten Ordner gespeichert.

{
    "error": "",
    "status": "ok",
    "message": "word file saved successfully"
}

Laden Sie das übersetzte Dokument herunter

Das übersetzte Dokument kann einfach aus dem Cloud-Speicher heruntergeladen werden. Sie können den folgenden cURL-Befehl verwenden, Swagger UI, oder das Dashboard verwenden, um die Datei herunterzuladen.

Mit cURL herunterladen

curl -X GET "https://api.groupdocs.cloud/v1.0/translation/storage/file/myFolder%5CtranslatedDoc.docx?storageName=MyStorage&versionId=VsBZptoyKpehpqmUCsjuoA6jVBGsXk4B" \\
-H "accept: multipart/form-data" \\
-H "authorization: Bearer TOKEN" \\
-H "x-aspose-client: Containerize.Swagger"

Herunterladen über die Swagger-Benutzeroberfläche

Swagger UI zum Download stellt Ihnen den Download-Link des übersetzten Downloads zur Verfügung. Sie können auf den Link klicken und die Datei am gewünschten Ort speichern.

Über das Dashboard herunterladen

Über das Dashboard können Sie die Datei(en) auswählen und diese dann über die Schaltfläche „Herunterladen“ herunterladen.

Weitere Informationen zur API finden Sie in der Dokumentation oder im „Let’s talk more“ im Kostenlosen Support-Forum.