Instalación

El paquete es available en PyPI y se puede instalar a través de pip ejecutando el siguiente comando:

pip install groupdocs-viewer-cloud

Requisitos

• Python 2.7 o 3.4+
• administrador de paquetes pip
• Credenciales de nube de GroupDocs — Client ID and Client Secret desde el tablero

Dependencias

El SDK instala automáticamente los siguientes paquetes:

API REST de Python Cloud para representación de documentos

GroupDocs.Viewer Cloud SDK para Python ofrece una poderosa solución de representación de documentos que admite más de 190 formatos como Word, Excel, PDF, CAD, correos electrónicos y más. Los desarrolladores pueden convertir y renderizar fácilmente documentos a formatos HTML, PDF e imagen, preservando la estructura y el diseño del documento original. Con funciones avanzadas como salida en streaming, opciones de visualización personalizadas, renderizado de varias páginas y compatibilidad con varios tipos de archivos, GroupDocs.Viewer Cloud API proporciona una integración perfecta para las necesidades de visualización de documentos en cualquier aplicación web, script o flujo de trabajo de automatización de Python. Regístrese gratis para comenzar a aprovechar la flexibilidad y las capacidades de esta sólida API basada en la nube.

Uso básico

Configuración simple del visor: guía para configurar rápidamente GroupDocs.Viewer con una configuración mínima.
Cargar documento desde la nube: instrucciones sobre cómo cargar documentos directamente desde el almacenamiento en la nube para verlos.
Opciones de vista personalizada: pasos para personalizar la configuración del visor, como el zoom, el diseño y la navegación.
Formatos de archivos admitidos: lista detallada de formatos de archivos admitidos que se pueden ver sin conversión.

Visor HTML

Convertir documentos a HTML: proceso de conversión de documentos a formato HTML para una visualización fluida basada en el navegador.
Transmitir salida HTML: guía sobre la transmisión de contenido HTML para la representación de documentos en tiempo real.
Conservar la estructura del documento en HTML: instrucciones para mantener el diseño y la estructura originales al convertir a HTML.
Opciones de visualización de HTML personalizadas: funciones para personalizar la apariencia de los documentos visualizados en HTML, incluidos estilos y fuentes.

Visor de imágenes

Convertir documentos en imágenes: pasos para convertir documentos a formatos de imagen como PNG y JPEG para su visualización.
Transmitir salida de imagen: guía para transmitir formatos de imágenes desde el visor de documentos.
Personalizar resolución de imagen: opciones para configurar una resolución de imagen específica al visualizar documentos como imágenes.
Representación de imágenes de documentos de varias páginas: instrucciones para representar documentos de varias páginas como imágenes separadas.

Visor de PDF

Convertir documentos a PDF: convierta cualquier formato de documento compatible a un PDF para verlo.
Transmitir salida de PDF: guía para transmitir contenido PDF para una visualización optimizada en navegadores o aplicaciones.
Insertar visor de PDF: instrucciones para incorporar un visor de PDF personalizable en su aplicación.
Compatibilidad con visor de PDF: funciones para ver e interactuar con documentos PDF.

Renderizar documento

Renderizar documento a HTML, imagen o PDF: opciones para renderizar documentos en formatos HTML, imagen o PDF para su visualización.
Transmitir salida renderizada: transmita la salida del documento renderizado para acceder en tiempo real a su aplicación.
Representación de documentos de varias páginas: compatibilidad con la representación de documentos de varias páginas en varios archivos HTML, de imagen o PDF.

Opciones de renderizado por tipo de documento

Representación especializada para tipos de archivos: opciones de representación personalizadas diseñadas para varios tipos de documentos como Word, Excel, PDF y más.
Conservar características del documento: asegúrese de que las características del documento original, como el diseño, el texto y el formato, se conserven durante la renderización.

Representación de archivos comprimidos

Renderizar archivos ZIP, RAR y TAR: convierta formatos de archivos como ZIP, RAR y TAR en contenido visible.
Extraer y renderizar archivos específicos: extraiga archivos específicos de archivos y renderícelos sin descargar el archivo completo.

