Instalação

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

pip install groupdocs-merger-cloud

Requisitos

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

Dependências

O SDK instala automaticamente os seguintes pacotes:

Mesclar documentos e páginas Python Cloud REST API

GroupDocs.Merger Cloud SDK para Python capacita os desenvolvedores a integrar funcionalidades avançadas de mesclagem de documentos e manipulação de páginas em seus aplicativos da web Python, scripts e fluxos de trabalho de automação. Suportando mais de 40 formatos de arquivo, este REST API permite mesclar, dividir e reorganizar páginas de documentos, incluindo PDFs, documentos do Word, planilhas do Excel e muito mais. Os recursos de segurança incluem proteção por senha para documentos, enquanto operações adicionais de arquivos e pastas simplificam o gerenciamento de armazenamento em nuvem. Seja trabalhando com documentos de vários formatos ou realizando manipulações complexas de páginas, o GroupDocs.Merger oferece ferramentas robustas para manuseio seguro e eficiente de documentos em plataformas web, desktop e móveis.

Mesclar documentos

Mesclar dois ou mais documentos - Combine vários documentos em um único arquivo.
Mesclar páginas específicas - Mesclar apenas páginas específicas de documentos diferentes em um só.
Junte intervalos de páginas - Combine intervalos de páginas selecionados de vários documentos em um.
Mesclagem de formatos cruzados - Mesclar documentos de diferentes formatos (por exemplo, DOCX e PDF) em uma única saída.

Divisão e manipulação de páginas

Dividir documentos - Divida um documento de origem em vários arquivos separados.
Mover páginas - Mova páginas de documentos dentro de um arquivo.
Girar páginas – Gire as páginas do documento para ajustar sua orientação.
Remover páginas – Remova páginas indesejadas de um documento.
Trocar páginas - Troque a posição das páginas em um documento.
Extrair páginas – Extraia páginas específicas de um documento para um novo arquivo.
Alterar orientação da página - Ajuste a orientação da página nos tipos de documentos suportados.

Segurança e proteção de documentos

Definir senha do documento - Proteja documentos definindo uma senha.
Remover senha do documento - Remova senhas existentes de documentos protegidos.
Atualizar senha do documento - Altere a senha de um documento protegido.
Verifique a proteção por senha - Verifique se um documento está protegido por senha.

Operações de arquivo

Carregar arquivos para Cloud - Carregar arquivos para armazenamento em nuvem por meio do API.
Baixar arquivos de Cloud - Baixe arquivos do armazenamento em nuvem para sistemas locais.
Copiar arquivos - Copie arquivos do armazenamento em nuvem para locais diferentes.
Mover arquivos - Mova arquivos entre pastas no armazenamento em nuvem.
Excluir arquivos - Exclua arquivos específicos do armazenamento em nuvem.

Operações de pasta

Criar pasta - Crie novas pastas no armazenamento em nuvem.
Copiar pasta - Duplique pastas no armazenamento em nuvem.
Mover pasta - Mova pastas entre diretórios no armazenamento em nuvem.
Excluir pasta - Remova pastas inteiras do armazenamento em nuvem.

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.Merger Cloud suporta mais de 40 formatos de arquivo com recursos de junção, divisão e manipulação de página:

• Processamento de texto: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, HTML, MHT, MHTML
• PDF e layout de página: PDF, XPS, TEX, EPUB
• Apresentações: PPT, PPTX, PPS, PPSX, ODP, OTP, POTX, POTM, PPSM, PPTM
• Planilhas: XLS, XLSX, XLSB, XLSM, XLT, XLTX, XLTM, ODS, CSV, TSV
• Diagramas: VSDX, VSDM, VSSX, VSSM, VSTX, VSTM, VDX, VSX, VTX
• Notas: UM (Microsoft OneNote)
• Texto: TXT, ERRO As operações suportadas variam de acordo com o formato. A fusão de formatos cruzados para PDF/XPS e DOC/DOCX está disponível para muitos tipos. Para a matriz de formato completa, consulte documentation.

Início rápido

Obtenha suas credenciais API

