インストール

パッケージは、availablepypi.org にあり、経由でインストールできます。pip次のコマンドを実行します。

pip install groupdocs-translation-cloud

クラウド ドキュメントを翻訳するための Python SDK

GroupDocs.Translation CloudWord (RTF および TXT ファイルを含む)、Excel (CSV / TSV ファイルを含む)、PowerPoint、PDF、HTML、Markdown (Hugo 構文による Markdown を含む)、OpenDocument、RESX、SRT ファイル、JPG、PNG、SVG、BMP、GIF 形式の画像、スキャンされた PDF、プレーン テキストを翻訳するためのクラウド API です。

Python の顧客の利便性を考慮して、わずか数行のコードで上記のすべてのドキュメントおよび画像ファイル形式とプレーン テキストの翻訳をアプリに追加するのに役立つシンプルな SDK を紹介します。

詳細には、これはクラウドでのドキュメントとプレーンテキストの翻訳のための SDK のセットです。 .doc、.docx、.docm、.xls、.xlsx、.xlsm、.ppt、.pptx、.pptm、.pdf、.html、.md、.odt、.ods、.odp、.csv、.tsv、.rtf、.txt、.resx、.srt、.png、の翻訳をサポートします。 .jpg、.svg、.bmp、.gif ファイル。特定のファイルまたはテキストを GroupDocs.Translation Cloud API に渡すだけで、翻訳されたファイルが S3 に翻訳されて保存されるか、翻訳されたテキストが返されます。

GroupDocs.Translation Cloud は簡単に始めることができ、インストールするものは何もありません。 GroupDocs Cloud でアカウントを作成し、アプリケーション情報を取得すると、SDK を使用する準備が整います。

クラウドドキュメント翻訳機能

• Microsoft Word®、Microsoft Excel®、Microsoft PowerPoint®ドキュメントの翻訳 -46 languages and 140 languages pairs support- Word文書およびODTファイルの表、ヘッダー、フッター、脚注/文末脚注、画像キャプションの翻訳
• ExcelドキュメントおよびODSファイルのセル、チャート、テーブル、ピボットテーブルの翻訳
• PowerPoint プレゼンテーションおよび ODP ファイル内のテキスト フレーム、表、ヘッダー、フッター、グラフ、コメントの翻訳
• PDFファイルの翻訳
• Markdown ファイルの翻訳
• Markdown ファイル内の Hugo 構文の翻訳
• プレーンテキストの翻訳
• RESX形式の.NETリソースの翻訳
• SRT形式の字幕の翻訳
• 画像およびスキャンされた PDF を翻訳すると、結果としてプレーン テキストまたは PDF が得られます
• 結果として Excel ワークブックを取得するスキャンされたテーブルの翻訳
• 手書きテキストの翻訳

サポートされている翻訳形式

リクエストの本文に適切な列挙値を入れて、翻訳するドキュメントの形式を指定する必要があります。

さらに、ユーザーは、変換可能な他の形式で翻訳済みファイルを取得することもできます。リクエストの本文にファイル拡張子を入れて、翻訳されたドキュメントの出力形式を指定するだけです。

• doc、docx、odt、rtf — docx、rtf、html、odt、txt、md、pdf、tiff、svg、xps
• xls、xlsx、ods、csv、tsv — xlsx、xlsb、html、pdf、xps、ods、md、docx、pptx、tiff
• ppt、pptx、odp — pptx、pdf、tiff、html、xps、odp
• pdf — docx、pptx、html、svg、xps
• md — html、pdf、docx、tiff、xps
• html — md、pdf、docx、tiff、xps

ぜひご覧くださいSupported Formats詳細については。

サポートされている翻訳言語