Representación de dibujos CAD

Renderizar formatos CAD (DWG, DXF, etc.) - Convierta y muestre archivos CAD como DWG y DXF para una visualización detallada.
Personalice las opciones de renderizado CAD: establezca parámetros específicos para el renderizado CAD, como el nivel de zoom, la visibilidad de la capa y el diseño.

Representación de mensajes de correo electrónico

Renderizar formatos MSG, EML y MHTML: vea mensajes de correo electrónico en formatos como MSG, EML y MHTML directamente en el visor.
Ver archivos adjuntos: renderiza y muestra automáticamente archivos adjuntos de correo electrónico para facilitar el acceso.

Representación de mensajes de la base de datos de Lotus Notes

Renderizar mensajes de bases de datos NSF: convierta y vea mensajes de bases de datos de Lotus Notes (NSF) en formatos compatibles.
Acceda a elementos incrustados: renderice y vea imágenes, archivos y enlaces incrustados dentro de los mensajes de la base de datos de Lotus Notes.

Representación de documentos de MS Project

Renderizar archivos de MS Project (MPP): convierta archivos de MS Project (MPP) a HTML, imágenes o PDF para verlos fácilmente.
Ver datos del proyecto: renderice vistas de tareas, recursos y diagramas de Gantt desde archivos de MS Project.

Representación de archivos de datos de Outlook

Renderizar archivos PST y OST: convierta archivos de datos PST y OST de Outlook a formatos HTML, imágenes o PDF para verlos.
Ver correos electrónicos, calendarios y contactos: renderice mensajes de correo electrónico individuales, eventos de calendario y detalles de contacto a partir de archivos de datos de Outlook.

Representación de documentos PDF

Convierta PDF a HTML, imágenes u otros formatos: renderice documentos PDF a HTML, imágenes u otros formatos compatibles para visualización basada en web o en aplicaciones.
Anotaciones y marcadores de PDF: compatibilidad con la representación de documentos PDF con anotaciones, marcadores y otros elementos incrustados.

Representación de hojas de cálculo

Renderizar archivos de Excel (XLS, XLSX): convierta archivos de hojas de cálculo como XLS y XLSX a formatos HTML, imágenes o PDF.
Ver gráficos y fórmulas: renderice gráficos de hojas de cálculo, fórmulas y formatos de celdas complejos para una visualización precisa.

Representación de archivos de texto

Renderizar archivos de texto sin formato y CSV: convierta archivos de texto sin formato y CSV a HTML, imágenes o PDF para una visualización simplificada.
Conservar formato de texto: mantenga el diseño y el formato del texto original durante la renderización.

Representación de documentos de Visio

Renderizar archivos de Visio (VSD, VSDX): convierta y muestre archivos de diagramas de Visio en formatos HTML, imagen o PDF.
Ver diagramas y diagramas de flujo: renderice diagramas, diagramas de flujo y formas a partir de archivos Visio para una presentación clara.

Representación de documentos de procesamiento de textos

Renderizar archivos de Word (DOC, DOCX, ODT): convierta archivos de procesamiento de Word como DOC, DOCX y ODT a formatos HTML, de imagen o PDF.
Conservar la estructura del documento: garantice una representación precisa de la estructura del documento, incluidos encabezados, pies de página y formato.

Trabajar con páginas de documentos

Extraer páginas de documentos: extraiga páginas específicas de documentos para su representación individual.
Personalizar la visualización de páginas: controle la paginación y la configuración de visualización de páginas para la visualización de documentos.

Representación de páginas de documentos

Renderizar páginas a HTML, imagen o PDF: convierta páginas de documentos individuales a formatos HTML, imagen o PDF para su visualización.
Transmitir salida de página: transmita páginas de documentos individuales para tiempos de carga más rápidos y visualización en tiempo real.

Minificación de HTML y SVG

Minimizar contenido HTML: reduzca el tamaño del contenido HTML renderizado para cargar la página más rápido.
Optimizar la salida SVG: minimice y optimice la salida SVG para mejorar el rendimiento sin perder calidad.

Representación de documento en HTML responsivo

