Mesclar documentos de diferentes tipos usando a API REST em Python

A fusão de diferentes documentos do mesmo ou de diferentes tipos permite reunir os dados ou informações dispersos em um único arquivo. Podemos mesclar facilmente vários documentos de diferentes tipos de arquivo em um arquivo na nuvem. Neste artigo, aprenderemos como mesclar documentos de diferentes tipos de arquivo em PDF usando uma API REST em Python.

Os seguintes tópicos serão abordados neste artigo:

API REST de fusão de arquivos e SDK do Python

Para mesclar vários arquivos, usaremos a API Python SDK of GroupDocs.Merger Cloud. Ele nos permite combinar, dividir, remover e reorganizar uma única página ou uma coleção de páginas de formatos de documento suportados de Word, Excel, PowerPoint, Desenhos do Visio, PDF e HTML. Instale-o usando o seguinte comando no console:

pip install groupdocs-merger-cloud

Por favor, obtenha seu ID e Segredo do cliente no painel antes de seguir as etapas mencionadas. Depois de ter seu ID e segredo, adicione o código conforme mostrado abaixo:

# Este exemplo de código demonstra como adicionar ID e segredo do cliente no código.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

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

Mesclar vários tipos de arquivo usando a API REST em Python

Podemos combinar documentos de vários tipos de arquivos programaticamente na nuvem seguindo as etapas abaixo:

  1. Upload os arquivos para a nuvem
  2. Mesclar Documentos de diferentes tipos de arquivo
  3. Baixar o arquivo mesclado

Carregar os arquivos

Em primeiro lugar, faremos o upload dos arquivos para a nuvem usando o exemplo de código abaixo:

# Este exemplo de código demonstra como fazer upload de arquivos para a nuvem.
# Crie uma instância das APIs
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# Carregar arquivos de amostra
for filename in glob.iglob("C:\\Files\\Merger\\upload\\*.*", recursive=True):
    destFile = filename.replace("C:\\Files\\Merger\\upload", "", 1)           
    # Criar solicitação de upload de arquivo
    request = groupdocs_merger_cloud.UploadFileRequest(destFile, filename)
    # Subir arquivo
    file_api.upload_file(request)

Como resultado, os arquivos enviados estarão disponíveis na seção de arquivos do seu painel na nuvem.

Mesclar documentos de diferentes tipos de arquivo em Python

Agora, podemos mesclar facilmente os arquivos carregados de diferentes tipos em um único arquivo seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do DocumentApi.
  • Em seguida, forneça o caminho do arquivo de entrada para o primeiro JoinItem.
  • Em seguida, forneça o caminho do arquivo de entrada para o segundo JoinItem.
  • Opcionalmente, repita as etapas acima para adicionar mais arquivos.
  • Depois disso, defina JoinOptions e defina o caminho do arquivo de saída.
  • Por fim, chame o método join() e salve o documento mesclado.

O exemplo de código a seguir mostra como mesclar diferentes tipos de arquivo usando uma API REST em Python.

# Este exemplo de código demonstra como mesclar documentos de diferentes tipos de arquivo em Python.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# primeiro arquivo
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# Segundo arquivo
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.docx")

# opções de junção
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# Criar solicitação de ingresso com JoinOptions
request = groupdocs_merger_cloud.JoinRequest(options)

# Juntar arquivos
result = documentApi.join(request)        

Baixe o arquivo mesclado

Por fim, o exemplo de código acima salvará o arquivo PDF mesclado na nuvem. Ele pode ser baixado usando o seguinte exemplo de código:

# Este exemplo de código demonstra como baixar um arquivo mesclado da nuvem.
# inicialização da API
file_api = groupdocs_merger_cloud.FileApi.from_config(configuration)

# Criar solicitação de arquivo de download
request = groupdocs_merger_cloud.DownloadFileRequest("joined.pdf", my_storage)

# ⇬ Fazer download do arquivo
response = file_api.download_file(request)

# Mova o arquivo baixado para o seu diretório de trabalho
shutil.move(response, "C:\\Files\\Merger\\")

