Instalação

O pacote é disponível em pypi.org e pode ser instalado via pip executando o seguinte comando:

pip install groupdocs-translation-cloud

Python SDK para tradução de documentos Cloud

GroupDocs.Translation Cloud é Cloud API para traduzir Word (incluindo arquivos RTF e TXT), Excel (incluindo arquivos CSV / TSV), PowerPoint, PDF, HTML, Markdown (incluindo Markdown com sintaxe Hugo), OpenDocument, RESX, arquivos SRT, imagens de JPG, PNG, SVG, BMP e Formatos GIF e PDFs digitalizados, bem como texto simples. Para conveniência de nossos clientes Python, apresentamos um SDK simples que ajuda a adicionar tradução de todos os formatos de documentos e arquivos de imagem mencionados acima e texto simples ao seu aplicativo com apenas algumas linhas de código. Em detalhe, é um conjunto de SDKs para tradução de documentos e texto simples no nosso Cloud. Suporta tradução de .doc, .docx, .docm, .xls, .xlsx, .xlsm, .ppt, .pptx, .pptm, .pdf, .html, .md, .odt, .ods, .odp, .csv, .tsv, .rtf, .txt, .resx, .srt, .png, Arquivos .jpg, .svg, .bmp e .gif. Basta passar um arquivo ou texto específico para o GroupDocs.Translation Cloud API, e ele traduzirá e salvará o arquivo traduzido no S3 ou retornará o texto traduzido. É fácil começar com GroupDocs.Translation Cloud e não há nada para instalar. Crie uma conta em GroupDocs Cloud e obtenha as informações do seu aplicativo, então você estará pronto para usar SDKs.

Cloud Recursos de tradução de documentos

• Tradução de documentos Microsoft Word®, Microsoft Excel® e Microsoft PowerPoint®
• 46 languages and 140 languages pairs support
• Tradução de tabelas, cabeçalhos, rodapés, notas de rodapé/notas finais, legendas de imagens em documentos Word e arquivos ODT
• Tradução de células, gráficos, tabelas, tabelas dinâmicas em documentos Excel e arquivos ODS
• Tradução de quadros de texto, tabelas, cabeçalhos, rodapés, gráficos, comentários em apresentações PowerPoint e arquivos ODP
• Tradução de arquivos PDF
• Tradução de arquivos Markdown
• Tradução da sintaxe do Hugo em arquivos Markdown
• Tradução de texto simples
• Tradução de recursos .NET do formato RESX
• Tradução de legendas em formato SRT
• Tradução de imagens e PDFs digitalizados obtendo texto simples ou PDF como resultado
• Tradução de tabelas digitalizadas obtendo como resultado uma pasta de trabalho do Excel
• Tradução de texto manuscrito

Formatos de tradução suportados

Você deve especificar o formato do documento a ser traduzido, colocando no corpo da solicitação o valor enum apropriado. Além disso, o usuário pode obter o arquivo traduzido em qualquer outro formato disponível para conversão. Basta especificar o formato de saída do documento traduzido colocando a extensão do arquivo no corpo da solicitação:

• 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 Visite Supported Formats para obter detalhes.

Idiomas de tradução suportados

