Editor de Documentos Cloud API

Navegue pelos nossos produtos

Are you looking for an evaluation version of a product?

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.

Are you having troubles in downloading?

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.

Instalação
O pacote é disponível em PyPI e pode ser instalado via pip executando o seguinte comando:
pip install groupdocs-editor-cloud

Requisitos

Python 2.7 ou 3.4+
pip gerenciador de pacotes
GroupDocs Credenciais Cloud — Client ID and Client Secret do Dashboard

Dependências

Pacote	Restrição
urllib3	>= 1,15
six	>= 1,10
certifi	—
python-dateutil	—

O SDK instala automaticamente os seguintes pacotes:

Edite mais de 40 formatos de documentos em Cloud via REST

GroupDocs.Editor Cloud SDK para Python é um REST API projetado para integrar recursos de edição de documentos em aplicativos da web Python, scripts e fluxos de trabalho de automação. Suportando mais de 40 formatos de arquivo, este API permite editar facilmente documentos do Word, planilhas, apresentações e muito mais diretamente da nuvem, sem a necessidade de software de terceiros como o MS Office. Os recursos incluem gerenciamento de arquivos protegidos por senha, suporte a vários idiomas e opções de formatação personalizáveis. Os desenvolvedores podem realizar operações de arquivo, como carregar, editar e salvar documentos na Web, desktop e plataformas móveis com facilidade.

Editando documentos de processamento de texto

Formatos suportados - DOC, DOCX, DOCM, DOT, DOTM, DOTX, ODT, OTT, RTF e muito mais.
Fluxo de trabalho de armazenamento Cloud - Carregue, edite e salve documentos de processamento de texto diretamente do armazenamento em nuvem.
Documentos protegidos por senha - Lide com documentos do Word protegidos por senha durante o carregamento e salvamento.
Opções de carregamento - Habilite paginação, extraia fontes e administre informações em vários idiomas.

Editando documentos de planilha

Formatos suportados - XLS, XLSX, XLSM, XLSB, ODS, CSV, TSV e outros.
Seleção de planilhas - Carregue planilhas em HTML editável e trabalhe em planilhas específicas.
Planilhas ocultas - Exclua planilhas ocultas da edição, se desejar.
Proteção por senha - Lide com documentos de planilhas protegidos por senha.

Editando documentos de apresentação

Formatos suportados - PPT, PPTX, PPTM, PPSX, POTX, ODP, OTP e muito mais.
Seleção de slides - Carregue slides específicos de apresentações para edição.
Slides ocultos – Inclua ou exclua slides ocultos durante o processo de edição.

Editando documentos de texto

Suporte a texto simples - Manipule arquivos TXT e reconheça estruturas simples como listas e recuos.
Salvar no formato Word - Salve os arquivos TXT editados de volta no formato de processamento Word, se necessário.
Opções de formatação - Controle os espaços iniciais e finais e habilite a paginação na saída HTML.

Editando documentos de valores separados por delimitadores (DSV)

Delimitadores personalizados - Suporta CSV, TSV e arquivos com separadores personalizados.
Conversão de dados - Especifique separadores personalizados e lide com a conversão de dados/dados numéricos.
Delimitadores consecutivos – Opção para tratar delimitadores consecutivos como uma única entidade.

Recuperação de informações de documentos

Detalhes do arquivo - Recupere extensão de arquivo, tamanho do documento, contagem de páginas e status de proteção por senha.
Informações sobre formatos suportados - Obtenha a lista completa de tipos de arquivos editáveis em API.

Operações de arquivo e armazenamento

Baixar arquivos - Baixe arquivos do armazenamento em nuvem através do API.
Versões de arquivo – recupere versões específicas de arquivos de sistemas de armazenamento que suportam controle de versão.
Verificações de armazenamento - Verifique a existência de armazenamento em nuvem e liste arquivos dentro de pastas.

Licenciamento e Autenticação

Modo de avaliação - Experimente o API com uma conta de teste gratuita.
Autenticação segura – Use o ID do cliente e o segredo do cliente para acesso seguro ao API.
Licença MIT - O Python SDK é licenciado sob MIT License.

Formatos de documentos suportados

GroupDocs.Editor Cloud suporta 40+ formatos de arquivo com recursos de edição e detecção automática:

Processamento de texto: DOC, DOCX, DOCM, DOT, DOTM, DOTX, ODT, OTT, RTF, FlatOPC, WordML
Planilhas: XLS, XLT, XLSX, XLSM, XLTX, XLTM, XLSB, XLAM, ODS, FODS, DIF, CSV, TSV, DSV
Apresentações: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POTX, POTM, ODP, OTP
Outro: TXT, HTML, XML As operações suportadas variam de acordo com o formato. Para a matriz de formato completa, consulte documentation.

Início rápido

Obtenha suas credenciais API

Para usar GroupDocs.Editor Cloud, cadastre-se em GroupDocs.Cloud Dashboard e obtenha seu ID do cliente e Segredo do cliente.

Inicialize o API

Use o código a seguir para começar a usar o GroupDocs.Editor Cloud SDK para Python:

import groupdocs_editor_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_editor_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the Edit API
edit_api = groupdocs_editor_cloud.EditApi.from_config(configuration)

Edite um documento do Word

Depois de inicializado, use este exemplo básico para carregar um arquivo DOCX, editar sua representação HTML e salvar o resultado:

import groupdocs_editor_cloud

