今日は、Word および Excel ドキュメントを他の言語に翻訳できる翻訳 REST API について検討します。 GroupDocs.Translation Cloud を使用すると、あらゆる文書を英語から中国語、フランス語、ドイツ語、イタリア語、ロシア語、またはスペイン語に、またはその逆に翻訳できます。したがって、翻訳を実行できる言語ペアは次のとおりです。
- 英語から中国語、中国語から英語
- 英語からフランス語、フランス語から英語
- 英語からドイツ語、ドイツ語から英語
- 英語からイタリア語、イタリア語から英語
- 英語からロシア語、ロシア語から英語
- 英語からスペイン語、スペイン語から英語
翻訳中、API は段落、表、ヘッダーを処理します。 Word 処理ドキュメントのフッター、脚注、文末脚注、さらには画像キャプションまで。 Excel スプレッドシートの場合、セル、グラフ、テーブル、およびピボット テーブルもサポートされています。
REST APIを使用してWordまたはExcelドキュメントを翻訳する方法
この記事では、REST API を使用して Word または Excel 文書を翻訳する流れを説明します。従うべき手順は次のとおりです。
- 翻訳するドキュメントをアップロード
- [ドキュメントをさまざまな言語で翻訳する](https://blog.groupdocs.cloud/ja/translation/translate-word-excel-documents-with-rest-api/#translate-word-excel-to-other- language)
- 翻訳されたドキュメントをダウンロードする
翻訳する文書をアップロード
ダッシュボード を使用するか、API の Swagger UI を使用して、クラウド ストレージにファイルをアップロードします。両方のオプションを使用してクラウドにアップロードする方法を説明します。
ダッシュボードを使用してファイルをアップロードする
ダッシュボード を使用して、ドキュメントをクラウドに直接アップロードできます。必要なのは、サーバー上にアカウントを作成することだけです。 [ファイルをアップロード] ボタンをクリックして、アップロードするドキュメントを選択するだけです。
Swagger UI を使用してファイルをアップロードする
もう 1 つのオプションは、Swagger UI を使用して、この リンク から翻訳用のドキュメントをアップロードすることです。
アップロードが成功した後のサーバーからの応答は次のとおりです。
{
"uploaded": \[
"document.docx"
\],
"errors": \[\]
}
REST API を使用して Word または Excel ドキュメントをさまざまな言語に翻訳する
単純な cURL コマンドを使用して、アップロードしたドキュメントを翻訳できます。ここでは Word 文書を英語からフランス語に翻訳しています。ファイル document.docx は、MyStorage の下の myFolder に以前にアップロードされました。翻訳されたドキュメントを同じフォルダー、つまり myFolder に translationDoc.docx として保存するつもりです。
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\\" }\]'"
文書を英語からフランス語に翻訳したかったので、このペアを「en-fr」として使用しました。必要に応じて、次の中から関連するペアを使用できます。
文書ファイル形式には「docx」を使用しました。ソースの Word 文書または Excel スプレッドシートに応じて、以下から使用できます。
translate への API リファレンスの Swagger UI を使用する場合は、翻訳リクエストに必要な値を指定してコマンドを実行するだけです。
どこからでも cURL コマンドを実行した場合でも、Swagger UI を使用した場合でも、変換が成功した後のサーバーからの応答は次のとおりです。翻訳されたファイルは、出力として前述のフォルダーに保存されます。
{
"error": "",
"status": "ok",
"message": "word file saved successfully"
}
翻訳されたドキュメントをダウンロードする
翻訳されたドキュメントはクラウドストレージから簡単にダウンロードできます。次の cURL コマンド Swagger UI を使用するか、ダッシュボードを使用してファイルをダウンロードできます。
cURLでダウンロード
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"
Swagger UI を使用してダウンロードする
Swagger UI for download では、翻訳されたダウンロードのダウンロード リンクが提供されます。リンクをクリックして、ファイルを目的の場所に保存できます。
ダッシュボードを使用してダウンロードする
ダッシュボード ではファイルを選択し、[ダウンロード] ボタンを使用してファイルをダウンロードできます。
API の詳細については、ドキュメント または「もっと話しましょう」@ 無料サポート フォーラム からご覧いただけます。