• en-fr / fr-en — para traduzir do inglês para o francês ou do francês para o inglês.
• en-de / de-en — para traduzir do inglês para o alemão ou do alemão para o inglês.
• en-es / es-en — para traduzir do inglês para o espanhol ou do espanhol para o inglês.
• en-it / it-en — para traduzir do inglês para o italiano ou do italiano para o inglês.
• en-zh / zh-en — para traduzir do inglês para o chinês ou do chinês para o inglês.
• en-ru / ru-en — para traduzir do inglês para o russo ou do russo para o inglês
• en-ar / ar-en — para traduzir do inglês para o árabe ou do árabe para o inglês
• en-pt / pt-en — para traduzir do inglês para o português ou do português para o inglês
• en-pl / pl-en — para traduzir do inglês para o polonês ou do polonês para o inglês
• en-uk / uk-en — para traduzir do inglês para o ucraniano ou do ucraniano para o inglês
• en-vi / vi-en — para traduzir do inglês para o vietnamita ou do vietnamita para o inglês
• en-id / id-en — para traduzir do inglês para o indonésio ou do indonésio para o inglês
• en-hi / hi-en — para traduzir do inglês para o hindi ou do hindi para o inglês
• en-el / el-en — para traduzir do inglês para o grego ou do grego para o inglês
• en-nl / nl-en— para traduzir do inglês para o holandês ou do holandês para o inglês
• en-hu / hu-en — para traduzir do inglês para o húngaro ou do húngaro para o inglês
• en-sv / sv-en — para traduzir do inglês para o sueco ou do sueco para o inglês
• en-tr / tr-en — para traduzir do inglês para o turco ou do turco para o inglês
• en-ja / ja-en — para traduzir do inglês para o japonês ou do japonês para o inglês
• en-ko / ko-en — para traduzir do inglês para o coreano ou do coreano para o inglês
• en-cs / cs-en — para traduzir do inglês para o tcheco ou do tcheco para o inglês
• en-fi / fi-en — para traduzir do inglês para o finlandês ou do finlandês para o inglês
• en-ga / ga-en — para traduzir do inglês para o irlandês ou do irlandês para o inglês
• en-fa / fa-en — para traduzir do inglês para o farsi ou do farsi para o inglês
• en-az / az-en — para traduzir do inglês para o azerbaijano ou do azerbaijano para o inglês
• en-he / he-en — para traduzir do inglês para o hebraico ou do hebraico para o inglês
• en-sk / sk-en — para traduzir do inglês para o eslovaco ou do eslovaco para o inglês
• en-th / th-en — para traduzir do inglês para o tailandês ou do tailandês para o inglês
• en-ro / ro-en — para traduzir do inglês para o romeno ou do romeno para o inglês
• en-ms / ms-en — para traduzir do inglês para o malaio ou do malaio para o inglês
• en-bg / bg-en — para traduzir do inglês para o búlgaro ou do búlgaro para o inglês
• en-bn / bn-en — para traduzir do inglês para o bengali ou do bengali para o inglês
• en-da / da-en — para traduzir do inglês para o dinamarquês ou do dinamarquês para o inglês
• en-lt / lt-en — para traduzir do inglês para o lituano ou do lituano para o inglês- en-lv / lv-en — para traduzir do inglês para o letão ou do letão para o inglês
• en-no / no-en — para traduzir do inglês para o norueguês ou do norueguês para o inglês
• en-et / et-en — para traduzir do inglês para o estoniano ou do estoniano para o inglês
• en-hy / hy-en — para traduzir do inglês para o armênio ou do armênio para o inglês
• en-ca / ca-en — para traduzir do inglês para o catalão ou do catalão para o inglês
• en-hr / hr-en — para traduzir do inglês para o croata ou do croata para o inglês
• en-sr / sr-en — para traduzir do inglês para o sérvio ou do sérvio para o inglês
• en-af / af-en — para traduzir do inglês para o africâner ou do africâner para o inglês
• en-ur / ur-en — para traduzir do inglês para o urdu ou do urdu para o inglês
• en-tl / tl-en — para traduzir do inglês para o tagalo ou do tagalo para o inglês
• en-ka / ka-en — para traduzir do inglês para o georgiano ou do georgiano para o inglês
• fr-de / de-fr — para traduzir do francês para o alemão ou do alemão para o francês
• fr-it / it-fr — para traduzir do francês para o italiano ou do italiano para o francês
• fr-ar / ar-fr — para traduzir do francês para o árabe ou do árabe para o francês
• fr-es / es-fr — para traduzir do francês para o espanhol ou do espanhol para o francês
• fr-id / id-fr — para traduzir do francês para o indonésio ou do indonésio para o francês
• fr-ms / ms-fr — para traduzir do francês para o malaio ou do malaio para o francês
• fr-pl / pl-fr — para traduzir do francês para o polonês ou do polonês para o francês
• fr-ru / ru-fr — para traduzir do francês para o russo ou do russo para o francês
• fr-ar / ar-fr — para traduzir do francês para o árabe ou do árabe para o francês
• de-it / it-de — para traduzir do alemão para o italiano ou do italiano para o alemão
• de-pl / pl-de — para traduzir do alemão para o polonês ou do polonês para o alemão
• de-ar / ar-de — para traduzir do alemão para o árabe ou do árabe para o alemão
• de-zh / zh-de — para traduzir do alemão para o chinês ou do chinês para o alemão
• de-es / es-de — para traduzir do alemão para o espanhol ou do espanhol para o alemão
• de-ms / ms-de — para traduzir do alemão para o malaio ou do malaio para o alemão
• de-uk / uk-de — para traduzir do alemão para o ucraniano ou do ucraniano para o alemão
• it-es / es-it — para traduzir do italiano para o espanhol ou do espanhol para o italiano
• it-ar / ar-it — para traduzir do italiano para o árabe ou do árabe para o italiano
• it-uk / uk-it — para traduzir do italiano para o ucraniano ou do ucraniano para o italiano
• it-ms / ms-it — para traduzir do italiano para o malaio ou do malaio para o italiano
• sv-zh / zh-sv — para traduzir do sueco para o chinês ou do chinês para o sueco
• ar-es / es-ar — para traduzir do árabe para o espanhol ou do espanhol para o árabe
• ar-tr / tr-ar — para traduzir do árabe para o turco ou do turco para o árabe
• ar-pl / pl-ar — para traduzir do árabe para o polonês ou do polonês para o árabe- ru-es / es-ru — para traduzir do russo para o espanhol ou do espanhol para o russo