• en-fr / fr-en — to translate from English to French or from French to English.
• en-de / de-en — to translate from English to German or from German to English.
• en-es / es-en — to translate from English to Spanish or from Spanish to English.
• en-it / it-en — to translate from English to Italian or from Italian to English.
• en-zh / zh-en — to translate from English to Chinese or from Chinese to English.
• en-ru / ru-en — to translate from English to Russian or from Russian to English
• en-ar / ar-en — to translate from English to Arabic or from Arabic to English
• en-pt / pt-en — to translate from English to Portuguese or from Portuguese to English
• en-pl / pl-en — to translate from English to Polish or from Polish to English
• en-uk / uk-en — to translate from English to Ukrainian or from Ukrainian to English
• en-vi / vi-en — to translate from English to Vietnamese or from Vietnamese to English
• en-id / id-en — to translate from English to Indonesian or from Indonesian to English
• en-hi / hi-en — to translate from English to Hindi or from Hindi to English
• en-el / el-en — to translate from English to Greek or from Greek to English
• en-nl / nl-en— to translate from English to Dutch or from Dutch to English
• en-hu / hu-en — to translate from English to Hunngarian or from Hungarian to English
• en-sv / sv-en — to translate from English to Swedish or from Swedish to English
• en-tr / tr-en — to translate from English to Turkish or from Turkish to English
• en-ja / ja-en — to translate from English to Japanese or from Japanese to English
• en-ko / ko-en — to translate from English to Korean or from Korean to English
• en-cs / cs-en — to translate from English to Czech or from Czech to English
• en-fi / fi-en — to translate from English to Finnish or from Finnish to English
• en-ga / ga-en — to translate from English to Irish or from Irish to English
• en-fa / fa-en — to translate from English to Farsi or from Farsi to English
• en-az / az-en — to translate from English to Azerbaijani or from Azerbaijani to English
• en-he / he-en — to translate from English to Hebrew or from Hebrew to English
• en-sk / sk-en — to translate from English to Slovak or from Slovak to English
• en-th / th-en — to translate from English to Thai or from Thai to English
• en-ro / ro-en — to translate from English to Romanian or from Romanian to English
• en-ms / ms-en — to translate from English to Malay or from Malay to English
• en-bg / bg-en — to translate from English to Bulgarian or from Bulgarian to English
• en-bn / bn-en — to translate from English to Bengali or from Bengali to English
• en-da / da-en — to translate from English to Danish or from Danish to English
• en-lt / lt-en — to translate from English to Lithuanian or from Lithuanian to English
• en-lv / lv-en — to translate from English to Latvian or from Latvian to English
• en-no / no-en — to translate from English to Norwegian or from Norwegian to English
• en-et / et-en — to translate from English to Estonian or from Estonian to English
• en-hy / hy-en — to translate from English to Armenian or from Armenian to English
• en-ca / ca-en — to translate from English to Catalan or from Catalan to English
• en-hr / hr-en — to translate from English to Croatian or from Croatian to English
• en-sr / sr-en — to translate from English to Serbian or from Serbian to English
• en-af / af-en — to translate from English to Afrikaans or from Afrikaans to English
• en-ur / ur-en — to translate from English to Urdu or from Urdu to English
• en-tl / tl-en — to translate from English to Tagalog or from Tagalog to English
• en-ka / ka-en — to translate from English to Georgian or from Georgian to English
• fr-de / de-fr — to translate from French to German or from German to French
• fr-it / it-fr — to translate from French to Italian or from Italian to French
• fr-ar / ar-fr — to translate from French to Arabic or from Arabic to French
• fr-es / es-fr — to translate from French to Spanish or from Spanish to French
• fr-id / id-fr — to translate from French to Indonesian or from Indonesian to French
• fr-ms / ms-fr — to translate from French to Malay or from Malay to French
• fr-pl / pl-fr — to translate from French to Polish or from Polish to French
• fr-ru / ru-fr — to translate from French to Russian or from Russian to French
• fr-ar / ar-fr — to translate from French to Arabic or from Arabic to French
• de-it / it-de — to translate from German to Italian or from Italian to German
• de-pl / pl-de — to translate from German to Polish or from Polish to German
• de-ar / ar-de — to translate from German to Arabic or from Arabic to German
• de-zh / zh-de — to translate from German to Chinese or from Chinese to German
• de-es / es-de — to translate from German to Spanish or from Spanish to German
• de-ms / ms-de — to translate from German to Malay or from Malay to German
• de-uk / uk-de — to translate from German to Ukrainian or from Ukrainian to German
• it-es / es-it — to translate from Italian to Spanish or from Spanish to Italian
• it-ar / ar-it — to translate from Italian to Arabic or from Arabic to Italian
• it-uk / uk-it — to translate from Italian to Ukrainian or from Ukrainian to Italian
• it-ms / ms-it — to translate from Italian to Malay or from Malay to Italian
• sv-zh / zh-sv — to translate from Swedish to Chinese or from Chinese to Swedish
• ar-es / es-ar — to translate from Arabic to Spanish or from Spaish to Arabic
• ar-tr / tr-ar — to translate from Arabic to Turkish or from Turkish to Arabic
• ar-pl / pl-ar — to translate from Arabic to Polish or from Polish to Arabic
• ru-es / es-ru — to translate from Russian to Spanish or from Spaish to Russian

