Instalação

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

pip install groupdocs-viewer-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:

Python Cloud REST API para renderização de documentos

GroupDocs.Viewer Cloud SDK para Python oferece uma solução poderosa de renderização de documentos que suporta mais de 190 formatos, como Word, Excel, PDFs, CAD, e-mails e muito mais. Os desenvolvedores podem facilmente converter e renderizar documentos em HTML, PDF e formatos de imagem, preservando a estrutura e o layout do documento original. Com recursos avançados como saída de streaming, opções de visualização personalizadas, renderização de várias páginas e suporte para vários tipos de arquivo, GroupDocs.Viewer Cloud API fornece integração perfeita para necessidades de visualização de documentos em qualquer aplicativo da web Python, script ou fluxo de trabalho de automação. Cadastre-se gratuitamente para começar a aproveitar a flexibilidade e os recursos deste API robusto baseado em nuvem.

Uso Básico

Configuração Simples do Viewer - Guia para configurar rapidamente o GroupDocs.Viewer com configuração mínima.
Carregar documento de Cloud - Instruções sobre como carregar documentos diretamente do armazenamento em nuvem para visualização.
Opções de visualização personalizada - Etapas para personalizar as configurações do visualizador, como zoom, layout e navegação.
Formatos de arquivo suportados – Lista detalhada de formatos de arquivo suportados que podem ser visualizados sem conversão.

HTML Visualizador

Converter documentos para HTML - Processo de conversão de documentos para o formato HTML para visualização perfeita baseada em navegador.
Stream HTML Output - Guia sobre streaming de conteúdo HTML para renderização de documentos em tempo real.
Preservar estrutura do documento em HTML - Instruções para manter o layout e estrutura original ao converter para HTML.
Opções de visualização HTML personalizadas - Recursos para personalizar a aparência de documentos visualizados por HTML, incluindo estilos e fontes.

Visualizador de imagens

Converter documentos em imagens - Etapas para converter documentos em formatos de imagem como PNG e JPEG para visualização.
Stream Image Output - Guia para streaming de formatos de imagem do visualizador de documentos.
Personalizar resolução de imagem - Opções para definir resolução de imagem específica ao visualizar documentos como imagens.
Renderização de imagens de documentos de várias páginas – Instruções para renderizar documentos de várias páginas como imagens separadas.

PDF Visualizador

Converter documentos em PDF - Converta qualquer formato de documento compatível em PDF para visualização.
Stream PDF Output - Guia para transmitir conteúdo PDF para visualização otimizada em navegadores ou aplicativos.
Incorporar visualizador PDF – Instruções para incorporar um visualizador PDF personalizável em seu aplicativo.
PDF Viewer Support - Recursos para visualizar e interagir com documentos PDF.

Renderizar documento

Renderizar documento para HTML, imagem ou PDF - Opções para renderizar documentos nos formatos HTML, imagem ou PDF para visualização.
Stream Rendered Output – Transmita a saída do documento renderizado para acesso em tempo real em seu aplicativo.
Renderização de documentos de várias páginas – Suporte para renderização de documentos de várias páginas em vários arquivos HTML, imagem ou PDF.

Opções de renderização por tipo de documento

Renderização especializada para tipos de arquivo – Opções de renderização personalizadas adaptadas para vários tipos de documentos, como Word, Excel, PDF e muito mais.
Preservar recursos do documento – Garanta que os recursos do documento original, como layout, texto e formatação, sejam mantidos durante a renderização.

Renderizando arquivos compactados

Renderize arquivos ZIP, RAR e TAR - Converta formatos de arquivo como ZIP, RAR e TAR em conteúdo visualizável.
Extraia e renderize arquivos específicos - Extraia arquivos específicos de arquivos e renderize-os sem baixar o arquivo inteiro.

Renderizando desenhos CAD

Renderizar formatos CAD (DWG, DXF, etc.) - Converta e exiba arquivos CAD como DWG e DXF para visualização detalhada.
Personalizar opções de renderização de CAD - Defina parâmetros específicos para renderização de CAD, como nível de zoom, visibilidade da camada e layout.

Renderizando mensagens de e-mail

Renderizar formatos MSG, EML e MHTML - Visualize mensagens de e-mail em formatos como MSG, EML e MHTML diretamente no visualizador.
Ver anexos - Renderize e exiba automaticamente anexos de e-mail para facilitar o acesso.