JSON Detalhes da solicitação

Você pode colocar as seguintes informações no corpo da solicitação para traduzir um documento:

• formato — formato do arquivo para tradução
• outputFormat — formato do arquivo traduzido (por exemplo, pdf)
• sourceLanguage — idioma do documento original (por exemplo, en)
• targetLanguages — idiomas de tradução como lista (por exemplo, [fr, de])
• file — arquivo a ser traduzido em forma de array de bytes
• url — link para o arquivo a ser traduzido, o arquivo ou o URL devem ser fornecidos
• originalFileName — nome original do arquivo a ser traduzido, se for usado um ID de solicitação nulo ou vazio
• mestres — se os slides mestres devem ser traduzidos (somente para apresentações, passe verdadeiro ou falso)
• elementos — páginas de slides para traduzir (somente para apresentações, passe a lista vazia para traduzir a apresentação inteira)
• separador — delimitador para arquivos CSV
• intervalos - dicionário de intervalos na pasta de trabalho do Excel
• shortcodedict — dicionário de sintaxe de código curto em Hugo para traduzir, onde a chave é o índice de código curto baseado em zero e o valor é uma lista de nomes de parâmetros que requerem tradução
• frontmatterdict — dicionário de sintaxe de frontmatéria em Hugo para traduzir, onde a chave é o índice de frontmatéria baseado em zero e o valor é uma lista de caminhos para valores que requerem tradução, cada caminho também é uma lista. Para traduzir texto simples as seguintes informações devem ser colocadas no corpo da solicitação:
• sourceLanguage — idioma do texto original (por exemplo, en)
• targetLanguages — idiomas de tradução como lista (por exemplo, [fr, de])
• textos — lista de textos para traduzir (por exemplo, [olá mundo])
• contains-markdown — verdadeiro se o texto contiver sintaxe de markdown

Como usar o SDK?

Nosso API é completamente independente do seu sistema operacional, sistema de banco de dados ou linguagem de desenvolvimento. Você pode usar qualquer linguagem e plataforma que suporte HTTP para interagir com nosso API. No entanto, escrever manualmente o código do cliente pode ser difícil, sujeito a erros e demorado. Portanto, fornecemos e oferecemos suporte ao SDKs em muitas linguagens de desenvolvimento para facilitar a integração de seus aplicativos Cloud conosco.

Início rápido

1. Obtenha as chaves API se ainda não o fez

Faça uma conta pessoal em GroupDocs Cloud Dashboard e clique em Obter Chaves. Essas chaves são úteis para todos os produtos GroupDocs Cloud. Se você tiver algum problema, dê uma olhada neste detailed manual. Assim que suas chaves forem recebidas, siga este article para experimentar GroupDocs.Translation Cloud ou familiarize-se com Developer guide para obter mais detalhes.

2. Instale SDK

Instale groupdocs-translation-cloud com PIP de PyPI por:

pip install groupdocs-translation-cloud

Ou clone o repositório e instale-o via Setuptools:

python setup.py install

3. Execute a demonstração

• Confira o SDK ou obtenha no PiPy
  • Defina seu cliente_id e cliente_secret
  • Execute o Jupyter Notebook demo.ipynb

Estrutura

Este projeto inclui:

• Módulo “groupdocstranslationcloud”, este é SDK. Você pode integrá-lo em seu aplicativo. Ele contém tradução e armazenamento API
• Módulo “teste”, testes unitários. Você pode dar uma olhada neles para ver vários exemplos de código.
• Caderno Jupyter “demonstração”. Exemplo de caderno de demonstração.

Dependências

• Veja requisitos.txt

Suporte a versões

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

Traduzir texto simples

# 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)

Documentação para terminais API

Todos os URIs são relativos a https://api.groupdocs.cloud/v2.0/translation

Documentação para Modelos

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 Cloud SKDs

GitHub

Gerenciador de Pacotes