edit_api = groupdocs_editor_cloud.EditApi.from_keys("YourClientId", "YourClientSecret")
file_api = groupdocs_editor_cloud.FileApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_editor_cloud.FileInfo("WordProcessing/password-protected.docx", None, None, "password")
load_options = groupdocs_editor_cloud.WordProcessingLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
with open(html_file, "r") as file:
    html = file.read()

html = html.replace("Sample test text", "Hello world")

with open(html_file, "w") as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

save_options = groupdocs_editor_cloud.WordProcessingSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.docx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

print("Document edited: " + save_result.path)

Com este guia de início rápido, você está pronto para começar a editar documentos usando GroupDocs.Editor Cloud em seus aplicativos Python. Para mais detalhes, visite documentation.

Obtenha tipos de arquivos suportados

Recupere a lista completa de formatos de arquivo suportados disponíveis através do Editor API.

import groupdocs_editor_cloud

info_api = groupdocs_editor_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_file_formats()

for fmt in result.formats:
    print(fmt.file_format)

Obtenha informações do documento

Recupere metadados de documentos, como contagem de páginas e status de proteção por senha.

import groupdocs_editor_cloud

info_api = groupdocs_editor_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_editor_cloud.FileInfo("WordProcessing/password-protected.docx", None, None, "password")
result = info_api.get_info(groupdocs_editor_cloud.GetInfoRequest(file_info))

print("Page count = " + str(result.page_count))

Editar documento de planilha

Carregue uma planilha específica de um arquivo XLSX, edite seu conteúdo HTML e salve novamente no formato de planilha.

import groupdocs_editor_cloud

edit_api = groupdocs_editor_cloud.EditApi.from_keys("YourClientId", "YourClientSecret")
file_api = groupdocs_editor_cloud.FileApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_editor_cloud.FileInfo("Spreadsheet/four-sheets.xlsx")
load_options = groupdocs_editor_cloud.SpreadsheetLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_options.worksheet_index = 0
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
with open(html_file, "r") as file:
    html = file.read()

html = html.replace("This is sample sheet", "This is sample sheep")

with open(html_file, "w") as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

save_options = groupdocs_editor_cloud.SpreadsheetSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.xlsx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

print("Document edited: " + save_result.path)

Editar documento de apresentação

Carregue um slide específico de um arquivo PPTX, edite seu conteúdo HTML e salve novamente no formato de apresentação.

import groupdocs_editor_cloud

edit_api = groupdocs_editor_cloud.EditApi.from_keys("YourClientId", "YourClientSecret")
file_api = groupdocs_editor_cloud.FileApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_editor_cloud.FileInfo("Presentation/with-notes.pptx")
load_options = groupdocs_editor_cloud.PresentationLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_options.slide_number = 0
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
with open(html_file, "r") as file:
    html = file.read()

html = html.replace("Slide sub-heading", "Hello world!")

with open(html_file, "w") as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

save_options = groupdocs_editor_cloud.PresentationSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.pptx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

print("Document edited: " + save_result.path)

Editar documento DSV

Carregue um arquivo de valores separados por delimitador, edite sua representação HTML e salve novamente no formato TSV.

import groupdocs_editor_cloud

edit_api = groupdocs_editor_cloud.EditApi.from_keys("YourClientId", "YourClientSecret")
file_api = groupdocs_editor_cloud.FileApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_editor_cloud.FileInfo("Spreadsheet/sample.tsv")
load_options = groupdocs_editor_cloud.DelimitedTextLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
with open(html_file, "r") as file:
    html = file.read()

html = html.replace("32", "66")

with open(html_file, "w") as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

save_options = groupdocs_editor_cloud.DelimitedTextSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.tsv"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

print("Document edited: " + save_result.path)

Editar documento de texto

Carregue um arquivo de texto simples, edite sua representação HTML e salve o resultado.

import groupdocs_editor_cloud

edit_api = groupdocs_editor_cloud.EditApi.from_keys("YourClientId", "YourClientSecret")
file_api = groupdocs_editor_cloud.FileApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_editor_cloud.FileInfo("Text/document.txt")
load_options = groupdocs_editor_cloud.TextLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))

html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
with open(html_file, "r") as file:
    html = file.read()

html = html.replace("Page Text", "New Text")

with open(html_file, "w") as file:
    file.write(html)

file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))

save_options = groupdocs_editor_cloud.TextSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.txt"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))

print("Document edited: " + save_result.path)

Exemplos de projetos em GitHub

O repositório GroupDocs.Editor Cloud Python Samples inclui exemplos prontos para execução que abrangem:

Categoria	Exemplos
GetSupportedFileTypes	Tipos de arquivos suportados
Obter informações	Informações do documento (contagem de páginas, status da senha)
EditOperações — Word	Edite documentos de processamento de texto (inclusive protegidos por senha)
EditOperations — Planilha	Edite documentos de planilha com seleção de planilha
EditOperações — Apresentação	Edite documentos de apresentação com seleção de slides
EditOperações — DSV	Editar documentos de valores separados por delimitadores (CSV, TSV)
EditOperations — Texto	Edite documentos de texto simples

Como executar os exemplos

Clone ou baixe o samples repository
Edite Examples/RunExamples.py e defina seu client_id e client_secret
Vá para o diretório Examples
Execute pip install groupdocs-editor-cloud -U
Execute python RunExamples.py Para mais detalhes, visite Getting Started.