If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.
If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.
Установка
Пакет доступен на pypi.org и его можно установить через pip, выполнив следующую команду:
pip install groupdocs-translation-cloud
Python SDK для перевода облачных документов
GroupDocs.Translation Cloud — это облачный API для перевода Word (включая файлы RTF и TXT), Excel (включая файлы CSV/TSV), PowerPoint, PDF, HTML, Markdown (включая Markdown с синтаксисом Hugo), файлов OpenDocument, RESX, SRT, изображений в форматах JPG, PNG, SVG, BMP и GIF, а также отсканированных PDF-файлов, а также обычного текста.
Для удобства наших клиентов 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. Просто передайте определенный файл или текст в Cloud API GroupDocs.Translation, и он переведет и сохранит переведенный файл в S3 или вернет переведенный текст.
Начать работу с GroupDocs.Translation Cloud легко и не нужно ничего устанавливать. Создайте учетную запись в GroupDocs Cloud и получите информацию о своем приложении, после чего вы будете готовы использовать SDK.
Возможности перевода облачных документов
- Перевод документов Microsoft Word®, Microsoft Excel® и Microsoft PowerPoint®
- Поддержка 46 языков и 140 языковых пар
- Перевод таблиц, верхних и нижних колонтитулов, сносок/концевых сносок, подписей к изображениям в документах Word и файлах ODT.
- Перевод ячеек, диаграмм, таблиц, сводных таблиц в документах Excel и файлах ODS
- Перевод текстовых фреймов, таблиц, верхних и нижних колонтитулов, диаграмм, комментариев в презентациях PowerPoint и файлах ODP.
- Перевод PDF-файлов
- Перевод файлов Markdown
- Перевод синтаксиса Hugo в файлах Markdown
- Перевод обычного текста
- Перевод ресурсов .NET формата RESX
- Перевод субтитров в формат SRT
- Перевод изображений и отсканированных PDF-файлов с получением в результате обычного текста или PDF-файла.
- Перевод отсканированных таблиц с получением в результате книги Excel
- Перевод рукописного текста
Поддерживаемые форматы перевода
Вам следует указать формат документа для перевода, поместив в тело запроса соответствующее значение перечисления.
Кроме того, пользователь может получить переведенный файл в любой другой формат, доступный для конвертации. Просто укажите выходной формат переведенного документа, указав расширение файла в теле запроса:
- док, 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
Подробную информацию можно найти на странице Поддерживаемые форматы.
Поддерживаемые языки перевода
- 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 of file for translation
- выходной формат — format of translated file (e.g. pdf)
- исходный язык — language of original document (e.g. en)
- целевые языки — languages of translation as list (e.g. [fr, de])
- файл — file to translate in form of array of bytes
- ссылка — link to file to translate, either file or url should be provided
- оригинальноеИмяФайла — original name of file to translate, if null or empty request id will be used
- мастера — if masters slides should be translated (only for presentations, pass true or false)
- элементы — slide pages to translate (only for presentations, pass empty list to translate whole presentation)
- разделитель — delimiter for CSV files
- диапазоны - dictionary of ranges in Excel workbook
- короткий код — dictionary of short code syntax in Hugo to translate, where the key is zero based short code index, and value is a list of parameters names that require translation
- frontmatterdict — dictionary of front matter syntax in Hugo to translate, where the key is zero based front matter index and value is list of paths to values that require translation, each path is also a list.
Для перевода обычного текста в тело запроса необходимо поместить следующую информацию:
- исходный язык — language of original text (e.g. en)
- целевые языки — languages of translation as list (e.g. [fr, de])
- тексты — list of texts to translate (e.g. [hello world])
- содержит уценку — true if text contains markdown syntax
Как использовать SDK?
Наш API полностью независим от вашей операционной системы, системы баз данных или языка разработки. Вы можете использовать любой язык и платформу, поддерживающие HTTP, для взаимодействия с нашим API. Однако написание клиентского кода вручную может быть трудным, чреватым ошибками и отнимающим много времени. Поэтому мы предоставили и поддерживаем SDK на многих языках разработки, чтобы упростить интеграцию ваших облачных приложений с нами.
Быстрый старт
1. Получите ключи API, если у вас его еще нет.
Создайте личную учетную запись на GroupDocs Cloud Dashboard и нажмите Получить ключи. Эти ключи полезны для всех продуктов GroupDocs Cloud. Если у вас возникли проблемы, просмотрите это подробное руководство. После получения ключей следуйте этой статье, чтобы попробовать GroupDocs.Translation Cloud, или ознакомьтесь с руководством для разработчиков для получения более подробной информации.
2. Установите SDK
Установите groupdocs-translation-cloud с помощью PIP из PyPI следующим образом:
pip install groupdocs-translation-cloud
Или клонируйте репозиторий и установите его через Setuptools:
3. Запустите демо-версию
- Ознакомьтесь с SDK или получите от PiPy.
- Установите свой client_id и client_secret
- Запустите Jupyter Notebook demo.ipynb.
Структура
Этот проект включает в себя:
- Модуль «groupdocstranslationcloud», это SDK. Вы можете интегрировать его в свое приложение. Он содержит API перевода и хранения.
- Модуль «тест», unittests. Вы можете взглянуть на них, чтобы увидеть различные примеры кода.
- Блокнот Jupyter «демо». Образец демонстрационного блокнота.
Зависимости
Поддержка версий
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.
| Class | | Method | HTTP request | Description |
|---|
TranslationApi | | autoPost | POST /auto | Translate any supported file |
TranslationApi | | csvPost | POST /csv | Translate CSV and TSV files |
TranslationApi | | documentPost | POST /document | Translate Microsoft Word documents, rtf, txt, odt |
TranslationApi | | documentRequestIdGet | GET /document/{requestId} | Return document translation status. Also return URLs for downloading of translated document if translation was successful |
TranslationApi | | documentTrialPost | POST /document/trial | Trial translate Microsoft Word documents, rtf, txt, odt without conversation. Translate only first page or 1000 symbols. |
TranslationApi | | hcGet | GET /hc | Health check for all services. |
TranslationApi | | htmlPost | POST /html | Translate HTML files |
TranslationApi | | hugoGet | GET /hugo | Get hugo syntax structure from markdown file |
TranslationApi | | hugoPost | POST /hugo | Run hugo syntax structure analyzing from markdown file |
TranslationApi | | imageToFilePost | POST /image-to-file | Translate image or scanned pdf and return file |
TranslationApi | | imageToTextPost | POST /image-to-text | Translate text on image or scanned pdf |
TranslationApi | | languagesGet | GET /languages | Return list of available language pairs |
TranslationApi | | markdownPost | POST /markdown | Translate Markdown files |
TranslationApi | | pdfPost | POST /pdf | Translate pdf files |
TranslationApi | | pdfTrialPost | POST /pdf/trial | Trial pdf translation. Translate only first page without conversion to another format. |
TranslationApi | | presentationPost | POST /presentation | Translate Microsoft PowerPoint presentations, odp |
TranslationApi | | resxPost | POST /resx | Translate RESX files |
TranslationApi | | spreadsheetPost | POST /spreadsheet | Translate Microsoft Excel workbooks, ods |
TranslationApi | | textPost | POST /text | Translate text |
TranslationApi | | textRequestIdGet | GET /text/{requestId} | Return text translation status. Also return translated text if translation was successful |
TranslationApi | | textTrialPost | POST /text/trial | Trial translate text. Translate only 1000 symbols. |
Documentation for Models
CloudFileResponse, CloudHugoResponse, CloudTextResponse, CsvFileRequest, FileRequest, HealthCheckStatus, HtmlFileRequest, HttpStatusCode, HugoRequest, ImageToFileRequest, ImageToTextRequest, LanguagePairData, MarkdownFileRequest, PdfFileRequest, PresentationFileRequest, ResxFileRequest, SpreadsheetFileRequest, StatusResponse, StringStringTuple, TextDocumentFileRequest, TextRequest, UrlFileInfo, WorksheetData
GroupDocs.Облачные SKD-переводы
GitHub
Менеджер пакетов