Para usar GroupDocs.Merger 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 GroupDocs.Merger Cloud SDK para Python:

import groupdocs_merger_cloud

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

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

# Create instance of the Document API
document_api = groupdocs_merger_cloud.DocumentApi.from_config(configuration)

Mesclar vários documentos

Depois de inicializado, use este exemplo básico para mesclar documentos do Word em um arquivo:

import groupdocs_merger_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

document_api = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/four-pages.docx")

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/one-page.docx")

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.docx"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

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

Obtenha formatos de arquivo suportados

Recupere a lista completa de formatos de arquivo suportados disponíveis por meio da fusão API.

import groupdocs_merger_cloud

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

result = info_api.get_supported_file_formats()

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

Junte páginas de vários documentos

Mesclar páginas específicas de vários documentos de origem em um único arquivo de saída, com suporte para intervalos de páginas e filtros.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
item1.pages = [3, 6, 8]

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/four-pages.docx")
item2.start_page_number = 1
item2.end_page_number = 4
item2.range_mode = "OddPages"

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined-pages.docx"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Mesclar documentos entre formatos em PDF

Mesclar documentos de diferentes formatos (por exemplo, PDF e DOCX protegidos por senha) em um único arquivo PDF.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo(
    "Pdf/one-page-password.pdf", None, None, "password"
)

item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/one-page.docx")

options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "Output/joined.pdf"

result = document_api.join(groupdocs_merger_cloud.JoinRequest(options))

print("Output file path = " + result.path)

Divida o documento em páginas únicas

Divida um documento em arquivos separados especificando números exatos de páginas.

import groupdocs_merger_cloud

document_api = groupdocs_merger_cloud.DocumentApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.SplitOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
options.output_path = "Output/split-document"
options.pages = [1, 3]
options.mode = "Pages"

result = document_api.split(groupdocs_merger_cloud.SplitRequest(options))

print("Documents count = " + str(len(result.documents)))

Extraia páginas por números

Extraia páginas específicas de um documento para um novo arquivo.

import groupdocs_merger_cloud

pages_api = groupdocs_merger_cloud.PagesApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.ExtractOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("WordProcessing/sample-10-pages.docx")
options.output_path = "Output/extract-pages-by-numbers.docx"
options.pages = [2, 4, 7]

result = pages_api.extract(groupdocs_merger_cloud.ExtractRequest(options))

print("Output file path = " + result.path)

Girar páginas do documento

Gire as páginas selecionadas em um documento PDF para ajustar sua orientação.

import groupdocs_merger_cloud

pages_api = groupdocs_merger_cloud.PagesApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.RotateOptions()
options.file_info = groupdocs_merger_cloud.FileInfo("Pdf/ten-pages.pdf")
options.output_path = "Output/rotate-pages.pdf"
options.pages = [2, 4]
options.mode = "Rotate90"

result = pages_api.rotate(groupdocs_merger_cloud.RotateRequest(options))

print("Output file path = " + result.path)

Adicionar senha ao documento

Proteja um documento adicionando proteção por senha.

import groupdocs_merger_cloud

security_api = groupdocs_merger_cloud.SecurityApi.from_keys("YourClientId", "YourClientSecret")

options = groupdocs_merger_cloud.Options()
options.file_info = groupdocs_merger_cloud.FileInfo(
    "WordProcessing/one-page.docx", None, None, "password"
)
options.output_path = "Output/add-password.docx"

result = security_api.add_password(groupdocs_merger_cloud.AddPasswordRequest(options))

print("Output file path = " + result.path)

Exemplos de projetos em GitHub

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

Como executar os exemplos

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

Tags

Document Merging API | Python Cloud API | GroupDocs.Merger Cloud | REST API | Page Manipulation | Document Security | Password Protection | Cloud Storage Integration | File Operations | Folder Operations | Document Splitting | PDF Merging | Cross-format Merging | Word Document Merging | Excel File Merging | Presentation Merging | Document Reorganization | Secure API Access | Document Joining | Document Manipulation API | Merge Multiple Formats | Cross-platform API