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.
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.
Установка
Пакет доступен в PyPI, и его можно установить через pip, выполнив следующую команду:
pip install groupdocs-comparison-cloud
Требования
Зависимости
SDK автоматически устанавливает следующие пакеты:
| Пакет | Ограничение |
|---|
| urllib3 | >= 1.15 |
| six | >= 1.10 |
| certifi | — |
| python-dateutil | — |
Быстрый старт
Получите учетные данные API
Чтобы использовать GroupDocs.Comparison Cloud, зарегистрируйтесь на GroupDocs.Cloud Dashboard и получите свой Идентификатор клиента и Секрет клиента.
Инициализируйте API
Используйте следующий код, чтобы начать использовать Cloud SDK GroupDocs.Comparison для 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)
Сравните два документа
После инициализации используйте этот базовый пример для сравнения документов Word и сохранения результата:
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)
Благодаря этому краткому руководству вы можете начать сравнивать документы с помощью GroupDocs.Comparison Cloud в своих приложениях Python. Для получения более подробной информации посетите документацию.
Получить поддерживаемые форматы файлов
Получите полный список поддерживаемых форматов файлов, доступных через API сравнения.
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)))
Сравнить PDF-документы
Сравните два PDF-документа и сохраните результат с выделенными отслеживаемыми изменениями.
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)
Сравнение документов, защищенных паролем
Сравните два документа Word, защищенных паролем, указав учетные данные для каждого файла.
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)
Получить список изменений
Получите подробный список всех изменений, обнаруженных между исходным и целевым документами.
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)))
Принять или отклонить изменения
Примите или отклоните отдельные изменения после сравнения документов и сохраните обновленный результат.
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)
Сравните несколько документов с параметрами
Сравните исходный документ с несколькими целевыми и настройте внешний вид вставленных элементов.
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)
Применить изменения в документах DOCX
Принимайте или отклоняйте отслеживаемые изменения в документе Word программным способом.
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)
Примеры проектов на GitHub
Репозиторий GroupDocs.Comparison Cloud Python Samples включает готовые к использованию примеры, охватывающие:
| Категория | Примеры |
|---|
| BasicUsage | Supported formats, document information, compare documents, compare PDF documents, preview document |
| AdvancedUsage — CompareMultipleDocuments | Compare multiple documents with options, compare multiple protected documents |
| AdvancedUsage — Revisions | Get list of revisions, apply revisions, accept all revisions, reject all revisions |
| AdvancedUsage — SaveOptions | Set metadata, set password on save |
| AdvancedUsage — Change Control | Accept or reject changes, compare protected documents, compare sensitivity, customize change styles, get changes coordinates, get list of changes |
Как запустить примеры
- Клонируйте или загрузите репозиторий образцов.
- Отредактируйте «Examples/RunExamples.py» и установите «client_id» и «client_secret».
- Перейдите в каталог «Примеры».
- Запустите
pip install groupdocs-comparison-cloud -U - Выполните
python RunExamples.py
Для получения более подробной информации посетите Начало работы.
Теги
Document Comparison API | Python Cloud API | GroupDocs.Comparison Cloud | REST API | Сравнение документов | Сравнение папок | Контроль версий | Отслеживать изменения | Предварительный просмотр | Поддержка нескольких форматов | Документы, защищенные паролем | Сравнение исходного кода | Отслеживание изменений | Кастомизация | Объединение документов | Изменить координаты | Извлечение метаданных | Безопасность документа | Просмотр документа | Безопасный доступ к API | Интеграция облачного хранилища | Кроссплатформенный API