Conversão 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-conversion-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:

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

Início rápido

Obtenha suas credenciais API

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

import groupdocs_conversion_cloud

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

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

# Create instance of the Convert API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_config(configuration)

Converta um documento (direto, sem armazenamento em nuvem)

Depois de inicializado, use este exemplo básico para converter um documento local e receber o resultado diretamente:

import groupdocs_conversion_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instance of the API
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Prepare request: output format and local file path
request = groupdocs_conversion_cloud.ConvertDocumentDirectRequest("pdf", "input.docx")

# Convert and save the result
result = convert_api.convert_document_direct(request)

with open("output.pdf", "wb") as f:
    f.write(result)

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

Converter documentos usando armazenamento Cloud

Este exemplo carrega um arquivo para o armazenamento GroupDocs Cloud, converte-o e baixa o resultado – ideal para fluxos de trabalho do lado do servidor que gerenciam arquivos na nuvem.

import groupdocs_conversion_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instances of the APIs
file_api = groupdocs_conversion_cloud.FileApi.from_keys(client_id, client_secret)
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Upload file to cloud storage
file_api.upload_file(
    groupdocs_conversion_cloud.UploadFileRequest("myFile.docx", "myFile.docx")
)

# Prepare convert settings
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "myFile.docx"
settings.format = "pdf"
settings.output_path = "converted"

# Convert the document
result = convert_api.convert_document(
    groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)

print("Document converted: " + result[0].url)

# Download the converted file
response = file_api.download_file(
    groupdocs_conversion_cloud.DownloadFileRequest("converted/myFile.pdf", None)
)

Converter documentos entre vários formatos Cloud API

Este código permite que os desenvolvedores convertam documentos entre vários formatos programaticamente com opções avançadas de saída PDF, eliminando conversões manuais. Ele suporta mais de 50 formatos de arquivo, tornando-o ideal para desenvolvedores de aplicativos que necessitam de suporte multiformato.

import groupdocs_conversion_cloud

configuration = groupdocs_conversion_cloud.Configuration("YourClientId", "YourClientSecret")
convert_api = groupdocs_conversion_cloud.ConvertApi.from_config(configuration)

# Prepare convert settings
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "WordProcessing/password-protected.docx"
settings.format = "pdf"
settings.output_path = "converted"

# Load options for password-protected source document
load_options = groupdocs_conversion_cloud.WordProcessingLoadOptions()
load_options.password = "password"

# PDF conversion options
convert_options = groupdocs_conversion_cloud.PdfConvertOptions()
convert_options.center_window = True
convert_options.compress_images = False
convert_options.display_doc_title = True
convert_options.dpi = 1024
convert_options.from_page = 1
convert_options.image_quality = 100
convert_options.password = "password"
convert_options.unembed_fonts = True

settings.load_options = load_options
settings.convert_options = convert_options

# Execute the conversion
result = convert_api.convert_document(
    groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)

print("Document converted: " + result[0].url)

Converter páginas específicas de um documento Cloud API

Este exemplo demonstra como os desenvolvedores podem converter apenas páginas específicas, economizando tempo de processamento e reduzindo o tamanho dos arquivos quando apenas uma parte do documento é necessária.

import groupdocs_conversion_cloud

convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys("YourClientId", "YourClientSecret")

# Configure settings to convert specific pages (e.g., pages 1 and 3)
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "WordProcessing/four-pages.docx"
settings.format = "pdf"
settings.output_path = "converted/two-pages.pdf"

convert_options = groupdocs_conversion_cloud.PdfConvertOptions()
convert_options.pages = [1, 3]
settings.convert_options = convert_options

# Execute the conversion
result = convert_api.convert_document(
    groupdocs_conversion_cloud.ConvertDocumentRequest(settings)
)

print("Document converted: " + result[0].url)

Obtenha formatos de conversão suportados

Recupere a lista completa de conversões de formato de origem para destino suportadas disponíveis por meio do API.

import groupdocs_conversion_cloud

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

result = info_api.get_supported_conversion_types(
    groupdocs_conversion_cloud.GetSupportedConversionTypesRequest()
)

print("Formats count: " + str(len(result)))

Exemplos de projetos em GitHub

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

Categoria	Exemplos
Converter	PDF, HTML, imagem, apresentação, planilha, processamento de texto; conversão direta; conversão assíncrona
Opções comuns	Marcas d’água, páginas específicas, páginas consecutivas, fontes personalizadas
Opções de carregamento	CAD, CSV, email, HTML, OneNote, PDF, apresentação, planilha, texto, processamento de texto
Informações	Conversões suportadas, informações de documentos

Como executar os exemplos

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