Renderizando mensagens do banco de dados do Lotus Notes

Renderizar mensagens do banco de dados NSF - Converta e visualize mensagens do banco de dados Lotus Notes (NSF) em formatos suportados.
Acesse elementos incorporados - Renderize e visualize imagens, arquivos e links incorporados nas mensagens do banco de dados do Lotus Notes.

Renderizando documentos do MS Project

Renderizar arquivos do MS Project (MPP) - Converta arquivos do MS Project (MPP) em HTML, imagens ou PDF para facilitar a visualização.
Visualizar dados do projeto - Renderize visualizações de tarefas, recursos e gráficos de Gantt a partir de arquivos do MS Project.

Renderizando arquivos de dados do Outlook

Renderizar arquivos PST e OST - Converta arquivos de dados PST e OST do Outlook em formatos HTML, imagens ou PDF para visualização.
Ver e-mails, calendários e contatos - Renderize mensagens de e-mail individuais, eventos de calendário e detalhes de contato a partir de arquivos de dados do Outlook.

Renderizando documentos PDF

Converta PDF em HTML, imagem ou outros formatos - Renderize documentos PDF em HTML, imagem ou outros formatos suportados para visualização baseada na Web ou em aplicativos.
PDF Anotações e Marcadores – Suporte para renderização de documentos PDF com anotações, marcadores e outros elementos incorporados.

Renderizando planilhas

Renderizar arquivos Excel (XLS, XLSX) - Converta arquivos de planilha como XLS e XLSX em formatos HTML, imagens ou PDF.
Visualizar gráficos e fórmulas - Renderize gráficos de planilhas, fórmulas e formatos de células complexos para visualização precisa.

Renderizando arquivos de texto

Renderizar arquivos de texto simples e CSV - Converta arquivos de texto simples e CSV em HTML, imagens ou PDF para visualização simplificada.
Preservar formatação de texto – Mantenha o layout e a formatação do texto original durante a renderização.

Renderizando documentos do Visio

Renderizar arquivos Visio (VSD, VSDX) - Converta e exiba arquivos de diagramas Visio nos formatos HTML, imagem ou PDF.
Visualizar diagramas e fluxogramas - Renderize diagramas, fluxogramas e formas a partir de arquivos do Visio para uma apresentação clara.

Renderizando documentos de processamento de texto

Renderizar arquivos do Word (DOC, DOCX, ODT) - Converta arquivos de processamento de texto como DOC, DOCX e ODT para formatos HTML, imagem ou PDF.
Preservar a estrutura do documento – Garanta uma renderização precisa da estrutura do documento, incluindo cabeçalhos, rodapés e formatação.

Trabalhando com páginas de documentos

Extrair páginas de documentos - Extraia páginas específicas de documentos para renderização individual.
Personalizar visualização de páginas - Controle as configurações de paginação e exibição de páginas para visualização de documentos.

Renderizando páginas de documentos

Renderizar páginas em HTML, imagem ou PDF - Converta páginas de documentos individuais nos formatos HTML, imagem ou PDF para visualização.
Stream Page Output - Transmita páginas de documentos individuais para tempos de carregamento mais rápidos e visualização em tempo real.

Minificação de HTML e SVG

Minimize o conteúdo HTML – Reduza o tamanho do conteúdo HTML renderizado para carregamentos de página mais rápidos.
Otimizar a saída SVG – Minimize e otimize a saída SVG para melhorar o desempenho sem perder qualidade.

Renderizando documento para HTML responsivo

Converter para HTML responsivo - Renderize documentos como HTML responsivo que se adapta a vários tamanhos de tela e dispositivos.
Visualização otimizada para dispositivos móveis - Garanta que os documentos sejam otimizados para dispositivos móveis e tablets usando renderização HTML responsiva.

Trabalhando com anexos

Extrair e renderizar anexos - Extraia e renderize anexos de documentos ou mensagens de e-mail para facilitar a visualização.
Ver tipos de anexos - Suporte para visualizar vários tipos de anexos, como imagens, documentos e arquivos.

Licenciamento e Autenticação

Modo de avaliação - Renderize documentos com marcas d’água durante o teste.
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.Viewer Cloud suporta mais de 190 formatos de arquivo nas seguintes categorias:

• Processamento de texto: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT, ODT, OTT
• Planilhas: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Apresentações: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF e layout de página: PDF, XPS, TEX
• Imagens: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF e muito mais
• CAD e Diagramas: DWG, DXF, DWF, DGN, IFC, STL; VSD, VSDX, VSS, VST e formatos Visio relacionados
• E-mail e Outlook: MSG, EML, EMLX, MHT, PST, OST
• Web: HTML, HTM, MHT, MHTML
• Arquivos: ZIP, RAR, TAR e outros formatos de arquivo
• Gerenciamento de Projetos: MPP, MPT
• e-books: EPUB, MOBI
• Notas: UM (Microsoft OneNote)
• Lotus Notes: mensagens do banco de dados NSF Todos os formatos suportados podem ser renderizados como HTML, PNG/JPG ou PDF. Para a matriz de formato completa, consulte documentation.

Início rápido

Obtenha suas credenciais API

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

import groupdocs_viewer_cloud

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

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

# Create instance of the View API
view_api = groupdocs_viewer_cloud.ViewApi.from_config(configuration)

Renderizar um documento para HTML

Depois de inicializado, use este exemplo básico para renderizar um documento do armazenamento em nuvem:

import groupdocs_viewer_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

view_api = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Document rendered: " + str(len(response.pages)) + " pages")

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

Obtenha formatos de arquivo suportados

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

import groupdocs_viewer_cloud

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

try:
    response = info_api.get_supported_file_formats()

    print("Supported file-formats:")
    for fmt in response.formats:
        print("{0} ({1})".format(fmt.file_format, fmt.extension))
except groupdocs_viewer_cloud.ApiException as e:
    print("Exception when calling get_supported_file_formats: {0}".format(e.message))

Renderizar um documento como PDF

Este exemplo demonstra como renderizar um documento do Word no formato PDF usando GroupDocs.Viewer Cloud API.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "PDF"
view_options.render_options = groupdocs_viewer_cloud.PdfOptions()

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Document rendered to PDF: " + response.file.path)

Renderizar planilha como HTML

Este exemplo de código converte uma planilha do Excel em HTML usando GroupDocs.Viewer Cloud API.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.xlsx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Spreadsheet rendered to HTML: " + str(len(response.pages)) + " pages")

Renderizar documento com layout HTML responsivo

Renderize um documento como HTML responsivo que se adapta a vários tamanhos de tela e dispositivos.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.is_responsive = True

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Responsive HTML rendered: " + str(len(response.pages)) + " pages")

Renderizar páginas selecionadas

Converta apenas páginas específicas de um documento, economizando tempo de processamento quando apenas parte do documento for necessária.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.pages_to_render = [2, 3]

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Selected pages rendered: " + str(len(response.pages)) + " pages")

Renderizar documento do Word com alterações rastreadas

Renderize um documento do Word incluindo alterações controladas na saída HTML.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/with_tracked_changes.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.word_processing_options = groupdocs_viewer_cloud.WordProcessingOptions()
view_options.render_options.word_processing_options.render_tracked_changes = True

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Tracked changes rendered: " + str(len(response.pages)) + " pages")

Obtenha informações do documento

Recuperar metadados de documentos, como contagem de páginas, antes da renderização.

import groupdocs_viewer_cloud

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

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"

request = groupdocs_viewer_cloud.GetInfoRequest(view_options)
result = info_api.get_info(request)

print("Document pages: " + str(len(result.pages)))

Converta e baixe sem armazenamento Cloud

Renderize um documento local diretamente e receba o arquivo de saída sem primeiro fazer upload para o armazenamento em nuvem.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

with open("sample.docx", "rb") as file:
    request = groupdocs_viewer_cloud.ConvertAndDownloadRequest("jpg", file)
    output_path = view_api.convert_and_download(request)

print("Convert and download completed: " + output_path)

Exemplos de projetos em GitHub

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

Como executar os exemplos

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

Tags

Document Rendering API | Python Cloud API | GroupDocs.Viewer Cloud | REST API | HTML Rendering | PDF Conversion | Image Rendering | Document Viewing | Multi-Page Rendering | Document Streaming | CAD Rendering | E-Mail Message Rendering | Visio Rendering | MS Project Rendering | Outlook Data Rendering | Spreadsheet Rendering | Word Processing Rendering | Custom View Options | Responsive HTML | Attachment Rendering | Secure API Access | Cloud Storage Integration