Extrair texto bruto de pastas de trabalho do Excel é uma necessidade frequente ao construir pipelines de dados ou gerar relatórios simples. Se você precisa saber como converter Excel Workbook para texto em Python, o GroupDocs.Conversion Cloud SDK for Python facilita o processo. Este guia orienta você na instalação do SDK, upload de uma pasta de trabalho, configuração das opções de conversão e recuperação do resultado em TXT simples. Ao final, você terá um script reutilizável e um conjunto de comandos cURL para automação baseada em REST.

Antes de Começar: Pré-requisitos e Instalação

Antes de começar, certifique‑se de que você tem o seguinte:

  • Python 3.7 ou mais recente instalado na sua máquina.
  • Uma conta ativa do GroupDocs Cloud (client ID e client secret).
  • Acesso à rede aos endpoints do GroupDocs Cloud.

Instale o SDK via pip:

pip install groupdocs-conversion-cloud

Você também pode baixar o pacote mais recente na página oficial de lançamento. Após a instalação, defina suas credenciais como variáveis de ambiente ou substitua os marcadores de posição no código mais tarde. Com o SDK pronto, você está preparado para iniciar o processo de conversão.

Construindo passo a passo: como converter uma pasta de trabalho Excel em texto no Python

Passo 1: Configurar Credenciais

Primeiro, crie um objeto Configuration e forneça seu ID de cliente e segredo. Esse objeto é usado por todas as chamadas subsequentes da API.

import os
from groupdocs_conversion_cloud import Configuration

client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
config.client_id = client_id
config.client_secret = client_secret

A classe Configuration está documentada na referência da API.

Etapa 2: Carregar Pasta de Trabalho do Excel

Carregue o arquivo Excel local no GroupDocs Cloud storage. Esta etapa é opcional se o seu arquivo já estiver na nuvem.

from groupdocs_conversion_cloud import ApiClient, UploadFileApi, UploadFileRequest

api_client = ApiClient(config)
upload_api = UploadFileApi(api_client)

local_excel_path = "sample.xlsx"
remote_excel_path = "sample.xlsx"

with open(local_excel_path, "rb") as f:
    upload_request = UploadFileRequest(
        path=remote_excel_path,
        file=f.read()
    )
    upload_api.upload_file(upload_request)

O UploadFileApi lida com transferências de arquivos; veja sua documentação para mais detalhes.

Etapa 3: Definir opções de conversão

Crie um objeto TxtConvertOptions para especificar quaisquer parâmetros opcionais, como intervalo de páginas. Em seguida, construa o objeto ConvertSettings que une tudo.

from groupdocs_conversion_cloud import (
    FileInfo,
    TxtConvertOptions,
    ConvertSettings,
)

file_info = FileInfo()
file_info.file_path = remote_excel_path

txt_options = TxtConvertOptions()
# txt_options.page_number = 1   # Uncomment to start from a specific page
# txt_options.page_count = 1    # Uncomment to limit the number of pages

convert_settings = ConvertSettings()
convert_settings.file_info = file_info
convert_settings.format = "txt"
convert_settings.output_path = "sample.txt"
convert_settings.options = txt_options

A classe TxtConvertOptions permite ajustar finamente a conversão; consulte a documentação oficial para todos os campos disponíveis.

Etapa 4: Executar Conversão

Chame o método convert de ConvertApi com as configurações preparadas. A resposta contém uma URL para baixar o arquivo convertido.

from groupdocs_conversion_cloud import ConvertApi, ApiException

convert_api = ConvertApi(api_client)

try:
    conversion_result = convert_api.convert(convert_settings)
    print(f"Conversion succeeded. Download URL: {conversion_result.url}")
except ApiException as e:
    print(f"Conversion failed: {e}")

Se a chamada for bem-sucedida, você receberá um link de download direto para o arquivo TXT.

Etapa 5: Recuperar Resultado

Use a URL da etapa anterior para baixar o arquivo de texto simples para o seu ambiente local ou processá‑lo ainda mais em sua aplicação.

Dica: Você pode automatizar o download com uma chamada simples requests.get() , lidando com a autenticação via o mesmo token de acesso usado para a solicitação de conversão.

Com estas etapas, você agora tem um fluxo de trabalho completo para como converter uma pasta de trabalho Excel em texto em Python usando a biblioteca GroupDocs.

Conversão de Texto de Pasta de Trabalho do Excel - Exemplo de Código Completo

O exemplo a seguir demonstra a implementação completa do início ao fim.

import os
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    UploadFileApi,
    UploadFileRequest,
    ConvertApi,
    ConvertSettings,
    FileInfo,
    TxtConvertOptions,
    ApiException,
)

def main():
    # ----------------------------------------------------------------------
    # 1. Configure credentials (replace placeholders or set env variables)
    # ----------------------------------------------------------------------
    client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
    client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
    config.client_id = client_id
    config.client_secret = client_secret

api_client = ApiClient(config)