JSON リクエストの詳細

リクエスト本文に次の情報を入力してドキュメントを翻訳できます。

• format — 翻訳用ファイルの形式
• outputFormat — 翻訳されたファイルの形式 (例: pdf)
• sourceLanguage — 元のドキュメントの言語 (例: en)
• targetLanguages — リストとしての翻訳言語 (例: [fr, de])
• file — バイト配列の形式で変換するファイル
• url — 翻訳するファイルへのリンク。ファイルまたは URL を指定する必要があります。
• originalFileName — null または空のリクエスト ID が使用される場合、翻訳するファイルの元の名前
• マスター — マスター スライドを翻訳する必要があるかどうか (プレゼンテーションの場合のみ、true または false を渡します)
• 要素 — 翻訳するスライド ページ (プレゼンテーションの場合のみ、プレゼンテーション全体を翻訳するには空のリストを渡します)
• separator — CSV ファイルの区切り文字
• 範囲 - Excel ワークブックの範囲の辞書
• shortcodedict — 翻訳する Hugo のショート コード構文の辞書。キーは 0 から始まるショート コード インデックス、値は翻訳が必要なパラメータ名のリストです。
• frontmatterdict — 翻訳する Hugo の前付構文の辞書。キーは 0 から始まる前付インデックス、値は翻訳が必要な値へのパスのリストで、各パスもリストです。

プレーンテキストを翻訳するには、次の情報をリクエスト本文に含める必要があります。

• sourceLanguage — 元のテキストの言語 (例: en)
• targetLanguages — リストとしての翻訳言語 (例: [fr, de])
• texts — 翻訳するテキストのリスト (例: [hello world])
• contains-markdown — テキストにマークダウン構文が含まれる場合は true

SDK の使用方法は?

当社の API は、オペレーティング システム、データベース システム、開発言語から完全に独立しています。 HTTP をサポートする任意の言語とプラットフォームを使用して、API と対話できます。ただし、クライアント コードを手動で記述するのは難しく、エラーが発生しやすく、時間がかかる場合があります。したがって、私たちは提供し、サポートしていますSDKs多くの開発言語で提供されており、クラウド アプリとの統合が容易になります。

クイックスタート

1. まだ API キーを取得していない場合は取得します

で個人アカウントを作成しますGroupDocs Cloud Dashboard[キーを取得] をクリックします。これらのキーは、すべての GroupDocs Cloud 製品に役立ちます。困ったことがあったらこれを見てくださいdetailed manual。 Once your keys are received, please follow thisarticleGroupDocs.Translation Cloud を試すか、よく理解するDeveloper guide詳細については。

2. SDK をインストールする

インストールgroupdocs-translation-cloudとPIPからPyPI by:

pip install groupdocs-translation-cloud

または、リポジトリのクローンを作成して、次のようにインストールします。Setuptools:

python setup.py install

3. デモの実行

• SDK をチェックアウトするか、PiPy から取得します
  • クライアント_id とクライアント_シークレットを設定します
  • Jupyter Notebook を実行するdemo.ipynb

構造

このプロジェクトには以下が含まれます:

• モジュール「groupdocstranslationcloud」、これは SDK です。アプリケーションに統合できます。翻訳 API とストレージ API の両方が含まれています
• モジュール「テスト」、単体テスト。これらを参照して、さまざまなコード例を確認してください。
• Jupyter ノートブックの「デモ」。サンプルのデモノートブック。

依存関係

• 要件.txt を参照してください。

バージョンのサポート

Python :: 2.7, Python :: 3, Python :: 3.4, Python :: 3.5, Python :: 3.6, Python :: 3.7, Python :: 3.8