Convertir a HTML adaptable: renderice documentos como HTML adaptable que se adapta a varios tamaños de pantalla y dispositivos.
Visualización compatible con dispositivos móviles: asegúrese de que los documentos estén optimizados para dispositivos móviles y tabletas utilizando una representación HTML responsiva.

Trabajar con archivos adjuntos

Extraer y renderizar archivos adjuntos: extraiga y renderice archivos adjuntos de documentos o mensajes de correo electrónico para verlos fácilmente.
Ver tipos de archivos adjuntos: admite la visualización de varios tipos de archivos adjuntos, como imágenes, documentos y archivos.

Licencias y autenticación

Modo de evaluación: renderice documentos con marcas de agua durante la prueba.
Autenticación segura: utilice el ID de cliente y el secreto de cliente para obtener acceso seguro a la API.
Licencia MIT: el SDK para Python tiene la licencia de MIT License.

Formatos de documentos admitidos

GroupDocs.Viewer Cloud admite más de 190 formatos de archivo en las siguientes categorías:

• Procesamiento de textos: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT, ODT, OTT
• Hojas de cálculo: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Presentaciones: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF y diseño de página: PDF, XPS, TEX
• Imágenes: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF y más
• CAD y Diagramas: DWG, DXF, DWF, DGN, IFC, STL; VSD, VSDX, VSS, VST y formatos de Visio relacionados
• Correo electrónico y Outlook: MSG, EML, EMLX, MHT, PST, OST
• Web: HTML, HTM, MHT, MHTML
• Archivos: ZIP, RAR, TAR y otros formatos de archivo
• Gestión de Proyectos: MPP, MPT
• libros electrónicos: EPUB, MOBI
• Notas: UNO (Microsoft OneNote)
• Lotus Notes: Mensajes de base de datos NSF

Todos los formatos admitidos se pueden representar como HTML, PNG/JPG o PDF. Para obtener la matriz de formato completa, consulte la documentation.

Inicio rápido

Obtenga sus credenciales API

Para utilizar GroupDocs.Viewer Cloud, regístrese en GroupDocs.Cloud Dashboard y obtenga su ID de cliente y su Secreto de cliente.

Inicializar la API

Utilice el siguiente código para comenzar a utilizar 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)

Representar un documento a HTML

Una vez inicializado, utilice este ejemplo básico para representar un documento desde el almacenamiento en la nube:

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")

Con esta guía de inicio rápido, estará listo para comenzar a renderizar documentos usando GroupDocs.Viewer Cloud en sus aplicaciones Python. Para más detalles, visite el documentation.

Obtenga formatos de archivo compatibles

Recupere la lista completa de formatos de archivo compatibles disponibles a través de 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 un documento como PDF

Este ejemplo demuestra cómo renderizar un documento de Word a 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)

Representar hoja de cálculo como HTML

Este ejemplo de código convierte una hoja de cálculo de Excel a HTML utilizando 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")

Representar documento con diseño HTML responsivo

Represente un documento como HTML responsivo que se adapta a varios tamaños de pantalla y 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 seleccionadas

Convierta solo páginas específicas de un documento, ahorrando tiempo de procesamiento cuando solo se necesita una parte del documento.

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 de Word con seguimiento de cambios

Represente un documento de Word que incluya el seguimiento de los cambios en el HTML de salida.

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")

Obtener información del documento

Recupere metadatos del documento, como el recuento de páginas, antes de renderizarlo.

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)))

Convertir y descargar sin almacenamiento en la nube

Procese un documento local directamente y reciba el archivo de salida sin cargarlo primero en el almacenamiento en la nube.

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)

Proyectos de muestra en GitHub

El GroupDocs.Viewer Cloud Python Samples El repositorio incluye ejemplos listos para ejecutar que cubren:

Cómo ejecutar los ejemplos

1. Clona o descarga el samples repository2. Ir alExamplesdirectorio
2. EditarRunExamples.pyy configura tuclient_idyclient_secret4. correrpip install groupdocs-viewer-cloud -U5. Ejecutarpython RunExamples.py

Para más detalles, visite Getting Started.

Etiquetas

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