# ----------------------------------------------------------------------
    # 2. Upload local Excel workbook to GroupDocs Cloud storage (optional)
    # ----------------------------------------------------------------------
    local_excel_path = "sample.xlsx"          # path to the Excel file on your machine
    remote_excel_path = "sample.xlsx"         # path where the file will be stored in the cloud

upload_api = UploadFileApi(api_client)
    try:
        with open(local_excel_path, "rb") as f:
            upload_request = UploadFileRequest(
                path=remote_excel_path,
                file=f.read()
            )
            upload_api.upload_file(upload_request)
        print(f"Uploaded '{local_excel_path}' to cloud storage as '{remote_excel_path}'.")
    except (ApiException, IOError) as e:
        print(f"Failed to upload file: {e}")
        return

# ----------------------------------------------------------------------
    # 3. Prepare conversion settings to transform Excel → plain text
    # ----------------------------------------------------------------------
    convert_api = ConvertApi(api_client)

file_info = FileInfo()
    file_info.file_path = remote_excel_path          # source file in cloud storage

txt_options = TxtConvertOptions()
    # (optional) you can limit conversion to specific pages:
    # txt_options.page_number = 1
    # txt_options.page_count = 1

convert_settings = ConvertSettings()
    convert_settings.file_info = file_info
    convert_settings.format = "txt"                  # target format
    convert_settings.output_path = "sample.txt"      # result file name in cloud storage
    convert_settings.options = txt_options

# ----------------------------------------------------------------------
    # 4. Execute conversion
    # ----------------------------------------------------------------------
    try:
        conversion_result = convert_api.convert(convert_settings)
        # The result contains a URL to download the converted file
        print(f"Conversion succeeded. Download URL: {conversion_result.url}")
    except ApiException as e:
        print(f"Conversion failed: {e}")

if __name__ == "__main__":
    main()

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá-lo em seu projeto, certifique-se de atualizar quaisquer caminhos de arquivos e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Conversão de Excel para Texto usando cURL e a API REST

Se você preferir uma abordagem REST pura, a mesma conversão pode ser realizada com comandos cURL.

  1. Obter um token de acesso
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Carregue o arquivo Excel de origem
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @sample.xlsx
  1. Inicie a conversão para TXT
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.xlsx" },
           "format": "txt",
           "outputPath": "sample.txt",
           "options": {}
         }'
  1. Baixe o arquivo TXT convertido
   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o sample.txt

Esses comandos ilustram o ciclo de vida completo, da autenticação ao download. Para parâmetros adicionais e tratamento de erros, consulte a referência da API.

Configurando Configurações de Conversão para Excel

O SDK oferece várias opções para personalizar a saída. Abaixo estão as configurações mais úteis para a conversão de Excel‑para‑TXT:

  • Número da Página - Inicie a conversão a partir de uma planilha ou página específica.
    txt_options.page_number = 1
  • Contagem de Páginas - Limite o número de planilhas/páginas a converter.
    txt_options.page_count = 2
  • Caminho de Saída - Defina o nome e a localização do arquivo TXT resultante no armazenamento em nuvem.
    convert_settings.output_path = "output/sample.txt"

Outras opções avançadas, como encoding ou preserveFormatting, estão disponíveis na referência da API; explore‑as para atender aos seus requisitos exatos.

Considerações Finais

Converter uma pasta de trabalho do Excel para texto simples em Python agora é um processo simples e repetível graças ao GroupDocs.Conversion Cloud SDK for Python. O SDK lida com autenticação, armazenamento de arquivos e conversão nos bastidores, permitindo que você se concentre na lógica de negócios. Lembre‑se de revisar as opções de licenciamento na página de preços e obter uma licença temporária para avaliação antes de passar para produção. Com o código e os exemplos cURL fornecidos, você pode integrar a conversão de Excel‑to‑TXT em qualquer fluxo de trabalho ou microsserviço Python‑based.

Perguntas Frequentes

  • Qual é a maneira mais fácil de converter uma pasta de trabalho do Excel para texto em Python?
    Use o GroupDocs.Conversion Cloud SDK for Python. Ele abstrai as chamadas REST e fornece uma API Pythonic limpa para upload, conversão e download de arquivos.

  • Posso converter apenas planilhas ou páginas específicas de uma pasta de trabalho do Excel?
    Sim. Defina page_number e page_count no objeto TxtConvertOptions para direcionar planilhas específicas. Consulte a referência da API para obter detalhes completos.

  • Preciso de uma conta GroupDocs para usar o SDK?
    É necessária uma conta válida do GroupDocs Cloud com ID do cliente e segredo. Você pode criar uma conta no portal GroupDocs e obter credenciais no painel.

  • Existe um limite de tamanho de arquivo para conversão de Excel para TXT?
    O serviço em nuvem suporta arquivos de até 200 MB para conversão. Arquivos maiores devem ser divididos ou processados em partes antes do upload.

Leitura adicional