Como mesclar PDF e Excel em PDF

Podemos mesclar arquivos PDF e Excel em um PDF seguindo as etapas mencionadas anteriormente. No entanto, só precisamos fornecer caminhos de documento PDF e Excel como o primeiro e o segundo JoinItems. O exemplo de código a seguir mostra como mesclar um documento PDF e uma planilha do Excel em um arquivo PDF usando uma API REST em Python.

# Este exemplo de código demonstra como mesclar arquivos Word e Excel em PDF usando Python.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# primeiro arquivo
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# Segundo arquivo
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.xlsx")

# opções de junção
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# Criar solicitação de ingresso com JoinOptions
request = groupdocs_merger_cloud.JoinRequest(options)

# Juntar arquivos
result = documentApi.join(request)        

Como mesclar PDF e PowerPoint em PDF

Também podemos mesclar documentos PDF e apresentações do PowerPoint em PDF seguindo as etapas mencionadas anteriormente. No entanto, só precisamos fornecer caminhos de documentos PDF e PowerPoint como o primeiro e o segundo JoinItems. O exemplo de código a seguir mostra como mesclar um documento PDF e uma apresentação do PowerPoint em um arquivo PDF usando uma API REST em Python.

# Este exemplo de código demonstra como mesclar apresentações do Word e do PowerPoint em PDF usando Python.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# primeiro arquivo
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")

# Segundo arquivo
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.pptx")

# opções de junção
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# Criar solicitação de ingresso com JoinOptions
request = groupdocs_merger_cloud.JoinRequest(options)

# Juntar arquivos
result = documentApi.join(request)        

Combine páginas específicas de diferentes tipos de arquivos em Python

Podemos mesclar páginas selecionadas de documentos de diferentes tipos em um único arquivo seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do DocumentApi.
  • Em seguida, forneça o caminho do arquivo de entrada para o primeiro JoinItem.
  • Em seguida, forneça números de página específicos para mesclar.
  • Em seguida, forneça o caminho do arquivo de entrada para o segundo JoinItem.
  • Em seguida, defina o intervalo de páginas para mesclar com o número da página inicial e o número da página final.
  • Depois disso, defina JoinOptions e defina o caminho do arquivo de saída.
  • Por fim, chame o método join() e salve o documento mesclado.

O exemplo de código a seguir mostra como mesclar páginas específicas de diferentes tipos de arquivo usando uma API REST em Python.

# Este exemplo de código demonstra como mesclar documentos de diferentes tipos de arquivo em Python.
documentApi = groupdocs_merger_cloud.DocumentApi.from_keys(client_id, client_secret)

# primeiro arquivo
item1 = groupdocs_merger_cloud.JoinItem()
item1.file_info = groupdocs_merger_cloud.FileInfo("sample.pdf")
# Números de página a serem mesclados do primeiro documento
item1.pages = [1, 2]

# Segundo arquivo
item2 = groupdocs_merger_cloud.JoinItem()
item2.file_info = groupdocs_merger_cloud.FileInfo("sample.docx")
# Intervalo de páginas para mesclar do segundo documento
item2.start_page_number = 1
item2.end_page_number = 3
  
# opções de junção
options = groupdocs_merger_cloud.JoinOptions()
options.join_items = [item1, item2]
options.output_path = "joined.pdf"

# Criar solicitação de ingresso com JoinOptions
request = groupdocs_merger_cloud.JoinRequest(options)

# Juntar arquivos
result = documentApi.join(request)        

Experimente on-line

Experimente a seguinte ferramenta de mesclagem on-line gratuita, desenvolvida usando a API acima. https://products.groupdocs.app/merger/

Conclusão

Neste artigo, aprendemos:

  • como mesclar documentos de vários tipos de arquivo em Python;
  • como combinar páginas específicas de documentos de diferentes tipos de arquivo em Python;
  • fazer upload de vários arquivos para a nuvem;
  • como baixar PDF mesclado da nuvem.

Além disso, você pode aprender mais sobre GroupDocs.Merge Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, não hesite em contactar-nos no fo.

Veja também