プレーンテキストを翻訳する

# Load the gem
import groupdocs_translation_cloud
# Get Client Id and Client Secret from https://dashboard.groupdocs.cloud
my_client_id = ""
my_client_secret = ""

# Create instance of the API
configuration = Configuration(apiKey=my_client_secret, appSid=my_client_id)
api = TranslationApi(configuration)

#document translation
pair = "en-fr"
_format = "docx"
storage = "First Storage"
name = "test.docx"
folder = ""
savepath = ""
savefile = "test_python.docx"  
masters = False
elements = []
translator = TranslateDocument(pair, _format, storage, name, folder, savepath, savefile, masters, elements)
request = translator.to_string()
res_doc = api.post_translate_document(request)
print(res_doc.message)

API エンドポイントのドキュメント

すべての URI は相対的ですhttps://api.groupdocs.cloud/v2.0/translation

クラス |         |方法 | HTTPリクエスト |説明 ———— |-| ————- | ————- | ————-TranslationApi|         |autoPost| 役職/auto|サポートされているファイルを翻訳しますTranslationApi|         |csvPost| 役職/csv| CSV および TSV ファイルを翻訳するTranslationApi|         |documentPost| 役職/document| Microsoft Word文書、rtf、txt、odtを翻訳TranslationApi|         |documentRequestIdGet| 得る/document/{requestId}|ドキュメントの翻訳ステータスを返します。 翻訳が成功した場合は、翻訳されたドキュメントをダウンロードするための URL も返します。TranslationApi|         |documentTrialPost| 役職/document/trial| Microsoft Word文書、rtf、txt、odtを会話なしで試し翻訳します。最初のページまたは 1000 個のシンボルのみを翻訳します。TranslationApi|         |hcGet| 得る/hc|すべてのサービスのヘルスチェック。TranslationApi|         |htmlPost| 役職/html| HTML ファイルを翻訳するTranslationApi|         |hugoGet| 得る/hugo|マークダウンファイルからhugo構文構造を取得するTranslationApi|         |hugoPost| 役職/hugo|マークダウンファイルからhugo構文構造解析を実行するTranslationApi|         |imageToFilePost| 役職/image-to-file|画像またはスキャンした PDF を翻訳してファイルを返すTranslationApi|         |imageToTextPost| 役職/image-to-text|画像またはスキャンした PDF 上のテキストを翻訳TranslationApi|         |languagesGet| 得る/languages|利用可能な言語ペアのリストを返すTranslationApi|         |markdownPost| 役職/markdown| Markdown ファイルを翻訳するTranslationApi|         |pdfPost| 役職/pdf| PDFファイルを翻訳するTranslationApi|         |pdfTrialPost| 役職/pdf/trial| PDFの試用版翻訳。他の形式に変換せずに最初のページのみを翻訳します。TranslationApi|         |presentationPost| 役職/presentation| Microsoft PowerPoint プレゼンテーションの翻訳、ODPTranslationApi|         |resxPost| 役職/resx| RESXファイルを翻訳するTranslationApi|         |spreadsheetPost| 役職/spreadsheet| Microsoft Excelワークブックの翻訳、ODSTranslationApi|         |textPost| 役職/text|テキストを翻訳するTranslationApi|         |textRequestIdGet| 得る/text/{requestId}|テキスト翻訳ステータスを返します。 翻訳が成功した場合は、翻訳されたテキストも返しますTranslationApi|         |textTrialPost| 役職/text/trial|テキストを試しに翻訳します。 1000 個のシンボルのみを翻訳します。

モデルのドキュメント

CloudFileResponse, CloudHugoResponse, CloudTextResponse, CsvFileRequest, FileRequest, HealthCheckStatus, HtmlFileRequest, HttpStatusCode, HugoRequest, ImageToFileRequest, ImageToTextRequest, LanguagePairData, MarkdownFileRequest, PdfFileRequest, PresentationFileRequest, ResxFileRequest, SpreadsheetFileRequest, StatusResponse, StringStringTuple, TextDocumentFileRequest, TextRequest, UrlFileInfo, WorksheetData

GroupDocs.Translation クラウド SKD

####GitHub

パッケージマネージャー