Instalación

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

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

Comparación y revisión de documentos API REST de Python Cloud

GroupDocs.Comparison Cloud SDK para Python es una potente API REST en la nube diseñada para que los desarrolladores integren la funcionalidad de comparación de documentos en aplicaciones web, scripts y flujos de trabajo de automatización de Python. Esta API, que admite más de 90 formatos de archivo, le permite comparar carpetas enteras, aceptar o rechazar revisiones de documentos y visualizar cambios con vistas previas de páginas. Con funciones como control de cambios granular, personalización de estilos y compatibilidad con múltiples documentos, los desarrolladores pueden automatizar de manera eficiente las comparaciones masivas de archivos. Las características adicionales incluyen comparación de documentos protegidos por contraseña, fusión de archivos de código fuente y extracción de coordenadas de cambio detalladas. Esta herramienta es ideal para entornos colaborativos, revisión de documentos legales y sistemas de control de versiones.

Comparación de carpetas y documentos

Comparar carpetas completas: compare el contenido de directorios completos con detección automática de diferencias.
Filtrar elementos modificados: guarde los resultados en formatos TXT o HTML y muestre solo los elementos modificados.
Comparación de archivos masivos: automatice las comparaciones de archivos masivos de manera eficiente dentro de las aplicaciones Python.

Control de revisión de documentos

Aceptar o rechazar revisiones en DOCX: acepte o rechace mediante programación revisiones en archivos DOCX de Word.
Extraer lista de revisiones: recupere todas las revisiones, aplique los cambios deseados y rechace otras.
Gestión de versiones: habilite un control total sobre la edición de documentos y la gestión de versiones.

Generación de vista previa de página de documento

Generar vistas previas de páginas: cree imágenes de vista previa de alta calidad antes de guardar los resultados de la comparación.
Formatos de vista previa personalizados: especifique formatos (PNG, JPG, BMP) y seleccione dimensiones personalizadas.
Flujos de trabajo de revisión visual: integre vistas previas de documentos en aplicaciones que requieren gestión de contenido visual.

Gestión y revisión de cambios

Aceptar o rechazar los cambios detectados - Controle los cambios en los documentos con precisión granular.
Mostrar revisiones y realizar un seguimiento de los cambios: resalte las diferencias utilizando el seguimiento de cambios al estilo de Word.
Establecer autor de cambios: asigne autoría a los cambios detectados para mejorar la responsabilidad.

Personalización y flexibilidad

Personalizar estilos de cambio - Controle fuentes, colores y estilos de texto (negrita, cursiva, tachado).
Ajustar la sensibilidad de comparación - Equilibra la velocidad y la precisión con ajustes de sensibilidad de 0 a 100.

Soporte para múltiples documentos

Compare varios documentos: compare más de dos documentos simultáneamente.
Documentos protegidos con contraseña: compare archivos de origen y de destino protegidos con contraseña.
Fusionar archivos de código fuente: compare y combine múltiples versiones de archivos de código fuente con control de cambios.

Análisis de cambios detallado

Obtener coordenadas de cambios: recupere la ubicación exacta de los cambios dentro de los documentos.
Obtener lista de cambios: reciba una lista detallada que incluya el tipo de cambio, el número de página y el texto afectado.
Extraer texto de origen y destino: extrae el texto original y modificado para cada cambio detectado.

Control de guardado y metadatos

Establecer metadatos del documento al guardar: controle el autor, el título o la organización en los documentos de salida.
Establecer contraseña para el documento de salida: aplique protección con contraseña a los documentos resultantes.

Licencias y autenticación

Modo de evaluación: prueba la API con una cuenta de prueba gratuita.
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.Comparison Cloud admite 90+ formatos de archivo con capacidades de comparación y detección automática:

• Procesamiento de textos: DOC, DOCM, DOCX, DOT, DOTM, DOTX, ODT, OTT, RTF
• Hojas de cálculo: XLS, XLT, XLSX, XLTM, XLSB, XLSM, ODS, CSV
• Presentaciones: POT, POTX, PPS, PPSX, PPTX, PPT, ODP, OTP
• Diagramas: VSDX, VSD, VSS, VST, VDX
• Notas: UNO (Microsoft OneNote)
• PDF y diseño de página: PDF, MOBI, DJVU
• Imágenes: BMP, GIF, JPG/JPEG, PNG, DCM, DWG, DXF
• Correo electrónico: EML, EMLX, MSG
• Web: HTML, MHT, MHTML
• Código fuente: CS, JAVA, CPP, JS, PY, RB

Las operaciones admitidas varían según el formato. Para obtener la matriz de formato completa, consulte la documentation.

Inicio rápido

Obtenga sus credenciales API

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

import groupdocs_comparison_cloud

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

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

# Create instance of the Compare API
compare_api = groupdocs_comparison_cloud.CompareApi.from_config(configuration)

Comparar dos documentos

Una vez inicializado, utilice este ejemplo básico para comparar documentos de Word y guardar el resultado:

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

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

Obtenga formatos de archivo compatibles

Obtenga la lista completa de formatos de archivo compatibles disponibles a través de la API de comparación.

import groupdocs_comparison_cloud

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

result = info_api.get_supported_file_formats()

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

Comparar documentos PDF

Compare dos documentos PDF y guarde el resultado con los cambios registrados resaltados.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/pdf/source.pdf"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/pdf/target.pdf"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.pdf"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Comparar documentos protegidos con contraseña

Compare dos documentos de Word protegidos con contraseña proporcionando credenciales para cada archivo.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_protected.docx"
source.password = "1231"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target_protected.docx"
target.password = "5784"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Obtener lista de cambios

Recupere una lista detallada de todos los cambios detectados entre los documentos de origen y de destino.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

print("Changes count: " + str(len(changes)))

Aceptar o rechazar cambios

Acepte o rechace cambios individuales después de comparar documentos y guarde el resultado actualizado.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.UpdatesOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

for change in changes:
    change.comparison_action = "Reject"
changes [0].comparison_action = "Accept"

options.changes = changes

response = compare_api.put_changes_document(groupdocs_comparison_cloud.PutChangesDocumentRequest(options))

print("Output file link: " + response.href)

Comparar varios documentos con opciones

Compare un documento de origen con varios destinos y personalice la apariencia de los elementos insertados.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
target1 = groupdocs_comparison_cloud.FileInfo()
target1.file_path = "target_files/word/target_1.docx"
target2 = groupdocs_comparison_cloud.FileInfo()
target2.file_path = "target_files/word/target_2.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target, target1, target2]
options.output_path = "output/result.docx"
settings = groupdocs_comparison_cloud.Settings()
settings.inserted_items_style = groupdocs_comparison_cloud.ItemsStyle()
settings.inserted_items_style.font_color = "16711680"
options.settings = settings

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Aplicar revisiones en documentos DOCX

Acepte o rechace revisiones rastreadas en un documento de Word mediante programación.

import groupdocs_comparison_cloud

review_api = groupdocs_comparison_cloud.ReviewApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_with_revs.docx"
options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

revisions = review_api.get_revisions(groupdocs_comparison_cloud.GetRevisionsRequest(source))

for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

response = review_api.apply_revisions(groupdocs_comparison_cloud.ApplyRevisionsRequest(options))

print("Output file link: " + response.href)

Proyectos de muestra en GitHub

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

Cómo ejecutar los ejemplos

1. Clona o descarga el samples repository2. EditarExamples/RunExamples.pyy configura tuclient_idyclient_secret3. Ve alExamplesdirectorio
2. correrpip install groupdocs-comparison-cloud -U5. Ejecutarpython RunExamples.py

Para más detalles, visite Getting Started.

Etiquetas

Document Comparison API | Python Cloud API | GroupDocs.Comparison Cloud | REST API | Document Comparison | Folder Comparison | Revision Control | Track Changes | Preview Generation | Multi-format Support | Password Protected Documents | Source Code Comparison | Change Tracking | Customization | Document Merging | Change Coordinates | Metadata Extraction | Document Security | Document Review | Secure API Access | Cloud Storage Integration | Cross-platform API